Skip to main content

Configure WhatsApp

This guide shows you how to set up the WhatsApp Business API to use WhatsApp triggers and WhatsApp devices. The guide will walk you through the four necessary steps.

1. Create an App​

  • Log in to your developers.facebook.com account
  • Go to My Apps and select New App
    You can set the use case to other and the type to business.
  • After creating your app, add a WhatsApp product to your app and go to the API Settings.
  • Copy the Phone number ID. You will need this ID later for setting up your WhatsApp device in the Broadcast Suite.

2. Generate a Bearer Token​

Next, log in to your business.facebook.com account.

  • Go to your Business Portfolio > User > System Users
  • Create a System User and assign your previously created app (see "1. Create an App") to it
  • Create a token for the selected app (see official guide)
    Set the token to never expire, grant it the whatsapp_business_messaging permission and store it in a secure place.
    This token will later be used as your bearer token for your WhatsApp device in Broadcast Suite.

3. Configure a WhatsApp Device​

In Broadcast Suite, create a new WhatsApp device.

  • Set the Phone number ID to the previously stored ID (see "1. Create an App")
  • Set the Bearer Token to the previously stored token (see "2. Generate a Bearer Token").
  • Generate a random string (e.g. a GUID) and set it as Verification Token. Store the token in a secure place.
  • Make sure to set up at least one WhatsApp trigger - otherwise the WhatsApp webhook validation will fail.
  • Press Apply Config at the top right corner of Broadcast Suite.

4. Configure Webhooks​

In your developers.facebook.com account, validate your WhatsApp configuration in the API Settings.

  • To validate your configuration, enter your Callback URL: https://broadcastsuite:CORE_API_PORT/api/v1/whatsapp/webhook (Attention: HTTPS is mandatory)
  • Enter your generated verification token from step 3 in the Token field.
  • Validate your WhatsApp configuration and subscribe to the Webhook messages in your App.
    Your WhatsApp Device and WhatsApp Trigger are now correctly set up and ready to use!