Instagram Engine

WaDesk can drive Instagram in two ways, and you pick one. Both are managed from Admin → Extensions (/admin/extensions).

  • Native add-on — the Instagram module installed in place (addon/instagram/). Everything runs inside this WaDesk: inbox, flows, auto-replies, posts and comment moderation, on Meta's official Instagram Graph API. See Add-ons & Extensions to install it.
  • Remote InstaMagic / Instaflow — a separate Instagram product running as its own deployment, connected to WaDesk by URL + a shared secret. No code is uploaded; the two apps just talk.
One engine at a time. Instagram will only run through one of these at once — the two can't both own the same Instagram webhook and UI. WaDesk enforces this for you:
  • If the native add-on is active, connecting a remote InstaMagic is refused — deactivate (Remove) the native add-on first.
  • If a remote InstaMagic is connected, installing the native Instagram add-on is refused — disconnect the remote first.
A deactivated native add-on no longer counts as active, so you can switch to remote without deleting its files.

Option A — Native add-on

Install the Instagram add-on from Admin → Extensions (upload its ZIP, or it may already be present as an in-place module). Once active it appears under Installed add-ons with an Active badge. To switch away from it, click Remove on its card — that deactivates it (files are kept) so you can either re-activate later or connect a remote product instead. Full steps: Deactivate or remove an add-on.

Option B — Connect a remote InstaMagic / Instaflow

  1. Make sure the native Instagram add-on is not active (deactivate it if it is).
  2. On Admin → Extensions, open the connect form and enter:
    • Deployment URL — the base URL of your InstaMagic / Instaflow install.
    • Shared secret — the handshake secret both sides agree on (stored encrypted; leave blank to keep the existing one).
    • Display name — the product name shown across the app (e.g. InstaMagic).
  3. Save. WaDesk runs a handshake against the remote deployment; on success the card shows Connected. If the secret is rejected or the URL can't be reached, you'll get a clear reason and nothing is marked connected.

To stop using it, click Disconnect — this wipes the stored URL + secret and flips the connection off, so WaDesk stops treating Instagram as connected. You're then free to install the native add-on instead.