API Credentials for Whatsapp Business Cloud API

Guide to obtaining tokens, keys, and connections.

Connecting to the WhatsApp Cloud Business API requires completing a few steps in Facebook to obtain an access token, a 'Phone Number ID', a 'WhatsApp Business Account ID', and a temporary phone number. This temporary number will allow you to start using the WhatsApp API right away until you decide to replace it with your own real WhatsApp number.

Before continuing, we recommend reviewing the FAQ section to get an overview of the possibilities and also the limitations of the official WhatsApp API.

Create a Business in Facebook

  1. 1

    Go to https://business.facebook.com/settings

  2. 2

    Click on the 'Create Business' button

  3. 3

    In the 'Business and Account Name' field, enter your business name (e.g., 'Botize')

  4. 4

    In the 'Your Name' field, enter your own name

Verify your business email

  1. 1

    Open your inbox, find, and open the confirmation email sent by Facebook

  2. 2

    Click the 'Confirm' button inside the email

  3. 3

    This button will redirect you to your Facebook Business settings page

Register your WhatsApp application

  1. 1

    In the left menu, click on 'Apps' under the 'Accounts' section

  2. 2

    Click on the '+ Add' button

  3. 3

    Select the option 'Create a new App ID'

  4. 4

    In the 'App Name' field, type a name for your application (e.g., 'botize')

  5. 5

    Click the 'Next' button

  6. 6

    In the left column, under 'Filter by', select 'Other'

  7. 7

    At the bottom right, select 'Other'

  8. 8

    Click the 'Next' button

  9. 9

    Select 'Business' and click 'Next'

  10. 10

    Click the 'Create App' button

Set up the WhatsApp module

  1. 1

    In the 'Add products to your app' section, you'll see blocks such as 'Messenger', 'Instagram', 'WhatsApp', etc. Locate the 'WhatsApp' block.

  2. 2

    Click the 'Set Up' button on the WhatsApp block

  3. 3

    It will ask you to select your business portfolio. Choose the one you created at the beginning of this guide and click 'Continue'

  4. 4

    In the left column, click on 'API Setup'

Test phone number

At this point, WhatsApp will have created a test phone number for you, which appears in the 'From' field.<br><br>Use this number to make your first tests until you decide to switch to a real WhatsApp number.<br><br>The test number can only send and receive messages with up to 5 contacts you choose.<br><br>Let's now create your first contact, which can be your personal WhatsApp number.

  1. 1

    Click on 'To' and select 'Manage phone number list'

  2. 2

    Enter your phone number and click 'Next'

  3. 3

    You will receive a verification code on your phone. Enter it and click 'Next'.

    From now on, you’ll be able to send and receive messages from this test number.

    You can repeat this process for up to 4 more phone numbers.

Webhook configuration

  1. 1

    Click on the 'Configuration' section under 'WhatsApp' in the left column

  2. 2

    In the 'Callback URL' field, enter: https://botize.com/callbacks/whatsapp

  3. 3

    In the 'Verification Token' field, enter: 10005184KTSJ

  4. 4

    Click the 'Verify and Save' button

  5. 5

    In the 'Select product' field, choose 'WhatsApp Business Account'

  6. 6

    You’ll now see a list called 'Webhook Fields'. Look for the field named 'messages'

  7. 7

    On the right of 'messages', activate the 'Unsubscribed' toggle. It will change to 'Subscribed'.

  8. 8

    In the left column, click again on 'API Setup'

Get the Token

  1. 1

    Click the 'Generate Access Token' button

  2. 2

    You’ll be asked to select a WhatsApp account. Choose one or select all available accounts

  3. 3

    Click the 'Save' button

  4. 4

    A token will be generated — copy and paste it into the Botize connection form

Get the Phone Number ID and WhatsApp Business Account ID

  1. 1

    Scroll down to the 'Send and receive messages' section

  2. 2

    Copy the 'Phone Number ID' into the Botize connection form

  3. 3

    Copy the 'WhatsApp Business Account ID' into the Botize connection form

  4. 4

    You now have all the required data. Click the 'Authorize' button in the connection form and your WhatsApp account will be successfully connected to Botize