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

# How to Connect Facebook Messenger to ChatbotX

> Step-by-step guide to connect your Facebook Page with ChatbotX to automate Messenger conversations and post comments.

Facebook Messenger is one of the most important customer engagement channels today. By connecting your Fanpage to **ChatbotX**, you can use AI Agents to automate customer support, respond 24/7, and manage all conversations in a single unified hub.

## Prerequisites

Before getting started, make sure you have met the following requirements:

1. **Admin access:** You need **"Full Control"** or **Admin** permissions on the Fanpage you want to connect.
2. **Personal Facebook account:** You must use the personal Facebook account that manages the Fanpage, and it must be logged in on your browser.
3. **Meta Business Suite access:** If the page belongs to a Business Manager (BM), your account must also have sufficient permissions within that BM.

## Step 1: Open the Channel Configuration

1. Go to **Settings** → **Channels**.
2. Find the Messenger icon and click the **"Add Messenger"** button.

<Frame>
  <img src="https://mintcdn.com/chatbotx/67F5p4hoKWIOZEKM/images/image-239.png?fit=max&auto=format&n=67F5p4hoKWIOZEKM&q=85&s=687001882034c4beb304b17ec907aad2" alt="chatbotx_navigate_to_facebook_channel_setup" width="3019" height="1359" data-path="images/image-239.png" />
</Frame>

## Step 2: Grant Access Permissions

The system will redirect you to the Facebook (Meta) authentication interface.

1. Click the **"Continue as \[Your Name]"** button to grant permissions.
   > **Important:** If you have previously connected other pages, click **Edit Settings** to ensure all new or previously unselected pages are visible.

<Frame>
  <img src="https://mintcdn.com/chatbotx/67F5p4hoKWIOZEKM/images/image-240.png?fit=max&auto=format&n=67F5p4hoKWIOZEKM&q=85&s=bdabbfe154586885f5f85ea4db944e47" alt="meta_facebook_authentication_popup_step" width="1482" height="1814" data-path="images/image-240.png" />
</Frame>

## Step 3: Select Facebook Fanpages

A list of all Fanpages you manage will appear.

1. Check the Fanpages you want to connect to **ChatbotX**, or select **All**.
2. Click **Continue** to proceed to the permission settings.

<Frame>
  <img src="https://mintcdn.com/chatbotx/yiWT9ZnID5SHGklx/images/image-236.png?fit=max&auto=format&n=yiWT9ZnID5SHGklx&q=85&s=cc03db1a0815a382ab39a4cf43be669b" alt="select_facebook_fanpages_for_chatbotx_integration" width="1110" height="1389" data-path="images/image-236.png" />
</Frame>

## Step 4: Review Permissions

This is the final step.

1. Review the permissions the application is allowed to access.
2. Once verified, click the **Save** button in the bottom right corner.

<Frame>
  <img src="https://mintcdn.com/chatbotx/67F5p4hoKWIOZEKM/images/image-241.png?fit=max&auto=format&n=67F5p4hoKWIOZEKM&q=85&s=a27da326e59cd7ee14ff4ba2c9a7f663" alt="granting_meta_permissions_for_messenger_bot" width="1449" height="1812" data-path="images/image-241.png" />
</Frame>

## Step 5: Select a Facebook Page

Confirm the exact Fanpage you want to link to the platform.

* Select the radio button next to the Facebook Page you want to use, e.g., **ChatbotX Demo**.
* Click the **Continue** button to complete the connection.

<Frame>
  <img src="https://mintcdn.com/chatbotx/yiWT9ZnID5SHGklx/images/image-238.png?fit=max&auto=format&n=yiWT9ZnID5SHGklx&q=85&s=9d201e5138afe1f80b46cf46402db969" alt="selecting_facebook_page_to_connect" width="1089" height="439" data-path="images/image-238.png" />
</Frame>

## Step 6: Sync Contacts and Chat History (Optional)

After clicking continue from the page selection, a dialog will appear asking if you want to sync existing contacts and chat history.

