Connect Instagram professional-account DMs through Meta Graph credentials and signed webhooks.
Connect Instagram professional-account DMs through Meta Graph credentials and signed webhooks.
What this connector does#
Customers send a direct message to your Instagram professional account. Make Agent Fast answers with the same grounded agent as your website embed. This is the official Instagram Messaging API on a Facebook Page–linked professional account.
Out of scope: comment-to-DM, story replies, feed comments, scraping, and unofficial Instagram login. Those are not DMs on this connector.
The same Meta app can also power Messenger and WhatsApp. Instagram is still a separate channel row so billing, inbox threads, and webhook binding stay distinct.
Prepare the Meta app and Instagram account#
Follow Meta's official Instagram Messaging getting-started guide. You need:
- An Instagram professional account (Business or Creator).
- That account linked to a Facebook Page you administer.
- A Meta app with the Instagram / Messenger product and Instagram messaging enabled.
- A Page access token for that Page and the app's 32-character hex app secret.
Collect:
| Make Agent Fast field | Provider value | Purpose |
|---|---|---|
| Page access token | Token issued for the linked Facebook Page | Reads the linked Instagram account and sends DM replies |
| App secret | 32-character hexadecimal Meta app secret | Verifies signed inbound webhook requests |
Do not paste a user access token or a token for a different Page. Graph validation fails closed if the Page has no linked Instagram professional account.
There is no platform-owned Instagram Login OAuth on Make Agent Fast. You bring credentials from your Meta app.
Save and validate credentials#
Open the site's Connectors page, select Instagram, enter the Page access token and app secret, and select Connect.
Make Agent Fast calls Graph with appsecret_proof, requires instagram_business_account, and binds inbound events to that Instagram account id. The connector card then displays its Webhook URL and Verify token.
Connecting a new channel requires Operate or Scale.
Configure the Instagram webhook#
In the same Meta app:
- Open Instagram (or Messenger) webhook settings.
- Paste the connector Webhook URL and Verify token.
- Complete the verification challenge.
- Subscribe the Instagram
messagesfield. - Confirm the Page and Instagram professional account are associated with the app.
- Confirm app mode permits your test user.
The verify token is used only for the initial challenge. Runtime events must carry X-Hub-Signature-256 matching the app secret. Make Agent Fast also rejects events addressed to a different Instagram account even if they came from the same Meta app, and ignores Messenger object: "page" payloads on this URL.
Test capabilities#
Send a normal DM from a permitted, non-admin test account and confirm the response plus Conversations thread. Then test an audio note if inbound voice matters.
Text and supported inbound audio are processed. Replies are text-only. Echoes of your own messages, story mentions, images, and other unsupported attachments are ignored.
Production readiness#
Complete Meta's permissions, App Review (instagram_manage_messages and related Page permissions), business verification, privacy URL, and publication steps. Development-mode success with an app-role account does not establish that the public can DM the integration.
Document the owning Meta app, Page ID, and Instagram account ID for operators. A Page token can stop working when its owner, permissions, business association, or provider policy changes.
Rotate or disconnect#
Generate the replacement Page token, update the connector, test from a permitted user, then invalidate the old token. Update Make Agent Fast immediately after rotating the app secret.
Disabling or removing the connector does not unsubscribe Instagram in Meta. Remove the subscription and unused provider credential when permanently decommissioning the integration.
Troubleshooting#
| Symptom | Fix |
|---|---|
| Token rejected | Confirm it is a Page token for the intended Page and the app secret belongs to the same app |
| Page valid but “no linked Instagram account” | Link an Instagram professional account to the Page in Meta Business Suite |
| Webhook verification fails | Copy the current URL and verify token exactly; use public HTTPS |
| Verification works but messages do not arrive | Subscribe the Instagram messages field, then check app mode, user role, and Meta delivery logs |
| Requests are unauthorized | Correct the app secret; signed POST requests do not use the verify token |
| Inbound message appears but no reply | Check Page token validity, instagram_manage_messages, provider send error, and connector status |
| Voice gets a text answer | Expected; outbound Instagram voice is not currently supported |
| Public customers cannot DM | Finish Meta App Review; development mode only delivers for app-role testers |
Provider credentials belong only in the authenticated connector form or a trusted server-side API call.