Reviewer guide

Six-step demo flow for Meta App Review.

Test account
Send your test DM to this Instagram account.
Test handle: @marinaia.test

The AI reply may take 5–15 seconds to appear after sending the test DM, depending on n8n cold-start and Meta delivery latency. Refresh Inbox if it does not appear immediately.

Approval flow
Follow these steps end-to-end to verify the integration.
Step 1 — Configure Instagram settings
Open Instagram Settings and confirm the Instagram Business Account ID, Page Access Token, App ID, and App Secret are saved. Use the Test Connection button to verify the token resolves against Meta.
Demonstrates: instagram_basic — read account metadata
Step 2 — Set up the Meta webhook
Copy the Web App Callback URL and Verify Token from Instagram Settings and paste them into the Meta App → Webhooks → Instagram subscription form. Subscribe to the `messages` field.
Step 3 — Send a test DM to @marinaia.test
From any personal Instagram account, send a DM (e.g. "Hi, what does this app do?") to @marinaia.test. Meta will deliver the message to our public webhook within a few seconds.
Demonstrates: instagram_manage_messages — receiving DMs
Step 4 — Confirm the DM appears in Inbox
Open Inbox. A new conversation row should appear at the top, bolded with an unread indicator, showing the message preview.
Step 5 — Confirm an AI or manual reply is sent back
If auto-reply is on, n8n returns an AI reply within 5–15 seconds and it appears in the thread as 'AI reply' and on Instagram as a DM from the connected account. Otherwise, type a message and press Send to post a 'Human reply'. Either path exercises sending.
Demonstrates: instagram_manage_messages — sending replies
Step 6 — Confirm Automation Logs
Open Automation Logs. You should see dm_received, n8n_forwarded, and ai_reply_recorded (or manual_reply_sent) entries for the test conversation.
App API endpoints
The routes Meta and n8n communicate with.
GET
/api/public/instagram/webhookMeta verification handshake
POST
/api/public/instagram/webhookReceive Instagram DM events from Meta
POST
/api/public/n8n/replyReceive AI reply from n8n and send via Meta
POST
/api/instagram/sendManual reply sent by a human agent
GET
/auth/instagram/callbackInstagram Business Login OAuth redirect
POST
/api/public/instagram/deauthorizeMeta deauthorization callback
Requested Meta permissions
Required to read and send DMs on behalf of the connected Instagram Business account.
instagram_basic
Read connected Instagram Business account metadata
instagram_manage_messages
Receive incoming DMs and send replies on behalf of the business
pages_messaging
Send messages through the linked Facebook Page
pages_show_list
List the Pages the connected user manages