Connect Facebook Messenger
View as Markdown
The **Facebook** channel (`/{slug}/channels/facebook`) connects your **Facebook Fanpages** to the workspace so you can receive and reply to Messenger conversations and enable AI Bot auto-replies.
:::note[Required permissions]
- **View connected Fanpages**: **`nick:read:all`** (navigation item is visible with `nick:read:all`, `nick:connect`, or `nick:operate`).
- **Connect / Reconnect a Fanpage**: **`nick:connect`**.
- **Disconnect a Fanpage**: **`nick:delete`**.
- **Assign AI Bot & toggle AI**: **`workspace:manage`**.
:::
## Prerequisites
- Your Facebook account must have administrative access to the **Fanpage** you want to connect.
- Your browser must allow **popups** to complete the Meta OAuth login flow.
## Connect a Facebook Fanpage
1. Go to **Channels → Facebook** (or **All Channels**), click **Add Channel**, and choose **Facebook**.
2. Click **Connect Now** to open the **Meta OAuth (v21.0)** popup and grant the required permissions:
- `pages_show_list` (list your Fanpages)
- `pages_read_engagement` (read page engagement info)
- `pages_manage_metadata` (subscribe the page to webhooks)
- `pages_messaging` (receive and send Messenger messages)
3. After authorization, OmnyBot exchanges the code and loads your available Fanpages.
4. Select the Fanpage to connect and click **Confirm Connection**.
:::tip[Manual authorization code fallback]
If your browser blocks the popup callback message (for example during local testing), copy the callback URL (containing `code=...`) or the raw authorization `code` and paste it into the manual input field shown in the dialog to proceed to page selection.
:::
## Fanpage Management Actions
Open the **`⋮`** menu on any connected Fanpage row to:
- **View on Facebook**: Open the Fanpage directly on Facebook in a new tab.
- **Sync Messages**: Manually pull and sync recent conversations and messages from the Fanpage into your Inbox.
- **Reconnect Page** (`nick:connect`): Re-run Meta OAuth to refresh the page access token if it expires or permissions change.
- **Disconnect Page** (`nick:delete`): Disconnect the Fanpage from the workspace.
:::caution[Disconnecting a Fanpage]
Once disconnected, OmnyBot stops receiving new Messenger events for that Fanpage until you connect it again.
:::
## Related Guides
- [Channels Overview](/channels/overview/)
- [Connect WhatsApp Business](/channels/whatsapp/)
The Facebook channel (/{slug}/channels/facebook) connects your Facebook Fanpages to the workspace so you can receive and reply to Messenger conversations and enable AI Bot auto-replies.
Prerequisites
Section titled “Prerequisites”- Your Facebook account must have administrative access to the Fanpage you want to connect.
- Your browser must allow popups to complete the Meta OAuth login flow.
Connect a Facebook Fanpage
Section titled “Connect a Facebook Fanpage”- Go to Channels → Facebook (or All Channels), click Add Channel, and choose Facebook.
- Click Connect Now to open the Meta OAuth (v21.0) popup and grant the required permissions:
pages_show_list(list your Fanpages)pages_read_engagement(read page engagement info)pages_manage_metadata(subscribe the page to webhooks)pages_messaging(receive and send Messenger messages)
- After authorization, OmnyBot exchanges the code and loads your available Fanpages.
- Select the Fanpage to connect and click Confirm Connection.
Fanpage Management Actions
Section titled “Fanpage Management Actions”Open the ⋮ menu on any connected Fanpage row to:
- View on Facebook: Open the Fanpage directly on Facebook in a new tab.
- Sync Messages: Manually pull and sync recent conversations and messages from the Fanpage into your Inbox.
- Reconnect Page (
nick:connect): Re-run Meta OAuth to refresh the page access token if it expires or permissions change. - Disconnect Page (
nick:delete): Disconnect the Fanpage from the workspace.