* **Enable sync:** Allow ChatbotX to import existing Messenger contacts and up to 3 months of conversation history from this Page.
  * *Note:* This sync process for large Fanpages may take several hours to complete.
* **Don't sync:** Skip importing old data and start fresh with new customer interactions.

<Frame>
  <img src="https://mintcdn.com/chatbotx/vAbVpFL_ZF5D0bbF/images/chatbotx_channels_messenger_sync_history.png?fit=max&auto=format&n=vAbVpFL_ZF5D0bbF&q=85&s=0d8eb2ae2a893ed90381f1ec754a8359" alt="Chatbotx Channels Messenger Sync History" width="2096" height="1295" data-path="images/chatbotx_channels_messenger_sync_history.png" />
</Frame>

## Step 7: Finalize and Verify

After being redirected back to the system, your Facebook Page will appear on the **ChatbotX** dashboard.

* **Confirm connection:** Ensure the correct Fanpage is displayed with the Messenger icon.
* **Test integration:** Click **Test Now** to send a test message and confirm your AI Agent is working.

<Frame>
  <img src="https://mintcdn.com/chatbotx/HymWStvnUgfau97Q/images/connect_messenger_dashboard_check.png?fit=max&auto=format&n=HymWStvnUgfau97Q&q=85&s=cc838b6a657701fe9a6902c11245492a" alt="Connect Messenger Dashboard Check" width="3080" height="1527" data-path="images/connect_messenger_dashboard_check.png" />
</Frame>

## Step 8: Test Automation

Your page is now connected. You can test it using one of the following methods:

* **Option 1: Create a Flow**
  * Go to the **Flows** section in the sidebar.
  * Create a simple welcome message or an interactive menu.
  * Trigger it from Fanpage Messenger to verify the response.
* **Option 2: Set up an AI Agent**
  * Go to the **AI Agent** tab to configure your agent's personality.
  * After saving, use the **Test Now** button on the dashboard to chat directly with the AI.

## FAQ

<AccordionGroup>
  <Accordion title="Why doesn't my Fanpage name appear in the connection list?" iconType="solid">
    There are two common causes:

    **Access permissions**\
    You may only have an *Editor* or *Moderator* role. Meta requires **Admin** permissions to set up the API.

    **Missing app permissions**\
    You may have previously connected ChatbotX but did not select this specific page during that permission grant.

    **How to fix**\
    Go to your personal Facebook profile → **Settings & Privacy** → **Settings** → **Business Integrations**.\
    Find **ChatbotX**, click **Remove**, then go back to Step 1 to start over.
  </Accordion>

  <Accordion title="I connected successfully but the AI isn't responding to customers?">
    Check the following:

    **AI Agent configuration**\
    Make sure you have assigned an **AI Agent** to this Messenger channel in the **AI Agent Settings**.

    **Facebook Auto-Replies**\
    Check if the Fanpage has Facebook's default **Instant Replies** enabled, as this feature can conflict with ChatbotX.
  </Accordion>

  <Accordion title="Does ChatbotX support managing multiple Fanpages at once?">
    Yes. ChatbotX is designed as an **Omnichannel** platform.

    You can connect multiple Fanpages, depending on your plan, and manage all incoming messages in a **Unified Inbox**.
  </Accordion>

  <Accordion title="How does Facebook's 24-hour rule affect the bot?">
    According to Meta's policy, bots are only allowed to respond to customers **within 24 hours of the customer's most recent message**.

    After 24 hours, you must use:

    * **Message Tags**, or
    * **Marketing Messages on Messenger**

    to continue the conversation.
  </Accordion>

  <Accordion title="How do I update permissions when I add a new Fanpage?">
    You don't need to disconnect the existing connection.

    Simply repeat the **Add Facebook Page** process.\
    When the Meta window appears, click **Edit Settings** and check the new Fanpage.

    The system will automatically update the list without affecting previously connected pages.
  </Accordion>
</AccordionGroup>