Facebook Messenger

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.

If you get stuck, jump to Troubleshooting & FAQs or contact us.

Optional example checks

• Compare replies per credit budget. 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. 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 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 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).
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, 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.

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 or contact us and we’ll help you get your Page connected.