Prerequisites
Before you begin, make sure you have:- A valid Facebook account
- A Facebook Page you own or administer (you need “Full Control” or Admin permissions)
- A ChatbotX installation with a publicly accessible URL (required for both the webhook callback and the OAuth callback when connecting your Page)
- Your personal Facebook account logged in on your browser (the account that manages the Page)
- If the page belongs to a Business Manager, sufficient permissions within that Business Manager
If you are developing locally, you need a tunneling tool such as ngrok to expose your local server to the internet.
Step 1: Create a Facebook App
1
Create a new app
Go to the Facebook Developer Portal and click Create App.
2
Enter app details
Enter your App name and contact email, then click Next.
3
Select a use case
When asked for a use case, select Other.
4
Choose app type
For the app type, choose Business.
5
Finish creation
Review your details and click Create App to finish.
6
Get your App ID and App Secret
After creating your app, go to Settings → Basic to find your App ID and App Secret. You will need both values in the next step.
Step 2: Configure Credentials in ChatbotX
A Super Admin must enter the Facebook App credentials in ChatbotX before the integration can work. Complete this step immediately after obtaining your App ID and App Secret.1
Open Integrations
In your ChatbotX installation, navigate to:Then select Messenger.
2
Open the Messenger configuration
Find the Messenger card and click the Edit button to open the configuration modal.
3
Enter your App credentials
Fill in the following fields using the values from the Meta Developer Portal:
4
Save
Click Save. Facebook Messenger will now be available as a channel when creating chatbots.After saving, ChatbotX will display a Webhook URL. Copy and keep this URL — you will need it when configuring the webhook in Step 4.
Step 3: Configure Facebook Login
1
Add the Facebook Login product
From your app dashboard, add the Facebook Login product.
2
Configure Facebook Login settings
In the Facebook Login settings:
- Enable Web OAuth Login
- Enable Login with JavaScript SDK
- Add your self-hosted domain to Allowed Domains for the JavaScript SDK
Step 4: Configure the Facebook App
1
Add your app domain
Under Settings → Basic, add your ChatbotX installation domain as an app domain.
2
Add the Messenger product
From the Products section, add Messenger to your app.
3
Configure the webhook
In the Messenger settings, configure the webhook:
- Callback URL: Use the Webhook URL generated by ChatbotX in Step 2 (for example,
https://app.yourdomain.com/integrations/messenger/callback) - Verify Token: Enter the Webhook Verify Token value you configured in the ChatbotX Integrations settings (Step 2)
4
Create a Messenger chatbot in ChatbotX
In ChatbotX, go to Settings → Channels, find the Messenger icon, and click Add Messenger. The system will redirect you to the Facebook (Meta) authentication interface:
- Click Continue as [Your Name] to grant permissions. If you have previously connected other pages, click Edit Settings to ensure all new or previously unselected pages are visible.
- Select the Facebook Pages you want to connect and click Continue.
- Review the permissions the application is allowed to access and click Save.
- Select the radio button next to the specific Facebook Page you want to use and click Continue.
- Choose whether to sync existing contacts and up to 3 months of conversation history, or start fresh.
- After being redirected back to ChatbotX, confirm the correct page is displayed. Click Test Now to send a test message and confirm your AI Agent is working.
Step 5: Test Before Going to Production
Facebook does not forward page messages to your webhook until your app is approved for production. Use the steps below to test your integration first.1
Connect your Facebook Page
In the Messenger settings inside the Meta Developer Portal, click Connect next to the page you selected for your ChatbotX chatbot.
2
Add subscriptions
On the connected page, click Add subscriptions.
3
Select subscription fields
Subscribe to the following fields and save:
4
Send a test message
Send a test message to your page from your personal Facebook account. It should appear in ChatbotX shortly after.
5
Verify locally (if applicable)
If you are running locally, confirm that requests are arriving at the
/bot endpoint in your ngrok terminal.Going to Production
Before your app can receive messages from real users, Facebook must review and approve it.1
Submit for App Review
Follow the Facebook App Review process to get your app verified.
2
Request advanced access
Request advanced access to the following permissions.Required permissions:
Optional permissions:
API Version
ChatbotX supports Facebook API v25.0. Make sure your app is configured to use this version.- Update the API version under Settings → Advanced in your Facebook app.
- Verify that your webhook subscription version is also set to v25.0 under the app’s Webhooks settings.
FAQ
Why doesn't my Fanpage name appear in the connection list?
Why doesn't my Fanpage name appear in the connection list?
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 4 to start over.
I connected successfully but the AI isn't responding to customers?
I connected successfully but the AI isn't responding to customers?
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 Page has Facebook’s default Instant Replies enabled, as this feature can conflict with ChatbotX.
Does ChatbotX support managing multiple Pages at once?
Does ChatbotX support managing multiple Pages at once?
Yes. ChatbotX is designed as an Omnichannel platform. You can connect multiple Facebook Pages (depending on your plan) and manage all incoming messages in a Unified Inbox.
How does Facebook's 24-hour rule affect the bot?
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.
How do I update permissions when I add a new Page?
How do I update permissions when I add a new Page?
You do not need to disconnect the existing connection. Simply repeat the Add Messenger process. When the Meta window appears, click Edit Settings and check the new Page. The system will automatically update the list without affecting previously connected pages.