Integrations

Instagram Direct & Meta Graph API

Evnao connects directly to Instagram Professional accounts through Meta's Facebook Login bridge. This architecture allows Evnao AI to ingest incoming direct messages, generate context-grounded responses, and deliver replies with human takeover support.

Interactive In-App Setup Wizard

Follow the 15-step interactive wizard inside your workspace with live token checks, copyable snippets, and instant error diagnosis.

Launch Setup Wizard

Permanent Page Tokens

Evnao requires a long-lived Page Access Token derived from an extended User token. When verified in Meta's Token Debugger, the token type must be Page and expiration must report Never.

Meta Graph Bridge (v26.0)

Outbound messages are routed via https://graph.facebook.com/v26.0/{PAGE_ID}/messages with the recipient's Instagram-scoped ID (IGSID) and the connected Page Access Token.

Echo Events & Human Takeover

When any teammate replies directly from the Instagram mobile app or Meta Business Suite, Evnao processes the is_echo: true webhook event, saves the message in Inbox, and pauses AI replies.

Required Connection Credentials

Enter these five values into Evnao Settings → Channels → Instagram:

Instagram Account ID: Numeric identifier of the Professional account (e.g. 17841412345678901) found under instagram_business_account.id.
Facebook Page ID: Numeric identifier of the connected Facebook Page (e.g. 123456789012345) found at data[].id.
Page Access Token: Long-lived access token belonging specifically to the connected Facebook Page. Verified with Expires: Never.
Meta App Secret: The 32-character secret found in your Meta Developer Dashboard under App Settings → Basic → App Secret.
Webhook Verify Token: A private cryptographically random string (e.g. generated in Evnao) matching the verify token entered into Meta's Webhooks dashboard.

Graph API Explorer Snippets

Execute these queries in Meta's Graph API Explorer to discover IDs and subscribe webhooks:

1. Discover Page ID and Instagram ID

GET /me/accounts?fields=id,name,access_token,instagram_business_account{id,username,name}

Run with your extended User token. Copy data[].id (Page ID) and data[].instagram_business_account.id (Instagram ID).

2. Verify Token Identity

GET /me?fields=id,name

Run with your Page token selected. The returned ID must match your numeric Facebook Page ID.

3. Subscribe Facebook Page to Messages

POST /{PAGE_ID}/subscribed_apps?subscribed_fields=messages,messaging_postbacks

Must return {"success": true} using your verified Page Access Token.

Required Meta Permissions (7 Total)

Ensure your Meta Developer App and Facebook Login for Business configuration include all seven permissions:

instagram_manage_messages: Receives customer DMs and delivers AI replies via Meta Graph API.
instagram_basic: Reads basic Instagram profile details and handles account verification.
pages_messaging: Required to subscribe the Facebook Page to messages webhook events.
pages_manage_metadata: Allows Evnao to subscribe webhooks to the connected Facebook Page.
pages_read_engagement: Reads Page asset information and resolves linked Instagram business accounts.
pages_show_list: Discovers the list of Facebook Pages managed by your authorized user.
business_management: Permits Graph API Explorer to access and manage assets in your Business Portfolio.

Common Meta Error Codes & Diagnostics

Reference table for resolving standard Meta Graph API and webhook configuration errors:

