# Facebook Messenger

> Connect your Quickchat AI Agent to Facebook Messenger. Link a Facebook Page and your AI Agent replies to Messenger conversations automatically.

This guide shows how to connect your **Quickchat AI Agent** to **Facebook Messenger**. Once a Facebook Page is linked, your AI Agent replies to people who message that Page on Messenger, and every conversation appears in your [Quickchat AI Inbox](https://app.quickchat.ai).

If you get stuck, jump to [Troubleshooting & FAQs](#troubleshooting--faqs) or [contact us](https://quickchat.ai/contact).

## Optional example checks

- [Compare replies per credit budget][public-lab-credit-capacity-both]. Calculate the maximum whole AI replies for each supported model from a supplied credit budget. This does not check your balance or model eligibility.

- [Check plan requirements][public-lab-plan-fit-both]. Compare declared usage, content, team and feature needs with public Quickchat AI plan bundles. This is not a price quote or account check.

## Step 0 - Prerequisites

- A **Facebook Page** for your business. Messenger integrations connect to a Page, not to a personal profile. No Page yet? Use the **Create a Facebook Page** link under **Connect with Facebook** in the Messenger panel.
- A **Page role that covers messages** for the Facebook account you connect with. On facebook.com this is **Settings > Page access**. Full control works, and so does a Meta Business role that includes messaging.

:::caution
Pages owned by a Meta Business are supported. If you reach the Page through a Business role rather than administering it directly, Quickchat AI can still open it, as long as that role covers messages. If Facebook refuses the Page anyway, see [Troubleshooting & FAQs](#troubleshooting--faqs) below.
:::

:::caution
A Facebook Page can be connected to **one AI Agent** at a time. If you manage several Agents, use a separate Page for each.
:::

## Step 1 - Authorize Quickchat AI on Facebook

1. Open the [Quickchat AI App](https://app.quickchat.ai) and go to **External Apps**.
2. Click **Messenger**, then click **Connect with Facebook**.
3. A Facebook pop-up opens. Log in if prompted and **continue as yourself**.
4. **Tick the Page** you want your AI Agent to reply for, and review the requested permissions. If no Page is ticked, Facebook shares none and nothing is connected (see [Troubleshooting & FAQs](#troubleshooting--faqs)).
5. Click **Continue / Confirm** to grant Quickchat AI access.
6. The pop-up closes and returns you to Quickchat AI. While it works, the panel shows **Connecting to Facebook**.

Authorizing does not put your Agent live yet. The Messenger panel now shows a **Finish setup** badge and asks you to confirm the Page.

## Step 2 - Confirm which Page your AI Agent answers on

1. If Facebook returns one Page, the Messenger panel shows **Confirm your Facebook Page**. Check its name and ID, then click **Connect** followed by the Page name, for example **Connect Acme Support**.
2. If Facebook returns several Pages, the panel shows **Choose a Facebook Page**. Check the intended Page's name and ID, then click **Connect this Page** beside it.

**Confirming the Page enables replies immediately.** Finish your Agent's knowledge, instructions and handoff settings before confirming. Nothing goes live before this confirmation.

Two other options are available at this point:

- **Use a different Facebook account** starts the Facebook authorization again, so you can sign in with an account that administers the Page you want.
- **Cancel setup** discards the pending connection. It only appears while no Page is connected, so you cannot lose a working integration this way.

Once you confirm, the panel shows **Connected** with your **Page name** and **Page ID**.

Your AI Agent is now enabled on Messenger. Send a test message to verify the reply.

## Step 3 - Pause or resume replies

Confirming the Page turns **Enable Messenger** on. Use the toggle to switch the integration on or off without disconnecting the Page. When it's on, your AI Agent replies to incoming Messenger messages; when it's off, the Page stays connected but the Agent stops replying.

The toggle stays unavailable until you have confirmed a Page in Step 2.

## Try it out

Open your Page in Messenger (for example via `m.me/<your-page-username>`) and send a message. Your AI Agent replies, and the conversation appears in your [Quickchat AI Inbox](https://app.quickchat.ai), where you can read the full transcript, see the visitor's name, and take over from the AI at any time.

After taking over a conversation in the **Inbox**, use **Attach file or image** to send a **JPEG or PNG image** (up to 5 MB) or a **PDF** (up to 16 MB). Other file types and audio are not supported. Attachments are sent without captions. Any text you've typed stays in the composer; send it separately after the file finishes sending.

## Troubleshooting & FAQs

**The pop-up doesn't open.**

- Disable pop-up and tracker blockers in your browser, refresh the page and try again. If that doesn't help, try a different browser.

**I authorized on Facebook but nothing seems connected.**

- Authorizing is only Step 1. Go back to the Messenger panel and look for the **Finish setup** badge, then confirm your Page as described in Step 2. Your AI Agent starts replying only after you confirm.

**I get "Facebook won't let us open that Page".**

- Facebook refused that specific Page. The account you signed in with does not hold a Page role that covers messages, either directly or through a Meta Business.
- Open the Page on facebook.com, go to **Settings > Page access**, give your account a role that includes managing messages, then connect again.
- If you cannot change that yourself, ask whoever administers the Page to connect it, or [contact us](https://quickchat.ai/contact).

**I get "Your Facebook session ended".**

- Facebook signed you out before the setup finished. Nothing was changed on your Page.
- Start the connection again and stay signed in to Facebook until it completes.

**I get "A Facebook permission wasn't granted".**

- The Facebook login left out one of the permissions Quickchat AI needs to open your Page, usually because it was unticked on Facebook's screen.
- Connect again and keep every requested permission switched on. They are only used to find your Page and reply to its messages.

**I get "We couldn't open that Facebook Page".**

- Facebook would not hand the Page over and did not say why. This is usually worth one retry.
- If it fails again, check under **Settings > Page access** that your account has a role on the Page which covers messages, then connect again.

**I get "No Facebook Page connected" or "Facebook didn't share a Page".**

- Facebook finished the login without sharing a Page. Either no Page was ticked on Facebook's screen, or the account you signed in with does not administer any Page.
- Nothing changes in Quickchat AI. Your current connection stays as it was, and Pages waiting for your confirmation stay listed.
- Try again with **Connect with Facebook**, **Switch page** or **Use a different Facebook account**, whichever the Messenger panel shows, and tick your Page on Facebook's screen. If it is not listed there, sign in with the Facebook account that administers it.
- No Page yet? Use **Create a Facebook Page**, then connect again.

**My AI Agent doesn't reply.**

- Make sure you completed Step 2 and the panel shows the Page as **Connected**, not **Finish setup**.
- Make sure the **Enable Messenger** toggle is on.
- Confirm you connected the intended **Page** and that the correct **AI Agent** is selected.
- One Page connects to one AI Agent. Don't connect the same Page to multiple Agents.

**I connected the wrong Page.**

- Click **Switch page** in the integration panel, sign in on Facebook, and confirm the correct Page in Step 2.

**Does Messenger send a welcome message?**

- Quickchat AI does not send an automatic welcome message on Messenger. The customer starts the conversation by messaging the Page. Changing the website widget's welcome message does not create a Messenger greeting.

## Need Help?

Still stuck? Reach out on [Discord](https://discord.gg/KqkHwvPRNH) or [contact us](https://quickchat.ai/contact) and we'll help you get your Page connected.

[public-lab-credit-capacity-both]: https://app.quickchat.ai/v1/api_core/public-question/quickchat/tools/credit-capacity/lab/both/?placement=docs-messenger-credit-capacity-both-v1

[public-lab-plan-fit-both]: https://app.quickchat.ai/v1/api_core/public-question/quickchat/tools/plan-fit/lab/both/?placement=docs-messenger-plan-fit-both-v1
