Skip to main content

How to Connect Your Facebook Messenger to LenoChat

April 15, 2026

Receive and reply to Facebook Messenger messages directly in LenoChat — alongside all your other channels.

What is Facebook Messenger Integration?

The Facebook Messenger integration connects your Facebook Business page to LenoChat so that every message sent to your page via Facebook Messenger appears as a conversation inside your LenoChat inbox. Your team can reply from LenoChat, and the response reaches the visitor in Messenger — the visitor never needs to leave Facebook. Leno AI can also handle incoming Facebook messages automatically, classifying visitor intent, delivering answers from your knowledge base, and escalating to a human agent when needed. This makes Facebook Messenger a fully supported channel alongside your website chat widget, Instagram DMs, and WhatsApp, all managed from a single dashboard.

Before You Begin: Requirements

Facebook Messenger integration requires a Facebook Business page, not a personal profile. Before starting the connection, make sure you meet all of the following requirements. Attempting the connection without these in place will result in an error or incomplete integration.

  • A Facebook Business page that your brand or company owns — personal profiles cannot be connected to LenoChat.
  • Admin access to the Facebook page — only page admins can grant the permissions required for LenoChat to receive and send messages on your behalf.
  • A LenoChat account with access to Integrations settings — any workspace member who can modify settings can complete the connection.
  • Your Facebook account must be logged in on the same browser session where you complete the OAuth flow — the connection dialog opens in a pop-up and uses your active Facebook session.
Tip: If you manage multiple Facebook pages, you can connect all of them to the same LenoChat workspace in a single OAuth flow. During the page selection step, simply select every page you want to link. Each connected page becomes an independent channel inside LenoChat.

Step 1–3: Open Integrations and Click Connect

All channel integrations in LenoChat are managed from the Integrations panel in your workspace settings. Start there to initiate the Facebook connection. A pop-up window will open, beginning the Facebook OAuth authorisation flow — make sure your browser allows pop-ups from your LenoChat dashboard domain before proceeding.

  • Step 1: Log in to your LenoChat dashboard and click Settings in the left-hand navigation sidebar.
  • Step 2: Select Integrations from the settings menu. The Integrations panel lists every available channel — including Facebook Messenger, Instagram, and WhatsApp — each with a Connect or Configure button.
  • Step 3: Locate the Facebook Messenger card and click Connect. A pop-up window opens, beginning the Facebook OAuth authorisation flow.
LenoChat Integrations settings panel showing available channel connection options including Facebook Messenger

Step 3: Log In to Facebook Business

After clicking Connect, a pop-up dialog appears asking you to log in to Facebook. This is Facebook's own OAuth login screen — LenoChat never sees or stores your Facebook password. You are authorising LenoChat as an app through Facebook's official permissions framework. The connection is secured end-to-end by Facebook's authentication infrastructure.

  • Step 4: In the pop-up, enter the email address and password associated with the Facebook account that is an admin of the page you want to connect.
  • Step 5: Click Log In. If you are already logged into Facebook in the same browser, this step is skipped and you proceed automatically to the page selection screen.
  • Step 6: If your Facebook account has two-factor authentication enabled, complete the 2FA challenge as prompted. LenoChat does not interact with this step — it is handled entirely by Facebook.
Facebook business login screen displayed in a pop-up window during the LenoChat Facebook Messenger connection flow

Steps 4–6: Select and Confirm Your Facebook Pages

After logging in, Facebook shows a list of all pages you have admin access to. You must select the pages you want to connect to LenoChat. Only selected pages will receive the integration — unselected pages remain completely unaffected and will not be connected.

  • Step 7: Review the list of your Facebook pages displayed in the dialog. Each page appears with a checkbox on the left.
  • Step 8: Click the checkbox next to each page you want to connect to LenoChat. You can select multiple pages at once — each will become a separate channel inside LenoChat after the flow completes.
  • Step 9: Click Confirm to proceed with the selected pages. If you change your mind, click Back to return to the previous screen and deselect any pages.
  • Note: If no pages appear in the list, verify that the Facebook account you logged in with has admin access to at least one Facebook Business page. Editor and Analyst roles are not sufficient — full Admin status is required.
Facebook page selection screen in the LenoChat OAuth flow showing checkboxes for selecting Business pages to connect

Step 7: Grant LenoChat the Required Permissions

After selecting your pages, Facebook presents the specific permissions that LenoChat is requesting. These permissions are the minimum required for LenoChat to receive and send messages on your behalf. Review the list carefully — LenoChat requests read and write access to Messenger messages only and does not request access to your personal profile, friends list, or ad account.

  • pages_show_list — allows LenoChat to read the list of pages you manage so it can display them during setup.
  • pages_messaging — allows LenoChat to send and receive Messenger messages on your connected Facebook page.
  • pages_manage_metadata — allows LenoChat to subscribe to webhook events so messages are delivered in real time.
  • business_management — allows LenoChat to verify your business page association during the OAuth handshake.
  • Step 10: Click Continue to grant these permissions. If you do not grant all permissions, the integration will be incomplete and messages will not be delivered to LenoChat.
