Kaleyra WhatsApp API

Every WhatsApp account is associated with a phone number. This phone number must not have a history of previous registrations or affiliation with WhatsApp.
There are three types of eligible phone numbers:

  • Fixed Lines: Probably the easiest to use as long as the developer can pick up a phone call when doing the setup.
  • Cellphones: Can be used as long as the number has not been used for any other WhatsApp account in the last six months.
  • 1-800 or toll-free numbers: Can be used as long as the phone number is capable of receiving SMS or voice calls directly. You cannot use numbers that are behind IVR. (If you have a phone number already registered using a manual code before, it will continue to work normally.
    For more detailed information on picking and registering a phone number, see the WhatsApp’s Phone Number guide and Rules for creating a business name.

Kaleyra will raise a request to WhatsApp for the setup of your verified account. However, you need to have a verified Facebook account. Otherwise, your request for a verified WhatsApp number will be rejected.

📘

Note:

There is no predefined turnaround time (TAT) for account setup, and WhatsApp Business does not guarantee accounts' approval.

If you already have a WhatsApp account integrated with another vendor, you cannot migrate the same account to Kaleyra, as Facebook does not permit this. In such cases, you can create a new account with Kaleyra, and we can help you get started.

The WhatsApp Business API is currently limited to public view, and WhatsApp’s approval is required for all customers entering the program. Kaleyra can help you onboard to WhatsApp and get your documents, use cases, and templates approved by Facebook.
It typically takes 2-3 weeks for the process, including approval, verification, and setting up of the account. This is subject to change as it is dependent on Facebook, and it may take longer in some instances.

Once your profile has been verified by Facebook and your business profile has been created on WhatsApp, you can immediately start receiving and sending messages through Kaleyra’s APIs.

Once a phone number is registered on the WhatsApp Business API, it cannot be used for the WhatsApp Business or consumer app. A phone number can be upgraded to the Business API but not downgraded from there.

You can integrate Kaleyra WhatsApp with third-party bots. Kaleyra provides Webhook configuration for businesses to handle incoming messages. Outgoing messages can be managed with our APIs.