Skip to main content

​
Instagram

Coming soon in the hosted app. The Instagram card in Settings → Integrations shows Soon while ChatterMate finishes Meta app review for the Cloud offering. Self-hosters can connect now with their own Meta app and linked Page token.
Connect a professional Instagram account and your AI agent answers Instagram direct messages. Instagram DMs run on the same Meta app and webhook as Messenger, so setup is nearly identical — the account just has to be a Business or Creator account linked to a Facebook Page.

​
Prerequisites

  • An Instagram Business or Creator account (not personal).
  • The Instagram account linked to a Facebook Page (Instagram → Settings → linked accounts, or from the Page’s settings).

​
Step 1 — Set up a Meta app

If you already created a Meta app for WhatsApp or Messenger, skip to step 2.
1

Create a Business app

Go to developers.facebook.com → My Apps → Create App → Business.
2

Business Verification

Complete Business Verification in business.facebook.com → Security Center. Start it first — it gates production access.
3

Add Instagram + Messenger

Add the Instagram product and link your professional account (Instagram messaging is configured through the Messenger/Instagram settings).
4

Set the webhook

Set the callback URL to https://<your-domain>/api/v1/webhooks/meta with your META_WEBHOOK_VERIFY_TOKEN, and subscribe to Instagram messages.

​
Step 2 — Copy your credentials

CredentialWhere to find it
Instagram account IDThe IG account’s numeric ID (e.g. 17841400000000000), from the Graph API or the linked-account settings.
Linked Page access tokenThe access token for the Facebook Page the Instagram account is linked to (System User token for a permanent one).

​
Step 3 — App Review (to message real customers)

Submit App Review for:
  • instagram_basic
  • instagram_manage_messages
  • (plus pages_show_list, business_management)
Include a narrated screencast showing a customer DMing your Instagram account and ChatterMate replying.

​
Step 4 — Connect in ChatterMate

1

Open the Instagram card

Go to Settings → Integrations and click Connect on the Instagram card (self-hosted / once available).
2

Enter your credentials

Paste the Instagram account ID and the linked Page access token. ChatterMate encrypts them and verifies inbound webhook signatures.
3

Assign an AI agent

Choose the AI agent that answers Instagram and click Assign agent.
If the account isn’t a professional account linked to a Page, connecting fails — ChatterMate surfaces the reason so you can fix the link and retry.

​
Test it

DM your Instagram account. The AI agent replies, and the conversation appears in Conversations with an Instagram badge and human handover.