Instagram Integration — Overview
Whoxa CRM connects to a professional Instagram account via Instagram Business Login (direct, not through a Facebook Page/Business Manager step). Once connected, you can auto-reply to DMs, run keyword-triggered automations on post/reel comments and story replies, and manage all of it from the Integrations sidebar.
What You Need
| Requirement | Details |
|---|---|
| Instagram Professional account | Business or Creator account — personal accounts can't use the API |
| Meta Developer App | With Instagram Business Login product added |
App credentials in your .env | INSTAGRAM_APP_ID, INSTAGRAM_APP_SECRET, INSTAGRAM_OAUTH_REDIRECT_URI, INSTAGRAM_WEBHOOK_VERIFY_TOKEN |
Note: Instagram Connect is fully independent from Facebook Connect in Whoxa CRM — they use separate Meta App credentials and separate OAuth flows. Connecting one does not connect the other.
Sidebar Pages
| Page | Purpose |
|---|---|
| Instagram Connect | Start/manage the OAuth connection, webhook config |
| Instagram Account | Read-only status view — profile, connected-since date, access-token expiry |
| Instagram Campaigns | Wraps a chat-start automation for a specific IG account under a named "campaign" |
| Posts Automation / Reels Automation / Stories Automation | Keyword-triggered auto-replies on comments and story replies |
Setup Order
- Connect Instagram — authorize your account.
- Check Instagram Account status — confirm token is valid.
- Set up Content Automation (comments/story auto-reply) and/or Instagram Campaigns (DM auto-reply on new chats).
Manual webhook step: unlike WhatsApp and Facebook, Whoxa CRM does not auto-subscribe your account to the webhook after Instagram OAuth completes. You must paste the Webhook URL and Verification Token into your Meta App's dashboard yourself — see Connect Instagram.