> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Facebook Messenger

> Connect Facebook Pages so the messages customers send them in Messenger become sessions the AI answers. Covers Page selection, message types and errors.

Connect your Facebook Pages so the messages customers send them in Messenger arrive as sessions in your inbox, where the AI answers them and your team can take over. Use it when customers contact your business through your Facebook Page.

> [!NOTE]
>
> **[Channels → Messenger](https://platform.open.cx/channels/messenger)** in your OpenCX dashboard; the page is headed **Facebook Messenger**. Viewing it needs the **Channels settings** read permission. Adding or disconnecting Pages needs the write permission.

## Connect your Pages

**1. Start the connection**

Go to **[Channels → Messenger](https://platform.open.cx/channels/messenger)** and click **Add page**. Facebook opens in a new tab.

**2. Choose Pages and allow messaging**

Sign in, select the Pages you want OpenCX to answer for, and allow OpenCX to manage their messages. Without the messaging permission, the connection fails.

**3. Check the Page list**

You return to **Channels → Messenger**. Each connected Page appears under **Pages** with its name and Page ID.

**4. Send a test message**

Message one of the Pages from a personal Facebook account. The message appears in the [inbox](https://platform.open.cx/inbox), and the AI replies when the **Messenger** row is on in [Autopilot settings](https://docs.open.cx/safety/autopilot-settings.md).

### Pages managed by a business portfolio

If your Page is managed by a Meta Business portfolio, the standard connection may fail. The **Connection failed** dialog then offers **Retry the connection as a business**, which runs a connection made for business-managed Pages. Use it instead of **Add page**.

### Change which Pages are connected

Each time you click **Add page**, OpenCX connects the Pages you granted in that session and disconnects connected Pages you left out. To remove one Page, click **Add page** again and grant every Page except that one.

**Disconnect…** removes all Pages at once. OpenCX stops receiving their messages. Their sessions stay in the inbox, but replies to them can't be delivered until you connect the Page again.

## What OpenCX receives

* **Messages sent to your Page**: the text, and the first attachment of each message.
* **Quick reply taps**: when a customer taps a reply button, the session records the option they chose.

Comments on your Page's posts are not received, so they never become sessions. Messages your team sends from Facebook are not copied into OpenCX. Reply from the inbox if you want the reply in the session history.

## How sessions work

* Each customer has one open session per Page. Every message they send to that Page joins it until the session is closed. Their next message after that starts a new session.
* The session's contact is named after the customer's Facebook first and last name.
* Handoff, assignment and [handoff notifications](https://docs.open.cx/slack/connect-slack.md#get-handoff-notifications) work the same as on your other channels.

## How replies are sent

* **AI replies** go out as plain text. Formatting such as bold text is removed.
* **Team replies** from the inbox are sent as text. Attachments added to a reply are not delivered on Messenger.
* With **Assist Mode** on for Messenger, the AI's reply stays in the inbox as a suggestion and nothing is sent until a teammate sends it. See [Let the AI draft instead of reply](https://docs.open.cx/safety/autopilot-settings.md#let-the-ai-draft-instead-of-reply).
* If **Facebook Messenger** is turned on in **Settings → CSAT**, the [satisfaction survey](https://docs.open.cx/resources/csat.md) link is sent as a message.

## Troubleshooting

After a failed connection, the Messenger page shows **Connection failed** with an error code.

| Symptom | Likely cause | Fix |
| - | - | - |
| Error code `MISSING_MESSAGING_SCOPE` | Permission to manage the Pages' messages wasn't granted | Click **Add page** again and allow messaging. |
| Error code `NO_PAGES_DETAILS_FOUND` | No Page was selected, or the account manages no Pages | Click **Add page** again and select at least one Page. |
| A Page you selected is missing from **Pages** | Message delivery couldn't be turned on for that Page | Click **Add page** again and select it. For a business-managed Page, use **Retry the connection as a business**. |
| None of the above | — | Contact OpenCX support with the error code and the Page ID. |

***

## Related Documentation

> [card] [Autopilot Settings](https://docs.open.cx/safety/autopilot-settings.md)
>
> Turn AI replies on or off for Messenger.

> [card] [Instagram](https://docs.open.cx/instagram/connect-instagram.md)
>
> Connect your Instagram accounts.

> [card] [Human Handoff](https://docs.open.cx/handoff/introduction.md)
>
> When the AI hands sessions to your team.

> [card] [CSAT Surveys](https://docs.open.cx/resources/csat.md)
>
> Ask for a rating when a session closes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.