WhatsApp Setup

Add a bot to WhatsApp using the official integration.

The official WhatsApp integration allows your users to chat with your bot by messaging a WhatsApp number.

You will need:

• A published bot
• A Facebook account

Visual learner?

Check out our WhatsApp guide on YouTube for a step-by-step video guide.

1. In Botpress Studio, select Explore Hub in the upper-right corner.
2. Search for the WhatsApp integration, then select Install Integration.
3. In the Configuration menu, select Authorize WhatsApp.
4. Follow the instructions to connect Botpress to your WhatsApp account.

Additional requirements:

• While setting up your WhatsApp integration, we will ask you to create or select:

  • A Facebook business page
  • A WhatsApp business account

• 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.

You will need:

• A published bot
• A Facebook account

Visual learner?

Check out our WhatsApp guide on YouTube for a step-by-step video guide.

1. In Botpress Studio, select Explore Hub in the upper-right corner.
2. Search for the WhatsApp integration, then select Install Integration.
3. In the Configuration menu, select Authorize WhatsApp.
4. Follow the instructions to connect Botpress to your WhatsApp account.

Additional requirements:

• While setting up your WhatsApp integration, we will ask you to create or select:

  • A Facebook business page
  • A WhatsApp business account

• 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.

You will need:

• A Meta developer app. Check out the Meta developer documentation to learn more about the setup process.

1. Install the integration

   1. In Botpress Studio, select Explore Hub in the upper-right corner.
   2. Search for the WhatsApp integration, then select Install Integration.
   3. 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

   1. In your Meta App’s left sidebar, expand the WhatsApp menu and select API Setup.
   2. In the Access Token section, select Generate access token.
   3. Follow the instructions in the popup, then copy your access token.

   Client Secret

   1. In your Meta App’s left sidebar, expand the App Settings menu and select Basic.
   2. In the App Secret field, select Show, then copy your secret.

   Phone Number ID

   1. In your Meta App’s left sidebar, expand the WhatsApp menu and select API Setup.
   2. In the Send and receive messages section, copy your Phone Number 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:

   1. Copy the webhook URL and Verify Token from the Configuration section.
   2. In your Meta App’s left sidebar, expand the WhatsApp menu and select Configuration.
   3. Paste the webhook URL into the Callback URL field.
   4. Paste your Verify Token in the Verify Token field.

   For more information, check out WhatsApp’s guide on getting started with Cloud API.

You’ve manually configured your WhatsApp integration!