Connect your Instagram to the assistant

PART 1 · Prepare Instagram (the switches that live in the phone)

1.1 Professional account

Instagram app: Settings → Account → Switch to professional account→ Business or Creator.

PART 2 · Enable Instagram in your Meta App (same Messenger app)

2.1 The right section

developers.facebook.com → your app → Messenger use case →Instagram settings (in the use-case menu). Everything in this guide lives there. (You'll also see a separate "Manage messaging & content on Instagram" use case with its own publish-the-app checklist and another App Review —ignore it: it's a different, longer rail that you don't need to connect DMs with your existing app.)

2.2 Connect the Page with its Instagram

In Instagram settings → Access tokens you'll see "No page permissions granted" the first time.

Click Add or remove Pages → in the popup: check your Page✅ and your Instagram account ✅ → always choose "Opt in to current only" (never "all current and future") → all permissions to Yes → Done. The section will show your Page with "Token generated".

PART 3 · Your credentials (3 values)

3.1 The token (it's a Page Access Token with Instagram permissions)

In Access tokens, your Page's row → Generate. Copy it in full. Verify it in the Access Token Debugger (developers.facebook.com/tools/debug/accesstoken): it must say Type: Page · Expires: Never and under Scopes it must showinstagram_manage_messages. If it doesn't, go back to ig-trampa-4.

3.2 App Secret

App settings → Basic → App secret → Show. The SAME one as Messenger (exactly 32 hexadecimal characters).

3.3 Instagram ID (the "object id")

It's the numeric ID of your professional account (not your @username). You see it in Business Suite → Instagram accounts (or in the Instagram settings section itself).

PART 4 · The webhook (two places, not one)

4.1 Paste the pair in Instagram settings

Instagram settings → Webhooks → Add callback URL → paste the Callback URL + Verify token from the panel → Verify and save (it must turn green).

4.2 Subscribe messages at the app level (the step everyone skips)

In the app's general Webhooks section → object dropdown →Instagram → subscribe only the messages field.

PART 5 · Test (with the development-mode detail)

Complete the Connect in your panel (App Secret + token + Instagram ID) → the channel goes pending. Send a DM from ANOTHER Instagram account — and here's the detail nobody tells you: while your app is in development mode, only DMs from accounts with a role in the app deliver webhooks(Instagram Tester: App roles → invite → the account accepts in Instagram → Settings → Websites and apps → Invitations). The first valid DM activates the channel (pending → connected) and the assistant replies.

1-MINUTE SUMMARY

Guide based on the real connection performed on 12-Jul-2026, with its nine traps and fixes exactly as they happened. Meta's interface changes frequently: if a screen doesn't match, look for the same labels in the equivalent section.