Multi-platform Integrations

Instagram Integration

Connect your Instagram Professional account to Chat Data, and your AI agent answers your Instagram direct messages. You can step in and reply yourself at any time.

Before you start

  • An Instagram Professional Account.
  • A Facebook Page connected to that account.
  • A list of every Facebook Page and Instagram account you already use with Chat Data, on any AI agent. You will tick all of them in the Facebook pop-up (see below).

Authorize every account at once, then pick one per agent

Chat Data uses one Meta app for all Instagram and Messenger connections. The Facebook pop-up sets which Pages and Instagram accounts Chat Data can reach for all your AI agents, not just this one. Leave an account unticked and Meta revokes Chat Data's access to it, so the agent using it stops replying.

After authorizing, the ACTIVE checkbox in each agent's panel decides which account that agent answers.

Tick every Page and Instagram account in one Facebook authorization, then use ACTIVE to give each AI agent its account. An account left unticked is revoked and its agent stops replying

Connect Instagram with Chat Data

  1. Open Agents, pick your AI agent and click Integrations.
  2. Select the Instagram integration card. Integrations page with the Add to Instagram card highlighted
  3. Click Connect in the pop-up window. Instagram Integration window with the reminder to select every Instagram account, and the Connect button
  4. Sign in with your Facebook account and click Continue. Sign in with Facebook Account
  5. Click Get started to connect your Instagram account, then sign in with your Instagram username and password. Connect with Instagram
  6. Choose the Facebook Page to connect the Instagram account to. Select Facebook Page
  7. Review the Facebook Page and Instagram account. Make sure Allow access to messages is checked, then click Next. Review Facebook Page and Instagram Account
  8. Continue to the step that asks you to choose your business account. Choose your business account
  9. Select every Facebook Page you use with Chat Data, including the ones on your other agents, and click Continue. Choose Facebook Page
  10. Select every Instagram account you use with Chat Data, and click Continue. Choose Instagram Account

Instagram account missing from the list?

The first time you link an Instagram account to its Facebook Page, Meta only adds it after your second Instagram sign-in. Close the pop-up and start again from step 3.

  1. Click Continue to review the permissions, then click Save. Instagram Integration complete
  2. The integration panel opens. Your AI agent now answers messages sent to the active Instagram account. Instagram Integration panel after connecting: the Connected Instagram Account table and a QR code to test

Choose which account this agent answers

The Connected Instagram Account table lists every account you granted in the pop-up. Tick ACTIVE for the account this agent should answer, and untick the others.

Connected Instagram Account table with the ACTIVE checkbox

To run several Instagram accounts on several agents, grant them all once, then give each agent its own account here. If one account is active on two agents, only one of them receives the conversations.

Test it: scan the QR code in the panel with your phone and message your Instagram account from a different Instagram account. The AI agent ignores messages an account sends to itself.

Renew access before it expires

Meta's access lasts about 90 days. The exact date is in the Access Expiration Date column of the table above (scroll the table to the right to see it), and Chat Data emails the workspace owner 3 days before it. There is no automatic renewal.

To renew, open the integration, click Renew Access and complete the Facebook pop-up again, ticking every Page and Instagram account. Renewing early is fine: the period starts again.

Meta access starts when you connect or renew, a reminder email arrives 3 days before the Access Expiration Date, and the integration stops at about day 90 unless you click Renew Access

Troubleshooting: The integration disconnects every day

You are affected if all of these are true:

  • The Instagram integration keeps dropping, often daily, and you have to reconnect it.
  • You did not change your Instagram or Facebook password, and access hasn't expired.
  • You have more than one Instagram or Messenger account connected to Chat Data, usually on different agents.
  • When one agent starts working again, another one quietly stops.

Meta returns this error:

Any of the pages_read_engagement, pages_manage_metadata, pages_read_user_content,
pages_manage_ads, pages_show_list or pages_messaging permission(s) must be granted
before impersonating a user's page.

Why this happens

All Instagram and Messenger connections go through one shared Meta app, and Meta stores its permissions per Facebook user, not per AI agent. When you authorize again for agent B and tick only agent B's account, Meta treats the unticked accounts as withdrawn and revokes them. Agent A goes quiet, even though you never touched it (see the diagram in Before you start).

Reconnecting agent A then does the same to agent B, so the two seem to take turns. A quiet account can look healthy for hours or days, until someone messages it and gets no reply. This is how Meta handles a shared app; Chat Data can't override it.

Fix: authorize everything at once, then use the checkboxes

  1. Reconnect the integration by following Connect Instagram with Chat Data.
  2. In the Facebook pop-up, tick every Facebook Page and Instagram account you want connected to Chat Data. Leave every permission ticked, especially Allow access to messages.
  3. Finish the authorization.
  4. In each agent's panel, tick ACTIVE only for the account that agent should answer. See Choose which account this agent answers.

Once every account is granted in one authorization, the connections stay up together. If you also use Messenger, include those Pages in the same authorization (see Messenger Integration).

Re-ticking the ACTIVE checkbox will not repair a revoked connection

Once Meta has revoked an account, ticking ACTIVE again only restores the old, invalid access, and the agent fails on the next message. Run the full Facebook authorization instead.

Chat Data emails you when a message arrives for a revoked account, and its daily check also emails you when it finds it has lost access. Don't wait for the email: if replies stop, reconnect.

Troubleshooting: The AI writes a reply but the customer never receives it

This is the most common Instagram problem. It comes from a setting on Meta's side, not from Chat Data. You are affected if all of these are true:

  • The customer's Instagram message appears in your Chat Data chat logs.
  • The AI writes a reply, and you can read it in the chat logs or Live Chat.
  • The customer never receives that reply on Instagram.
  • Meta Business Suite still shows the conversation as unanswered.

