Skip to content

Instagram

Connect Instagram DMs through the linked Facebook Page — including the account setting that silently blocks every message.

Instagram runs through the same Meta app and the same Page token as Messenger. The differences are the two Instagram account settings below.

What you need

  • A Meta developer app of type Business with the Messenger product

    added.

  • A Facebook Page you administer.
  • An Instagram professional account linked to that Page.

Prepare the Instagram account

  1. 1
    Switch the account to professional: Instagram app → **Settings → Account

    type and tools**.

  2. 2
    Link it to the Facebook Page.
  3. 3
    Turn on Instagram app → **Settings → Messages and story replies → Allow

    access to messages**.

Warning:

With "Allow access to messages" off, DMs never reach the webhook, however correct everything else is — and nothing anywhere reports an error. Check this before debugging anything else.

Connect

  1. 1
    In Meta app → Messenger → Settings, connect the IG-linked Page and

    generate the Page access token. The credential for Instagram is that Page token — there is no separate Instagram token.

  2. 2
    In evoriqa, add an Instagram channel with the Meta App Secret, a

    verify token of your choosing, and that Page access token. Copy the webhook URL.

  3. 3
    Messenger → Settings → Webhooks → Add Callback URL: paste the URL and the

    same verify token, then Verify and save, and subscribe the `messages` field.

  4. 4
    Subscribe the Page in the same panel — the app-level subscription alone

    delivers nothing.

Verify it works

DM the Instagram account from an account holding a role on the app or the Page — in Development mode Meta drops everyone else's events. The conversation should appear in the Inbox tagged Instagram.

Inbound requests are verified with x-hub-signature-256 against the app secret.

Before launch

Switch the app to Live and obtain Advanced Access to pages_messaging and instagram_manage_messages through App Review, which requires business verification.

Troubleshooting

SymptomCause
Connected but DMs never arrive"Allow access to messages" is off, or the account is not a professional account linked to the Page
Verified but No messages yetThe Page subscription is missing, or the app is in Development mode
Signature rejectedMeta is delivering; the app secret is wrong
Replies not sendingThe Page token is invalid, or instagram_manage_messages Advanced Access is missing

Where to go next

Last updated