Facebook permissions screen during LenoChat OAuth setup listing the access scopes required for Messenger integration

Step 8: Authorize LenoChat Business Access

The final authorisation screen confirms that you are allowing LenoChat, as a verified business application, to access the selected pages and their messaging capabilities. This step completes the OAuth handshake between Facebook and LenoChat. LenoChat exchanges Facebook's authorisation code for a long-lived page access token (valid for up to 60 days), which is stored securely and used to authenticate all future message requests.

  • Step 11: Review the summary of what LenoChat will have access to — your connected page names and their associated Messenger inboxes.
  • Step 12: Click Authorize to complete the connection. A secure authorisation code is sent from Facebook to LenoChat, which is exchanged for a long-lived page access token.
  • Step 13: The pop-up will close automatically once authorisation is complete and return you to your LenoChat dashboard.
LenoChat authorization confirmation screen showing the final approval step for Facebook business access during Messenger integration setup

Step 9: Connection Confirmed

Once authorisation is complete, LenoChat shows a success confirmation dialog. This screen confirms that your Facebook pages have been linked successfully and that messages will start flowing into LenoChat immediately. From this moment, any message sent to your Facebook Business page via Messenger will appear as a new conversation in your LenoChat inbox within seconds.

  • The confirmation screen lists the names of all Facebook pages that were successfully connected. Pages that could not be connected — for example, because the webhook subscription failed — are displayed separately with an error note.
  • Click Done or close the dialog to return to the Integrations panel, where your connected pages now appear with a Connected status badge.
  • Test the integration by sending a message to your Facebook page from another account — it should appear as a new conversation in your LenoChat inbox within a few seconds.
LenoChat success confirmation dialog confirming that Facebook Messenger pages have been successfully connected to the workspace

Step 10: Your Connected Pages in LenoChat

After completing the OAuth flow, your connected Facebook pages appear in the Integrations panel. Each page is listed with its name and a Connected status badge. From here you can manage which pages are active, toggle their visibility, or initiate disconnection at any time.

  • Each connected page displays the page name as it appears on Facebook and a green Connected badge confirming the webhook subscription is active and messages are being received.
  • To temporarily disable a page without disconnecting it fully, toggle the visibility switch next to the page. When toggled off, incoming Messenger messages from that page are still received by LenoChat but are paused — they will not be assigned to agents or Leno AI until you toggle the page back on.
  • To permanently disconnect a page, click the Disconnect button next to the page entry. LenoChat immediately unsubscribes from Facebook's webhook for that page and removes the stored page access token. Messages sent after disconnection will not be received.
LenoChat Integrations panel showing a successfully connected Facebook page with a green Connected status badge and management options

How Facebook Messages Flow into LenoChat

Once connected, every message sent to your Facebook page via Messenger is delivered to LenoChat in real time via a Facebook webhook. Understanding how messages flow through the system helps you configure your workspace for the best customer experience.

  • When a visitor sends a message on Facebook Messenger, Facebook immediately calls the LenoChat webhook with the message content and sender information — including the visitor's first name, last name, and profile photo pulled from their Facebook profile.
  • LenoChat creates a new conversation (or continues an existing one) identified by the visitor's Facebook Page-Scoped ID (PSID). Each Facebook user has a unique PSID per connected page, so LenoChat maintains complete conversation history across multiple sessions with the same visitor.
  • If Leno AI is enabled for your workspace, the incoming Messenger message is automatically assigned to your AI agent. Leno AI reads the message, searches your knowledge base, and sends a reply — the response is delivered back to the visitor in Facebook Messenger within seconds.
  • If Leno AI is not enabled or the visitor explicitly requests a human agent, the conversation is placed in the Unassigned queue and your agents are notified. Agents can claim the conversation and reply directly from the LenoChat inbox — all replies are delivered to the visitor's Messenger thread.
  • Supported message types include text messages, images, and file attachments. Unsupported message types (such as Reels, video clips, and Stories replies) are flagged in the conversation with a system notification so agents are aware they exist, even though they cannot be rendered inside LenoChat.
Tip: Enable Leno AI for your Facebook Messenger channel to handle after-hours enquiries automatically. When your team is offline, Leno AI continues answering visitor questions from your knowledge base and collecting contact details, ensuring no Facebook message goes unanswered regardless of your business hours.

Managing Connected Facebook Pages

You can manage all connected Facebook pages from the Integrations panel at any time. LenoChat provides per-page visibility controls and a straightforward disconnection process that cleanly removes all stored tokens and webhook subscriptions.

  • To add more Facebook pages after the initial connection, click Connect Facebook again in the Integrations panel and complete the OAuth flow — existing connected pages are unaffected and will not need to be reconnected.
  • Each connected page can be toggled on or off independently. Pages that are toggled off remain connected to LenoChat's webhook but messages are held in a paused state — they can be re-enabled at any time without repeating the OAuth flow.
  • To disconnect a page permanently, click Disconnect next to the page. LenoChat calls the Facebook Graph API to remove the webhook subscription and deletes the stored page access token from its database. To reconnect the page in the future, you must complete the full OAuth flow again.
  • If your page access token expires or is invalidated — for example, because you changed your Facebook password or revoked the app via Facebook Settings — the integration will stop receiving messages. The Integrations panel will show a Disconnected or Error status. Click Reconnect and repeat the OAuth flow to generate a fresh long-lived token.

