Skip to main content

How to Add a Number to the WhatsApp Cloud API

Creating an Application

  1. Go to https://developers.facebook.com/ and log in to your Facebook account.
  2. Go to “My Apps” and click on “Create App”.
  3. Choose the app type “Business”.
  4. Enter the display name and select a validated Business Account (Business Manager).

Illustrative image

  1. You will be redirected to a screen with several product options. Choose the last option: WhatsApp.

Illustrative image

  1. Click on “Add phone number”.

Illustrative image

  1. Fill in your WhatsApp profile fields.

Illustrative image

Attention

Add your phone number, remembering that it cannot be registered with WhatsApp. 👉 Click here to see how to delete your account.

Illustrative image

  1. Enter the verification code and click “Next”.

Illustrative image

  1. Access your Business Manager Settings, click on “All tools” and then “WhatsApp Manager”.

Illustrative image

  1. Click on your WhatsApp account name.

Illustrative image

  1. Monitor your account status.

Illustrative image

  1. Once the account is approved, configure your webhook URL.

Illustrative image


Webhook URL Configuration

Required Information

  • Phone number ID
  • WhatsApp Business Account ID
  • App access token (generated in Business Manager)

How to generate the access token

  1. Access Business Manager, click on “Users” → “System users” → “Add”.

Illustrative image

  1. Accept the Terms of Service.

Illustrative image

  1. Create a user with an administrator role.

Illustrative image

  1. Add an asset.

Illustrative image

  1. Select the previously created application, check “Full control” and save the changes.

Illustrative image

  1. Click on “Generate new token”.

Illustrative image

  1. Select the application and check the following permissions:

    • whatsapp_business_messaging
    • whatsapp_business_management

Illustrative image

Important

Your token will be generated. Remember to copy and save it, as it will not be stored on the platform!

Illustrative image


Entering Information into SOUV

  1. Access your SOUV instance.

  2. Click on “Settings” → “Integrations” → “Communication” → “+ Meta Integration”.

  3. Enter the collected information:

    • Integration name → Just an internal identification in SOUV.

Illustrative image

  1. Copy the generated webhook URL and the verification token.

Illustrative image

  1. Go to your application settings, click on “Edit” and paste the information.

Illustrative image


Managing Webhook Fields

  1. In the application settings, click on “Manage”.

Illustrative image

  1. Subscribe to the events below and click “Done”.

Illustrative image