Facebook Messenger

Connects an agent to a Facebook Page. Messages sent to the Page, as well as feed events (posts, comments, etc.), are routed to the agent for processing.

  • Supported agents: Chatbot, Agentic Flow

  • Route type: Conversation

Before You Start

  1. Create a Meta Developer App at developers.facebook.com and add the Messenger product.

  2. Connect a Facebook Page to the app.

  3. Generate a Page Access Token for the connected page (Graph API Explorer or App settings → Messenger → Settings → Access Tokens). Use a permanent (never-expiring) token.

  4. Note the App ID and App Secret from your app’s Basic Settings.

  5. Note the Page ID from the Facebook Page’s About section.

  6. Choose a Verify Token — this is any string you define. You will enter the same string both in Neo and in the Meta webhook settings.

Your agent must be published with an active version. The Channel Gateway MCP must also be enabled:

  • Global: Admin Panel → MCP Servers → Channel Gateway → Enable and Deploy

  • Workspace: Workspace Settings → MCP → Channel Gateway → toggle ON

After creating the channel in Neo, register the webhook URL in Meta Developer Console (Messenger → Settings → Webhooks). Meta will send a verification request to the URL using your Verify Token — Neo handles this automatically.

Configuration

Credentials

  • App ID — The Facebook App ID from Meta Developer Portal. Required.

  • App Secret — The Facebook App Secret from Meta Developer Portal. Required.

  • Page ID — The Facebook Page ID. Required.

  • Page Access Token — Permanent access token for the Facebook Page. Required.

  • Verify Token — The custom string used to verify the webhook with Meta. Must match what you enter in Meta’s webhook settings. Required.

Route Settings

  • Description — Optional label for this channel instance.

  • Purpose — Optional note on when the agent should use this channel.

  • Allowed Event Types — Selects which Facebook feed events the agent should process. Options: Post, Comment, Photo, Video, Share, Link, Status. Default: Post, Comment. Only shown for Agentic Flow agents.

  • Session Expiry (hours) — Idle timeout before a conversation session resets. Default: 4. Range: 0.01–48.