# Facebook Messenger
To configure the Messenger connector, you must access the [Facebook for Developers console](https://developers.facebook.com/) and have access to Syntphony CAI’s MySQL database. Then, execute the following steps.
**1. Create your Facebook App**
In the Facebook for Developers console, create a new App or use an existing one of your choice.
**2. Add Messenger configuration**
In the App Home, click on the Set Up button in the Messenger box.
If this box does not appear to you, click on the plus button besides the PRODUCTS label in the left menu.
**3. Get your Facebook Page ID and Name**
In Facebook, access the page in which you want to enable the messenger chat and copy the Page ID and Page Name. This information will be used in the next step.
The Page ID can be found in the URL after you access your page. For example:
The Page ID above is 105498651278284.
The Page Name is the same that appears on the screen.
**4. Select the channel and configure a token in Syntphony CAI**
Open your virtual's agent channels menu, and find the channel you want to integrate with. This channel's UUID will be listed there. This will be used it in the next SQL command.
Choose a security token. This can be any sentence to be used on both Syntphony CAI and Facebook to check that your Facebook Developer App and Syntphony CAI instance are yours. For example, a token could be simply “syntphony-facebook-security-token”.
Now, execute the following command replacing the values:
```
insert into
facebook_configuration (page_id, page_name, hub_token, page_access_token, channel_uuid)
values
(
< PAGE_ID > , ',' < TOKEN > ','', < CHANNEL_UUID >
)
;
```
**5. Configure Webhook**
On Facebook for Developers console, go to the Messenger > Settings menu (if you clicked on the “Set Up” button before, you should be on this page already) and click on the “Add Callback URL” in the Webhooks box.
| URL field | Value |
| ----------- | ------------------------------------------------------------------------------------------------------------- |
| orgUUID | Your organization's UUID, found on your Virtual Agent's URL. |
| envUUID | UUID of the environment your bot is in, found on your Virtual Agent's URL. |
| botUUID | UUID of the bot your channel is in, found on your Virtual Agent's URL. |
| channelUUID | UUID of the channel to be used by facebook, found in your channel list within your Virtual Agent's left menu. |
{% hint style="warning" %}
**DEPRECATED:** The following URL still works but is deprecated and will be removed in a future release:
https\://\[YOUR\_SERVICE].eva.bot/eva-facebook/org/{orgUuid}/env/{envUuid}/bot/{botUuid}/fb/webhook
\
**New URL**: https\://\[YOUR\_SERVICE].eva.bot/eva-facebook/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/channel/{channelUUID}/v1/conversations
{% endhint %}
In the Verify Token field, put the same token created before and click on the Verify and Save button.
The callback URL must match the most recent standard of https://[YOUR_SERVICE].eva.bot/eva-facebook/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/channel/{channelUUID}/v1/conversations
This step configures how Facebook will call Syntphony CAI.
**6. Select a Facebook Page**
In the Webhooks box, click the Add or Remove Pages button and select which page you want to use. You will have to give the Facebook for Developers permission to access your account for this step to work.
A table will appear with the columns Pages and Webhooks. Click on the Add Subscriptions button and select the messages and messages\_postbacks options.
Save it.
On the Access Tokens box, click the Generate Token button for your page and copy the token, it will be used to update the facebook\_configuration table.
**7. Configure the page token in Syntphony CAI**
The final step for configuring the integration is to update the database with the page token. Execute the command below in your MySQL database replacing the page token and page id.
```
update
facebook_configuration
set
page_access_token = ''
where
channel_uuid= '';
```
**8. Test it!**
To test your virtual agent, enable the chat button in the Facebook Page by clicking the “Add button” on the top right and select the “Send message” option. You are now ready to test your virtual agent.
{% hint style="warning" %}
**Important:**
**This manual shows how to integrate a virtual agent with Facebook in development mode. This will not make it available to all Facebook users. To set a virtual agent to production mode, you still have to follow Facebook compliance rules and submit it for evaluation.**
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs-conversational-ai.syntphony.com/channels/add-a-channel/facebook-messenger.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.