> ## Documentation Index
> Fetch the complete documentation index at: https://sitegpt.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Facebook Messenger integration
> Connect your SiteGPT chatbot to Facebook Messenger
The Facebook Messenger integration allows your SiteGPT chatbot to live within Facebook Messenger, enabling customers to interact with your chatbot directly through your Facebook Page.
## Prerequisites
* An active SiteGPT chatbot
* A Facebook Page with admin access
* A Facebook Developer account
## Setting up the integration
### Step 1: Start the integration in SiteGPT
1. Go to your chatbot dashboard in SiteGPT
2. Navigate to **Integrations**
3. Find **Facebook Messenger** and click **Get Started**
4. You'll see fields for connecting with Messenger and entering an access token - keep this page open
### Step 2: Create a Facebook app
1. Go to [developers.facebook.com](https://developers.facebook.com)
2. Log in with your Facebook account
3. Scroll down and click on **Messenger Platform**
4. Click **My Apps** in the top right corner
5. Click **Create App**
6. Select **Other** as the app type
7. Select **Business** (or **None** based on your preference)
8. Enter an app contact email
9. Give your app a name (e.g., "My Business Bot")
10. Click **Create App**
### Step 3: Configure Messenger
1. After creating the app, scroll down to find **Messenger**
2. Click **Add or Remove Pages**
3. Select the Facebook Page you want to connect
4. Click **Continue** and then **Save**
If you don't have a Facebook Page yet, you can create one before proceeding with this step.
### Step 4: Generate access token
1. In the Messenger settings, click **Generate Token**
2. Click **I Understand**
3. Copy the generated access token
4. Click **Done**
5. Go back to your SiteGPT integration page
6. Paste the access token into the **Access Token** field
7. Click **Connect**
### Step 5: Configure callback URL
1. After connecting, SiteGPT will provide you with a **Callback URL** and **Verify Token**
2. Copy the Callback URL
3. Go back to your Facebook app settings
4. Click **Add Callback URL**
5. Paste the Callback URL
6. Copy and paste the Verify Token from SiteGPT
7. Click **Verify and Save**
### Step 6: Add subscriptions
1. Scroll down in the Messenger settings
2. Click **Add Subscriptions**
3. Select the following options:
* **messages**
* **messaging\_postbacks**
* **messaging\_optins**
* **message\_echoes**
4. Click **Save**
### Step 7: Configure app roles
1. Click on **App Roles** (or **Roles**) in the left sidebar
2. Note: In development mode, your app can only request data from users with an app role
3. As an admin, you'll be able to interact with the chatbot immediately
4. To make the chatbot available to all users, you'll need to set the app to live mode later
Until you set your app to live mode, only users with an app role (admins, developers, testers) will be able to interact with your chatbot.
## Testing your chatbot
1. Go to your Facebook Page
2. Click **Message** to open Messenger
3. Send a test message to your chatbot
4. The chatbot will respond just like it does on your website
### Features available in Messenger
* **AI responses**: Your chatbot answers questions based on your training data
* **Conversation starters**: Initial quick prompts appear for users
* **Follow-up prompts**: Users can select suggested follow-up questions
* **Conversation escalation**: Users can request to talk to a human
* **Ratings**: Users can give thumbs up/down feedback on responses
* **Restart conversation**: Users can restart the chat using the menu (three-line icon)
## Managing conversations
### View chat history
All Messenger conversations appear in your SiteGPT dashboard under **Chat History**, just like conversations from your website chatbot.
### Respond manually
You can respond to conversations manually from two places:
1. **SiteGPT dashboard**: View and respond in the Chat History section
2. **Meta Business Suite**: Go to [business.facebook.com](https://business.facebook.com) to access your inbox and reply to inquiries
Messages you send manually will be delivered to the user and stored in the chat history. The sender will show as "Agent/Bot" in the conversation.
## Going live
To make your chatbot available to all Facebook users (not just app role members):
1. Go to your Facebook app settings
2. Switch your app from **Development Mode** to **Live Mode**
3. Follow Facebook's app review process if required
## Best practices
* Test thoroughly with admin accounts before going live
* Set clear expectations in your welcome message about chatbot capabilities
* Enable conversation escalation for complex inquiries
* Monitor chat history regularly to improve your chatbot's responses
* Keep your training data up to date for accurate responses
## Troubleshooting
* Verify the access token is correct
* Check that all required subscriptions are enabled
* Ensure the callback URL is properly configured
* Confirm your app has the necessary permissions
Your app is still in development mode. Switch to live mode to make it available to all users.
* Verify the webhook subscriptions include message\_echoes
* Check that the verify token matches between Facebook and SiteGPT
* Ensure the callback URL is correctly configured
## Next steps
Capture leads from Messenger conversations
Set up conversation escalation
Monitor and manage conversations
Customize chatbot responses