Common Issues & Solutions

The Facebook pop-up opens but no pages appear in the page selection list

This happens when the Facebook account you logged in with is not a full Admin of any Facebook Business page. Only the Page Admin role grants the permissions required for the integration — Editor, Analyst, and Moderator roles cannot complete it. Log in to Facebook as the account with Admin access to the page, then retry the connection from Settings → Integrations.

Connection fails with a permissions error after clicking Authorize

If you declined any of the required permissions during the OAuth flow, LenoChat cannot complete the integration. Return to Settings → Integrations, click Connect Facebook again, and this time ensure you grant all listed permissions — particularly pages_messaging and pages_manage_metadata, which are mandatory. If the error persists, remove LenoChat from your Facebook App Settings (facebook.com/settings → Apps and Websites) and retry the OAuth flow from scratch.

My connected Facebook page shows a Disconnected or Error status after working correctly

This typically means the stored page access token has been invalidated. Common causes include changing your Facebook account password, revoking LenoChat's access via Facebook Settings, or extended periods of inactivity causing token expiry. To restore the integration, click Reconnect next to the disconnected page in Settings → Integrations and complete the OAuth flow again to generate a fresh long-lived token.

Facebook messages arrive in LenoChat but my replies are not delivered to the visitor

Outbound message delivery failures are usually caused by an expired or revoked page access token. Check the Integrations panel for any error badge on the connected page. If the page shows an error status, reconnect via the OAuth flow to refresh the token. Also verify that your Facebook page's messaging settings have not been restricted or disabled at the page level — open your Facebook page, go to Settings → Messaging, and ensure the messaging feature is active.

I completed the OAuth flow but the page does not appear in the Integrations panel

If the OAuth flow completes but no page appears in the Integrations panel, the webhook subscription may have failed silently. Wait 30 seconds and refresh the Integrations page. If the page still does not appear, disconnect all Facebook connections via Settings → Integrations and retry from the beginning. Verify that your Facebook page is published and not in restricted mode — unpublished and age-restricted pages cannot accept webhook subscriptions from third-party apps.

Frequently Asked Questions

Do I need a Facebook Business Manager account to connect Facebook Messenger to LenoChat?

No. You only need a Facebook Business page (not a personal profile) and admin access to that page. A full Facebook Business Manager or Meta Business Suite account is not required. If you have a regular Facebook Business page where you are listed as an Admin, you can complete the integration without any additional Meta business tools.

Can I connect multiple Facebook pages to the same LenoChat workspace?

Yes. During the OAuth flow, you can select multiple pages at once and all selected pages will be connected simultaneously. You can also run the OAuth flow again after the initial connection to add more pages — existing connected pages are unaffected. Each connected page appears as a separate channel in your LenoChat inbox and can be individually managed.

Does connecting Facebook Messenger also connect my Instagram account?

Potentially yes. If your Facebook Business page has a linked Instagram Business account, LenoChat can detect this during the same OAuth flow and offer to connect your Instagram direct messages as well. This is optional — you can choose to connect only Facebook and handle Instagram separately, or connect both simultaneously. Instagram messages would then appear as a separate channel in LenoChat.

Can Leno AI respond automatically to Facebook Messenger messages?

Yes. If Leno AI is enabled in your workspace, it handles incoming Facebook Messenger messages the same way it handles website chat conversations — reading each message, searching your knowledge base, and sending a reply. Leno AI also detects when a visitor wants to speak with a human agent and performs the handoff automatically. No additional configuration is required to enable AI on the Facebook channel once the page is connected.

What happens to Facebook messages when my team is offline?

If Leno AI is enabled, it continues handling Facebook Messenger conversations 24 hours a day, regardless of your team's availability. If Leno AI is not configured and your team is offline based on your Chat Hours settings, new Facebook messages are placed in the Unassigned queue and agents are notified by email if notifications are enabled. No message is lost — conversations accumulate and your team can respond when they come back online.

Is there a limit to how many Facebook pages I can connect?

LenoChat does not impose a hard limit on the number of Facebook pages you can connect to a single workspace. You can connect all Facebook Business pages where you have admin access. Keep in mind that each connected page generates its own conversation stream in your inbox — connecting many low-traffic pages may add noise if your team receives few messages from them.

How do I test that my Facebook integration is working after setup?

The easiest way to test the integration is to open Facebook Messenger on a personal account and send a test message to your connected Facebook Business page. The message should appear as a new conversation in your LenoChat inbox within a few seconds. If the message does not arrive within 30 seconds, check the Integrations panel for any error status on the connected page and refer to the Common Issues section above.