Skip to main content

How to add a number to the WhatsApp Cloud API

Creating an application​

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

Illustrative image

After clicking Create app, the user will be directed to the application details configuration step.

On this screen, the basic information that identifies the app within the Meta platform must be provided.

App details

Required fields​

  • App name
    Identification name of the application that will be displayed in the My Apps section of Meta Developers and associated with the app ID.
    This name can be changed later in the settings.

  • App contact email
    Email address used by Meta for communications related to the application, such as:

    • Policy updates
    • Restriction or blocking notices
    • App recovery in case of compromise
Attention

Use a valid and regularly monitored email address, as it will be Meta’s main contact channel.

Next step​

After filling in the required fields, click Next to continue creating the application.

Use case selection​

After providing the application details, the user will be directed to the Use Cases step.

WhatsApp use case selection

  1. In the list of use cases, locate Connect with customers via WhatsApp.
  2. Select the WhatsApp use case as highlighted in the image.
  3. Click Next to proceed with app creation.
Attention

Selecting the Connect with customers via WhatsApp use case is mandatory to enable integration with the WhatsApp Business API.

Business portfolio selection​

After selecting the WhatsApp use case, the user will be directed to the step to choose the business portfolio that will be connected to the application.

Business portfolio selection

  1. Select the business portfolio to which the application will be linked.
  2. If the user does not yet have a business portfolio, click Create a business portfolio, as highlighted in the image.
  3. Follow the business portfolio creation process on the Meta platform.
  4. After selecting or creating the portfolio, click Next to continue.
Attention

To integrate the application with WhatsApp Business, it must be linked to a Meta business portfolio.

:::Saiba mais For more information on how to create a business portfolio, visit:
https://www.facebook.com/business/help/1710077379203657 :::

Final Step

After completing all steps, the final screen will display a summary of the application settings.
Click Go to dashboard to finish the process.

Application configuration summary

Application dashboard​

After completing the initial application creation steps, the user will be redirected to the app Dashboard.

Application dashboard

  1. On the app dashboard, locate the App customization and requirements section.
  2. Click Customize the use case "Connect with customers via WhatsApp", as highlighted in the image.
  3. In this section, you can configure the WhatsApp Business integrations.
Attention

This is where the main WhatsApp Business integration settings are configured.

Initial WhatsApp Business configuration​

At this stage, the required data for sending and receiving messages using the WhatsApp Business API will be configured.

WhatsApp Business configuration

  1. In the Access token section, click Generate access token.
  2. Copy the generated token and store it in a safe place, as it will be used in later integration steps.
  3. In Send and receive messages, add the phone number that will be used to send and receive WhatsApp campaign and support messages.

Phone number configuration example Phone number send message example

Attention

Add your phone number, remembering that it cannot be registered with WhatsApp.

Visit WhatsApp support to learn how to delete an existing account.

  1. After adding the number, two important identifiers will be displayed:

    • Phone number ID
      Unique identifier of the phone number registered in WhatsApp Business.
    • WhatsApp Business Account ID
      Identifier of the WhatsApp Business account associated with the app.

    These two IDs will be used later during the integration configuration in SOUV.

  2. Finally, click Configure webhooks to start configuring message and event reception.

Attention

Save the access token, phone number ID, and WhatsApp Business Account ID, as they are required to complete the integration in SOUV.

Webhook URL configuration​

Important: Complete all previous steps for app creation and phone number addition before reaching this stage.

Go to WhatsApp > Configuration in your Meta app dashboard.

You will see the Webhook configuration screen with the following main fields:

  • Callback URL: Paste the webhook URL generated in SOUV (you will copy it in the next step).
  • Verify token: Paste exactly the verification token generated in SOUV.

Webhook configuration screen in Meta Developers

(Click Verify and save only after pasting the SOUV URL and token).

Now let’s go to SOUV to generate this URL and token.

Configuring the integration in SOUV​

[conteúdo continua exatamente como o original…]