Connect Instagram direct messages to Dchat

Before you start

• Difficulty: Hard
• Time: 30–60 minutes
• You need: An Instagram professional (business or creator) account linked to a Facebook Page
• You need: A Meta developer app with Instagram messaging and Webhooks set up
• You need: Admin or owner access to your Dchat workspace

Steps

1. Collect your values from Meta

   You need the Instagram professional account ID, a Page access token for the Facebook Page the account is linked to, and your Meta app's app secret.

2. Add the channel in Dchat

   In Dchat, open Settings → Channels and choose + Add channel. Pick "Instagram", put the Instagram professional account ID in the identifier field, and paste the credentials. Choose any verify token without spaces.

   { "PageAccessToken": "EAAG...", "AppSecret": "...", "VerifyToken": "any-phrase-you-choose" }

3. Point Meta's webhook at Dchat

   In your Meta app's Webhooks settings for Instagram, set the callback URL below and the same verify token, then subscribe to the messages field.

   https://api.dchat.com/api/inbound/meta

4. Send a test DM

   Message the account from another Instagram account. It lands in your Dchat inbox, and the AI replies if AI is on for your workspace.

What goes in each field

• PageAccessToken: A Page access token for the Facebook Page linked to the Instagram account.
• AppSecret: Your Meta app's app secret, used to check Meta's signature on every webhook.
• VerifyToken: Any phrase without spaces; the same one goes into Meta's webhook settings.

Good to know

• Direct messages only. Replies to post comments are not supported.
• Text, quick-reply taps and photos (up to 5 MB) are handled. Replies are up to 2,000 characters with up to 13 quick replies.
• While your Meta app is in development mode, only people with a role on the app can message it. Accepting messages from the public needs Meta's app review.
• Your workspace needs at least one enabled site; new workspaces have one already. Messages are dropped while every site is switched off.
• Credentials are encrypted when you save them and are never shown again. To change one, paste the full credentials again.