Meta rejects the delivery with this error:

(#100) The action is invalid since it's not the thread owner.

Why this happens

Instagram lets only one app at a time reply in a conversation: the thread owner. Meta chooses it with a feature called Conversation Routing. If no default routing app is set, Instagram gives every new conversation to your Meta Business Suite Inbox. Chat Data still receives the message and writes a reply, but Meta blocks it.

Only the app that owns a conversation can reply. If the Business Suite Inbox owns it, Meta rejects the AI reply with error #100

Fix: set Chat Data as your default routing app

  1. Open Facebook settings > Conversation routing.
  2. Use the account switcher in the top-right corner to switch to the Facebook Page connected to your Instagram account. The setting belongs to the Page, not your personal profile.
  3. In the Default routing app section, a Set up button means no app is assigned, which is the cause of your problem. Click Set up. Instagram conversation routing with no default app assigned
  4. In the Select a default routing app dialog, choose Chat Data in the App dropdown and click Continue. Select Chat Data as the default routing app
  5. Check that Default routing app now shows Chat Data.

If Chat Data isn't in the dropdown, you are almost certainly on the wrong Page profile: switch to the Page connected to your Instagram account and reload. If it's still missing, reconnect the integration.

Link routing and Campaign routing unlock too

While no default routing app is set, the Link routing and Campaign routing cards on the same page are greyed out and read "Default routing app is not set up". Choosing a default app enables all three.

Releasing conversations that are already stuck

The default routing app applies to new conversations right away. A conversation the Inbox already owns stays there until the owner releases it, or until the customer sends nothing for 24 hours. To hand one back now, open it in Meta Business Suite Inbox and mark it as Done.

Replying by hand keeps the conversation away from the AI

Each reply you send from the Meta Business Suite Inbox takes the conversation back to the Inbox, and the AI stays blocked on it. Mark the conversation Done when you finish, or reply from Chat Data Live Chat instead (see Live Chat Handover).

Verifying the fix

Message your Instagram account from a different personal Instagram account, without opening the conversation in Meta Business Suite. The AI reply should arrive within a few seconds.

If it doesn't, open Facebook settings > Advanced Messaging, switch to the connected Page, find Chat Data under Connected Apps, click Edit, and check that Access standby channel is enabled under Instagram Permissions.

Chat Data permissions in Advanced Messaging

Still stuck? Email [email protected] with your chatbot name and Instagram handle. We can ask Meta which app owns your conversations.

Reply settings

These settings are in the Instagram integration panel, each in its own section. Click the check mark to save a change.

SettingWhat it doesDefault
Response TypeText, Audio (spoken in the voice from your interface settings) or Mixed (text for text messages, audio for voice messages).Text
Auto OffAfter a teammate replies from Chat Data Live Chat, the AI stays silent in that conversation for this many minutes (1 to 10,080, which is one week), then resumes.On, 30 minutes
Delay ResponseWaits before replying, so several quick messages get one combined answer. Set an Average delay time and a Variance Range (seconds); the variance makes the timing look natural.Off
Follow-UpIf the customer goes quiet, the AI checks your Trigger Condition after the wait you set. If it's met, the AI sends a follow-up based on your Follow Up Instruction and the conversation. Each check uses extra credits.Off

Delay Response settings Follow-Up settings

Live Chat Handover

You can reply to a customer yourself from two places:

Chat Data Live ChatMeta Business Suite INBOX
How to open itDashboard > Live Chats, then Filter > Source > InstagramINBOX link in the integration panel or chat logs
Auto Off pauses the AIYesNo: Meta doesn't pass these replies to Chat Data
Email when the customer replies while you're offlineYesNo
When you finishThe AI resumes after Auto Off, or when you switch it back onMark the conversation Done so the AI can reply again

Live Chats filtered to Instagram, with an Instagram conversation open

To reply from Chat Data Live Chat:

  1. Open Dashboard > Live Chats, click Filter > Source, tick Instagram and select the conversation.
  2. Reply. The customer receives it in Instagram, and Auto Off keeps the AI silent in that conversation. To keep the AI off until you say so, switch it off for the conversation. The conversation header in Live Chats with the AI switched off (crossed-out robot icon, "Bot OFF · click to turn on")
  3. If the customer replies while the AI is off and you're offline, Chat Data emails a link to the chat to the address in your live chat settings (see New message to the teammate).
  4. When you're done, switch the AI back on.

Auto Off in the Instagram integration panel: the AI is turned off for 30 minutes after the last teammate message

Frequently Asked Questions

What do I need before connecting Instagram to Chat Data?

The prerequisites section says you need an Instagram Professional account and a Facebook Page connected to that account. Those two pieces are required before you begin the Chat Data integration flow.

How do I connect an Instagram account to Chat Data?

Open Agents, pick your AI agent and click Integrations, select the Instagram card, click `Connect`, sign in with Facebook, grant message access, choose the related Facebook Pages and Instagram accounts (every one you use with Chat Data), and save the final permissions review.

Does the Instagram integration require periodic renewal?

Yes. Meta's access lasts about 90 days; the exact date is shown in the Access Expiration Date column of the integration panel. Chat Data emails the workspace owner 3 days before it expires. To renew, click Renew Access in the integration and complete the Facebook authorization again, selecting every Page and Instagram account you use with Chat Data.

How do I set Chat Data as the default routing app for Instagram?

Go to facebook.com/settings/?tab=ig_conversation_routing, switch to the Facebook Page connected to your Instagram account using the top-right account switcher, click Set up under Default routing app, choose Chat Data in the App dropdown, and click Continue. If Chat Data is not listed, you are on the wrong Page profile.

Previous
LINE Integration