- Docs
- Guides
Instagram & Facebook Messenger
Answer Instagram DMs and messages to your Facebook Page from the shared inbox. They arrive like any chat — assignment, saved replies, notes, tags, live translation, automations and the AI assistant all work the same — and your replies go back to Instagram or Messenger. Instagram and Facebook Messenger are included with Pro, Lifetime and Reseller accounts.
Your own Meta app, your own accounts. You connect your Facebook Page and Instagram professional account through a Meta app that you own. Messages go directly between Meta and TalkingDot; your tokens are stored encrypted. Because it is your app, Meta’s own rules apply: the 24-hour reply window, the permissions your app has, and — depending on your app’s access level — Meta’s App Review and Business Verification before every customer’s messages reach you.
Before you start
- A Meta developer account and an app of type Business at developers.facebook.com.
- For Messenger: a Facebook Page you manage. For Instagram: a professional account (Business or Creator) — linked to a Facebook Page, or not.
- In the Instagram app: Settings → Messages and story replies → Message controls → Connected tools, turn on Allow access to messages.
- This site on
https://— Meta only delivers webhooks to secure addresses.
Connect Facebook Messenger
- Add Messenger to your app. In your Meta app add the Messenger use case (Messenger API).
- Make a Page access token that doesn’t expire. In Meta Business Settings → Users → System users, add a system user, assign it your app and your Page (full control), and generate a token with
pages_messaging,pages_manage_metadata,pages_show_list,pages_read_engagementandbusiness_management. A Page token from the Messenger settings works too; we swap a system-user token for the Page’s own token automatically. - Connect. In Settings → Messaging apps open Facebook Messenger and paste the Page ID (your Page → About → Page transparency), the token and the App secret (App settings → Basic). We check that the token can act as that Page and subscribe the Page to your app.
- Point the webhook here — see below, object Page, fields
messages,message_echoes,message_reads,message_editsandmessaging_postbacks.
Connect Instagram
Meta offers two ways. Use the first unless your Instagram account already runs through a Facebook Page and Messenger.
A. Instagram login (no Facebook Page needed)
- Add Instagram to your app. Add the Instagram use case and open API setup with Instagram login.
- Generate a token. Under Generate access tokens add your Instagram account and generate a token — it starts with
IG. Copy the Instagram app secret from the same page. - Connect. In Settings → Messaging apps → Instagram paste the token and the app secret, and leave Facebook Page ID empty. We look up your account and subscribe it to your app. These tokens last 60 days; TalkingDot renews yours automatically every few days, and warns you in Settings if it can’t be renewed before it runs out.
- Point the webhook here under Configure webhooks on the same page — fields
messagesandmessaging_seen.
B. Through your Facebook Page
- Use a Page token with Instagram permissions: the Messenger token above with
instagram_basicandinstagram_manage_messagesadded. - Connect. In Settings → Messaging apps → Instagram paste that token, your Meta App secret and the Facebook Page ID. We find the Instagram account linked to the Page.
- Point the webhook here in the Webhooks product, object Instagram — fields
messagesandmessaging_seen.
Point the webhook here
After you connect, each channel shows its own Callback URL and Verify token in Settings → Messaging apps. In your Meta app, paste both where the steps above say, click Verify and save, and tick the fields listed. Meta checks the address right away; the channel switches from Waiting for Meta to verify the webhook to Connected. Every message Meta sends is signed with your app secret and checked before anything is stored.
The 24-hour window and the Human agent tag
Meta lets businesses reply for 24 hours after the customer’s last message. After that, the inbox shows that the window has closed and replies wait for the customer to write again.
If Meta has approved your app for the Human Agent feature, tick “My Meta app is approved for the Human Agent feature” on the channel. Teammates can then reply for up to 7 days: the reply goes out with Meta’s HUMAN_AGENT tag and the composer says so. The tag is only for a person’s own answer, so automated, chatbot and AI messages are never sent with it.
What comes in and what goes out
| Customers send | In the inbox |
|---|---|
| Text, quick replies, buttons they tap | The text (a button shows as what they chose) |
| Photos, videos, voice messages, files | Copied into the conversation as attachments |
| Stickers and the 👍 like | An emoji note |
| Instagram story replies and mentions | A note with the story link (it stops working when the story expires — Meta doesn’t allow keeping story media) |
| Shared posts, reels and links | A note with the link |
| An unsent Instagram message | The text and files are removed; a line says it was unsent |
| An edited Messenger message | The new text |
Your replies go out as text and attachments: images, video, audio and files on Messenger; PNG/JPEG images, video, audio and PDFs on Instagram (other files are sent as a link). Long replies are split into Meta’s message size. Chatbot buttons and help-article cards become numbered lines and links.
Meta’s App Review: when you need it
While your Meta app is in development, only people with a role on the app (admins, developers, testers) can message you through it — perfect for a first test from your own account. Meta’s documentation says a business that only handles its own Page doesn’t need App Review, while its webhook and access-level pages ask for Advanced Access to receive every customer’s messages. Follow what Meta asks of your app: if messages from customers without a role don’t arrive, request Advanced Access for the permissions above in App Review (with Business Verification). Meta’s pages: Messenger Platform, Instagram App Review, access levels.
Good to know
- Replies made in Meta’s apps: a message your team sends from the Page inbox (Meta Business Suite) or the Instagram app shows in the conversation too, marked with where it came from — it is not sent twice.
- Names and pictures: we ask Meta for the customer’s name, Instagram @username and profile picture after their first message and keep a copy of the picture. Facebook Messenger shares names only with apps that have Meta’s Business Asset User Profile Access; without it the contact keeps a generic name.
- Seen: when the customer reads your reply, it shows as Seen.
- Conversations: a customer who writes again within a day of closing reopens the same conversation; later messages start a new one.
- Automations and AI: routing rules (with a Channel condition), away replies and the AI assistant work on both channels; Reports show conversations per channel.
- Plans: included with Pro, Lifetime and Reseller accounts. On another plan a connected account is paused: Meta’s messages are not stored and replies are not sent until you upgrade — your customers’ messages stay in Meta’s own inbox.
- Disconnecting stops new messages; past conversations stay in the inbox.