Skip to main content

Connect Instagram

Where to Find It​

Sidebar → Instagram → Instagram Connect (route /integrations/connect-instagram).

Connect Flow​

  1. Click Connect. Whoxa CRM redirects your whole browser tab (not a popup) to Instagram's own authorization page: instagram.com/oauth/authorize, requesting scopes instagram_business_basic, instagram_business_manage_messages, instagram_business_manage_comments.
  1. Log in with the Instagram account (Business or Creator) you want to connect, and approve the permissions.
  1. Instagram redirects back to Whoxa CRM's backend, which exchanges the code for a long-lived (~60 day) access token, fetches your username and profile picture, and saves the account.
  2. You land back on the Connect page with a success toast, and the page now shows your Instagram Account ID, Username, an Active badge, plus Refresh Status and Disconnect buttons.

Configure the Webhook (Manual Step)​

Connecting your account does not automatically subscribe it to Whoxa CRM's webhook — you must register it yourself in Meta's dashboard:

  1. On the Connect page, copy the Webhook URL and Verification Token shown in the Webhook Configuration section.
  2. Go to your Meta App's dashboard → Instagram → Configuration → Webhooks.
  3. Paste the Webhook URL and Verification Token, click Verify and Save.
  4. Subscribe to the messages and comments webhook fields — messages drives DM auto-reply and campaigns, comments drives Posts/Reels Automation.

The Verification Token is not auto-generated per account — it's the value your backend admin set for INSTAGRAM_WEBHOOK_VERIFY_TOKEN in the API server's .env file.

Disconnecting​

Click Disconnect. This deactivates the account (is_active: false) — it does not delete stored data. Reconnecting the same account reactivates it and refreshes the token.

Multiple Accounts​

You can connect more than one Instagram account by repeating the Connect flow with a different login. All connected accounts appear in the account picker on Campaigns, Posts/Reels/Stories Automation, and the Content Automation media pickers.