After setup is complete, your business will undergo a verification process by Meta, the parent company of WhatsApp. This verification confirms the identity and eligibility of your business to use Meta’s platforms.
For advanced use cases, you can use your own Meta app with our integration.
In Botpress Studio, select Explore Hub in the upper-right corner.
Search for the WhatsApp integration, then select Install Integration.
In the Configuration menu, open the drop-down menu and select Manual Configuration.
2
Configure the integration
To configure the integration, you need to create a webhook endpoint for the WhatsApp integration. To do this, fill in the integration’s configuration fields:
Verify Token
Used by Meta to verify that you’re the real owner of the provided webhook. Can be any alphanumeric string.
Access Token
In your Meta App’s left sidebar, expand the WhatsApp menu and select API Setup.
In the Access Token section, select Generate access token.
Follow the instructions in the popup, then copy your access token.
Client Secret
In your Meta App’s left sidebar, expand the App Settings menu and select Basic.
In the App Secret field, select Show, then copy your secret.
Default Bot Phone Number ID
In your Meta App’s left sidebar, expand the WhatsApp menu and select API Setup.
In the Send and receive messages section, copy your Phone Number ID.
WABA ID (WhatsApp Business Account ID)
In your Meta App’s left sidebar, expand the WhatsApp menu and select API Setup.
In the Send and receive messages section, copy your WhatsApp Business Account ID.
When you’ve filled in all the fields, select Save Configuration. This will automatically enable your integration.
3
Add your webhook
Now that you’ve enabled your integration, you can add your webhook to your Meta app’s configuration:
Copy the webhook URL and Verify Token from the Configuration section.
In your Meta App’s left sidebar, expand the WhatsApp menu and select Configuration.
Paste the webhook URL into the Callback URL field.
Paste your Verify Token in the Verify Token field.
Some of the integration’s Cards use WhatsApp message templates to send messages to users.In WhatsApp, these templates support both named and positional parameters. However, the integration currently only supports positional parameters. This means you’ll get an error if you try to provide named parameters in a Card’s conversation.templateVariablesJson field.
Here’s a reference for all Cards available with the integration:
Until Meta has verified your business, your bot won’t be able to send messages to WhatsApp users, even if you’ve configured it correctly.If you need to test out your bot right away, you can use the WhatsApp Playground while waiting for business verification.
Meta business verification taking too long
Unfortunately, we can’t help speed up Meta’s business verification process.If you need to test out your bot right away, you can use the WhatsApp Playground while waiting for business verification.
Bot receiving WhatsApp messages, but not sending messages back
There may be a problem with the payment method in your WhatsApp business account. Check the billing hub and make sure your payment method is configured correctly.
