Botpress Cloud: Messaging Channels
Requirements
You will need a Meta app and a WhatsApp Business Account to connect your bot to WhatsApp
Create a Meta App & Business Account
To create a Meta App, log in to your Meta account and follow Step (1) & Step (2) in this article.
Before going to Step (3), we will configure the WhatsApp channel on Botpress.
Channel Configuration
To add WhatsApp integration configuration, go to your bot’s configuration screen, then go to the channel tab, and click on WhatsApp.
A screen will pop up asking for the following details:
1. Verify Token
The Verify Token is used by Meta to verify that you are the real owner of the provided webhook.
You can generate any random alphanumeric string for this configuration. Paste it in your Verify Token channel configuration.
2. Access Token
The Phone Number ID and Access Token are used to send and receive messages to/from the WhatsApp API.
In your Meta App:
- In the left sidebar, expand the WhatsApp menu and select Getting Started
- In the Temporary access token section, click Copy and then paste it in the Access Token field in Botpress
For a permanent Access Token: https://developers.facebook.com/blog/post/2022/12/05/auth-tokens/
3. Phone Number ID
In your Meta App:
- In the left sidebar, expand the WhatsApp menu and select Getting Started
- In the Send and receive messages section, beside the label Phone Number ID click Copy then paste it in the Phone Number ID field in Botpress
Finalizing Channel Configuration
The next step is to Enable the channel from the top of the screen and then copy the webhook URL from the button below the webhook URL.
In the last step, click Save.
Now we can go back to Step (3) & Step (4) in this article.
Webhook Fields
We need to subscribe to the webhook fields below
- Messages: For the chat to work properly, you need to subscribe to the messages webhook field.
Content Types Mapping
From Botpress to WhatsApp
- Text is mapped to Text Object
- Text with Markdown is mapped to Text Object
- Image is mapped to Media Image Object
- Audio is mapped to Media Audio Object
- Video is mapped to Media Video Object
- File is mapped to Media File Object
- Location is mapped to Location Object
- Carousel is mapped to Interactive List Object
- Card is mapped to Interactive List Object
- Dropdown is mapped to Interactive List Object
- Choice is mapped to Interactive Button Object
From WhatsApp to Botpress
- Text is mapped to Text Object
- Interactive feedbacks are mapped to Text Object.
- The rest of the types are not currently processed by Botpress