Automate tasks with Whatsapp Business Cloud API

Send and receive messages using WhatsApp.
https://developers.facebook.com/docs/whatsapp/cloud-api/


Triggers

Actions

  • whatsapp_cloud_api

    Send a text message

    Send a text-based message to a phone number.

  • whatsapp_cloud_api

    Retrieve media URL

    Returns the URL corresponding to a received file.

  • whatsapp_cloud_api

    Send a text message template

    Send a text-based message template to a phone number.

  • whatsapp_cloud_api

    Send a template with image

    Send a text-based message template with an image to a phone number.

  • whatsapp_cloud_api

    Ask user

    Send a message, an image/video/document or both to a specific chat and wait for the user's response before continuing.

    • The following tags are currently supported in the messages: b, strong , i, em, u, ins, s, strike, del, a, code, pre.
    • You can include URL Buttons and Callback Buttons in posts.

Tutorials


How to connect WhatsApp Cloud API to Botize

Guide to obtain the credentials to automate WhatsApp Cloud API.


Frequently Asked Questions


Facebook shows the error 'You must provide a valid privacy policy URL to publish your app'

This error occurs when attempting to change the WhatsApp application from 'Development' mode to 'Live' mode in your Facebook panel (https://developers.facebook.com).

Before Facebook allows this change, you must first go to the 'Basic Settings' section on Facebook and provide the URL for the web page where your privacy policy is located.

You must have a web page with a privacy policy section in order for Facebook to accept the transition to 'Live' mode.

Facebook shows the error 'Invalid privacy policy URL'

This error means that the privacy policy URL that you have provided in Facebook, within the basic settings of the WhatsApp Business application, is not valid.

This is a requirement of WhatsApp to ensure that users of your bot have access to your company's privacy policy and can consult it before using it.

As a result, the application that you have created on Facebook to access the WhatsApp Cloud Business API cannot be activated, remaining in 'developer' mode, which prevents your bot from receiving messages from other users and processing them.

To solve this problem, you must indicate in Facebook, within the 'Basic Configuration' section of your application, the URL of your business website corresponding to the section or subsection where the privacy policy is explained.

How do I get 'Phone Number Id'?

Access to https://developers.facebook.com and enter the WhatsApp application that you have created. In the left column, click on the 'WhatsApp' section and in the 'Getting started' subsection.

The phone number Id will be indicated on the right with the name 'Phone number ID' label.

What does the 'Recipient phone number not in allowed list' error mean?

This error indicates that the phone number to which the bot is trying to send a message is not on the authorized recipients list on Facebook.

To fix this, you need to add the recipient's phone number to the authorized recipients list from the WhatsApp Cloud API settings section on Facebook.

To avoid having to add phone numbers in advance, put your Facebook application in 'Live' mode on the Facebook Developer Console, from https://developers.facebook.com.

How does the billing system for conversations on WhatsApp Cloud Business work?

WhatsApp Cloud Business bills each conversation between a bot and a user according to the corresponding category. The categories that WhatsApp currently handles are: utility conversations, authentication conversations, marketing conversations, and service conversations.

Rates may vary depending on the country where the service is being used. For up-to-date information on conversation categories and rates, it is recommended to visit the official Facebook pricing page.

My WhatsApp bot messages are appearing duplicated

If your bot is responding repeatedly or duplicating messages, it's generally because you have 2 or more WhatsApp applications with the same webhook in your Facebook developer account. Go to https://developers.facebook.com and ensure you have only one WhatsApp application.

Common Errors


No incoming WhatsApp messages found

To activate this task, send a message to the bot from your WhatsApp application.

In case you are sending messages from the WhatsApp application to the bot, and it is not responding, there are several reasons why the WhatsApp Business API may stop notifying the messages it receives to your Bot.

  • Incorrect webhook: The webhook you need to specify is https://botize.com/callbacks/whatsapp

  • Application in developer mode: Access https://developers.facebook.com and check that your application is in 'Active' mode. If, on the other hand, your application appears in 'Developer' mode, it means that WhatsApp will only take into account messages it receives from phone numbers you have expressly indicated in the configuration.

    Put your application in 'Active' mode, and your automated tasks should respond to all messages.
    If this is not the case, please contact us via email or Telegram so that we can review your case.