(#210): Page Token Required; A User or System User token was used for a Page operation. Switch to your Page Access Token and verify with GET /me?fields=id,name.
(#200): Missing pages_messaging; Add 'Engage with customers on Messenger' in Meta App Use Cases, enable pages_messaging, reauthorize, and derive a fresh Page token.
(#200): Insufficient Admin Rights; The Facebook user lacks Full Control in Business Settings. Ensure 2FA is active on your profile if enforced by your Business Portfolio.
(#100): Missing pages_read_engagement; The token cannot read the Page asset. Grant pages_read_engagement and pages_show_list, then generate a fresh token.
(#100): Nonexisting Field (accounts); GET /me/accounts was executed with a System User token. Switch to your extended User Access Token before discovering Page tokens.
(#3): App Capability / Pending Tester; In Development mode, the recipient must accept their Instagram Tester invite in Instagram App Settings -> Apps & Websites -> Tester Invites.
(#190): Token Expired (1-Hour Token); A short-lived User token was used. Extend the User token in Access Token Debugger, then extract a Page token with 'Expires: Never'.

Integrations

Instagram Direct & Meta Graph API

Interactive In-App Setup Wizard

Follow the 15-step interactive wizard inside your workspace with live token checks, copyable snippets, and instant error diagnosis.

Launch Setup Wizard

Permanent Page Tokens

Evnao requires a long-lived Page Access Token derived from an extended User token. When verified in Meta's Token Debugger, the token type must be Page and expiration must report Never.

Meta Graph Bridge (v26.0)

Outbound messages are routed via https://graph.facebook.com/v26.0/{PAGE_ID}/messages with the recipient's Instagram-scoped ID (IGSID) and the connected Page Access Token.

Echo Events & Human Takeover

When any teammate replies directly from the Instagram mobile app or Meta Business Suite, Evnao processes the is_echo: true webhook event, saves the message in Inbox, and pauses AI replies.

Required Connection Credentials

Enter these five values into Evnao Settings → Channels → Instagram:

Instagram Account ID: Numeric identifier of the Professional account (e.g. 17841412345678901) found under instagram_business_account.id.
Facebook Page ID: Numeric identifier of the connected Facebook Page (e.g. 123456789012345) found at data[].id.
Page Access Token: Long-lived access token belonging specifically to the connected Facebook Page. Verified with Expires: Never.
Meta App Secret: The 32-character secret found in your Meta Developer Dashboard under App Settings → Basic → App Secret.
Webhook Verify Token: A private cryptographically random string (e.g. generated in Evnao) matching the verify token entered into Meta's Webhooks dashboard.

Graph API Explorer Snippets

Execute these queries in Meta's Graph API Explorer to discover IDs and subscribe webhooks:

1. Discover Page ID and Instagram ID

GET /me/accounts?fields=id,name,access_token,instagram_business_account{id,username,name}

Run with your extended User token. Copy data[].id (Page ID) and data[].instagram_business_account.id (Instagram ID).

2. Verify Token Identity

GET /me?fields=id,name

Run with your Page token selected. The returned ID must match your numeric Facebook Page ID.

3. Subscribe Facebook Page to Messages

POST /{PAGE_ID}/subscribed_apps?subscribed_fields=messages,messaging_postbacks

Must return {"success": true} using your verified Page Access Token.

Required Meta Permissions (7 Total)

Ensure your Meta Developer App and Facebook Login for Business configuration include all seven permissions:

instagram_manage_messages: Receives customer DMs and delivers AI replies via Meta Graph API.
instagram_basic: Reads basic Instagram profile details and handles account verification.
pages_messaging: Required to subscribe the Facebook Page to messages webhook events.
pages_manage_metadata: Allows Evnao to subscribe webhooks to the connected Facebook Page.
pages_read_engagement: Reads Page asset information and resolves linked Instagram business accounts.
pages_show_list: Discovers the list of Facebook Pages managed by your authorized user.
business_management: Permits Graph API Explorer to access and manage assets in your Business Portfolio.

Common Meta Error Codes & Diagnostics

Reference table for resolving standard Meta Graph API and webhook configuration errors:

(#210): Page Token Required; A User or System User token was used for a Page operation. Switch to your Page Access Token and verify with GET /me?fields=id,name.
(#200): Missing pages_messaging; Add 'Engage with customers on Messenger' in Meta App Use Cases, enable pages_messaging, reauthorize, and derive a fresh Page token.
(#200): Insufficient Admin Rights; The Facebook user lacks Full Control in Business Settings. Ensure 2FA is active on your profile if enforced by your Business Portfolio.
(#100): Missing pages_read_engagement; The token cannot read the Page asset. Grant pages_read_engagement and pages_show_list, then generate a fresh token.
(#100): Nonexisting Field (accounts); GET /me/accounts was executed with a System User token. Switch to your extended User Access Token before discovering Page tokens.
(#3): App Capability / Pending Tester; In Development mode, the recipient must accept their Instagram Tester invite in Instagram App Settings -> Apps & Websites -> Tester Invites.
(#190): Token Expired (1-Hour Token); A short-lived User token was used. Extend the User token in Access Token Debugger, then extract a Page token with 'Expires: Never'.

Getting started

Core concepts

Integrations

Getting started

Core concepts

Integrations

Instagram Direct & Meta Graph API

Interactive In-App Setup Wizard

Permanent Page Tokens

Meta Graph Bridge (v26.0)

Echo Events & Human Takeover

Required Connection Credentials

Graph API Explorer Snippets

Required Meta Permissions (7 Total)

Common Meta Error Codes & Diagnostics

Instagram Direct & Meta Graph API

Interactive In-App Setup Wizard

Permanent Page Tokens

Meta Graph Bridge (v26.0)

Echo Events & Human Takeover

Required Connection Credentials

Graph API Explorer Snippets

Required Meta Permissions (7 Total)

Common Meta Error Codes & Diagnostics