| Active with remarks |
|---|
| This application needs additional settings. Please follow the documentation below to create your own connectionUnique, active service acces point to a network. There are different types of connections (API key, Oauth…).. |
How to create a bot and connect it to Facebook Messenger and Boost.spaceCentralization and synchronization platform, where you can organize and manage your data. IntegratorPart of the Boost.space system, where you can create your connections and automate your processes.
The Facebook Messenger app supports a connection of a bot that can then be used to receive and send messages on behalf of a designated page that belongs to the bot.
The following steps are necessary for the correct setup.
- Log into Facebook, navigate to Facebook developer portal and click the Add a New App button to create a new app.
- Once you create the app, you will be shown the Product Setup page. Select Messenger and click Set up.
- Scroll down until you see the WebhooksA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers. section. Click on Add Callback URL button. You will be prompted to fill in an Edit Callback URL dialog. The required values can be generated through Boost.space Integrator.
- Open a new tab and log into your Boost.space Integrator account and create a new scenarioA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive..Add the moduleThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) Facebook messenger > Watch messages as the first module to your scenario. Click the Add button to create a new webhookA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers..
Enter a webhook name and a verification tokenThe API token is a multi-digit code that allows a user to authenticate with cloud applications. of your choice into the respective field. You will need this verification token later. Click the Save button.
- Clicking the save button will generate an URL of the webhook. Copy this URL to your clipboard.
- Go back to the Edit Callback URL dialog. In the Callback URL field enter the URL from your clipboard and in the Verify token field enter the same token that you entered in step 4. Click Verify and Save to save the dialog.
- Select and grant access to the page you want to use with the Facebook bot and select permissions the app should be granted for that page.
- – Click the Add or Remove Pages button.
- – Grant access to the selected page.
- – Click the Add Subscriptions button and add messages and messages_postbacks subscription fields.
- Now you have to generate an access token for the bot. Go to the Access Tokens section (just above the Webhooks section) and generate a token for the desired page by clicking the Generate Token button next to the corresponding page.
- – Check the I understand checkbox and copy the token to the clipboard.
- To create a connection between Boost.space Integrator and Facebook messenger, go to the settings of the Send a message module and click the Add button. Enter the access token from the previous step into the respective field and click Continue.
- Map the Sender ID to the ID field and specify the Message Content in the Send a message module.
- Set up the Send a message module and run the scenario to test your bot.
To test the bot application you need to:
- Set up test developer role
- Run the scenario
- Send a test message to the test page (created by the app administrator) when logged in as a test developer to triggerEvery scenario has a trigger, an event that starts your scenario. A scenario must have a trigger. There can only be one trigger for each scenario. When you create a new scenario, the first module you choose is your trigger for that scenario. Create a trigger by clicking on the empty module of a newly created scenario or moving the... the Watch messages module in your scenario.
In order to test your application before publishing it, you need to set up roles for developers who will test it. For non-developer accounts, the app does not respond until it is officially released.
You need two Facebook accounts to test the app:
The First account that creates the app (bot) and is the ownerCan manage members, managers and owners of a specific space. Can view and manage items. Can edit settings of a given space. of the Facebook page.
Navigate to Roles > Add Developers button and add the developer that can test your Facebook Messenger bot.
![[Caution]](https://docs.boost.space/wp-content/uploads/2022/11/caution.png) |
Caution |
|---|---|
| To add someone you aren’t friends with on Facebook, enter their fbid or username. |
Second account that is set up as verified Facebook developer account (How do I verify my developer account on Facebook?) and sends the test message to the Facebook page.
Log in with your second developer (test) account and confirm the request on the https://developers.facebook.com/requests page.
After the test developer account is set, run your Boost.space Integrator scenario, login to Facebook (with your test developer account credentials), and open the public page you want to test the bot with.
Send the message (
) to the page to test your bot.
Conditions that have to be met while testing:
- The Facebook account you write a message to the Facebook page must be set as the developer of the app.
- The bot cannot send the message first (anti-spam policy). The conversation must be initiated by the app test userCan use the system on a limited basis based on the rights assigned by the admin. with the developer role, your second account.
For more information on how to set up the roles, see the official Facebook documentation.