Docs/Channels

Connecting Facebook (Messenger)

From the Channels tab — click Connect → a modal opens → you're redirected to Facebook for authorization.

Requirements

The channel is labeled "Facebook Messenger" in the UI. Before connecting you need: • **A Facebook Page** — a business page you already use. • **Admin rights** — you must be an Admin on the page (not just a Moderator).

1. Open the "Connect Facebook Messenger" modal

In Dashboard → **Channels** tab → Messenger row (blue icon) → purple "Connect" button on the right. Click it — a modal opens titled "Connect Facebook Messenger" with subtitle "Automatic connection with Meta". It has a "Before you connect, make sure you have:" section listing the two requirements (FB Page + admin rights).
Channels tab — Messenger row "Not connected" with a "Connect" button

2. Click "Connect with Messenger"

The button sits at the bottom of the modal with a note below — "You'll be redirected to Facebook for authorization". We redirect to `https://www.facebook.com/v21.0/dialog/oauth` with scopes `pages_messaging,pages_show_list,pages_manage_metadata`. If the `META_FB_CONFIG_ID` env is set, we use a Facebook Login for Business config (which bundles the needed permissions).

3. Pick the page + approve permissions

Facebook asks which page to connect and which permissions to grant. Pick the page you admin and click Continue/Allow.

4. Back in the dashboard

We return you to the dashboard. The Facebook Messenger row is green and shows the connected page name. Webhooks are set up automatically; if something breaks — status is "Pending setup" with a "Retry" button. To unlink: click the menu button next to the green status → Disconnect.
Connecting Facebook (Messenger) · rAIceptionist Docs