All WhatsApp Business API accounts rely on a valid phone number. This document discusses how to pick a phone number and add it to your WhatsApp business account.
Your business must use a valid phone number. Short codes are not allowed on the WhatsApp platform. The number must include a country and area code. Landline and cell phone numbers are acceptable phone numbers to use. Since a phone number is tied to a WhatsApp account, you must own this number. This phone number must be able to receive voice calls or SMS in order to complete registration. This phone number must also not have been used with the WhatsApp Business API before. To use a phone number already on WhatsApp, refer to the instructions on how to migrate a phone number below.
Once a phone number is registered on the WhatsApp Business API, it cannot be used for WhatsApp Business or the WhatsApp consumer app. A phone number can be upgraded to the WhatsApp Business API, but not downgraded.
Many businesses want to use phone numbers their customers already know such as their 1-800 or other toll free numbers. These type of numbers are usually behind an Interactive Voice Response (IVR) system, which a WhatsApp registration call cannot navigate. Instead, WhatsApp is able to share with you 1 to 2 phone numbers that the registration phone call will come from. You can use this information to create an allow list for those numbers so that you can redirect the registration call to an employee or mailbox where the registration code will be captured.
If creating an exception in your IVR tree is something that you can do, add the phone number to your WhatsApp business account and open a Direct Support ticket asking for the registration call phone numbers and stating the phone number you are trying to register in the ticket.
We don't support IVR phone numbers that are unable to receive our registration phone calls.
NO! At any given time, you can only have one instance of the WhatsApp Business API Client running for a single phone number. As soon as you register a second instance, your first instance will get kicked off and fail. We are working on a proper solution that will allow you to accomplish this. We will keep you posted of any updates.
No, there is no way to use the WhatsApp Business API to detect multiples devices using the same number.
No. There's currently no way to run multiple numbers in the same WhatsApp Business API client setup. We are working on a proper solution that will allow this in the future.
No. The WhatsApp Business API solution requires a clean number.
Your business does not get notified when a customer changes their WhatsApp phone number. When you use the
contacts node, the status for that number will be
If a customer's phone number becomes inactive, but the customer is still using WhatsApp, the customer will continue to have access to WhatsApp until/if the phone number is reassigned or reregistered.
Once you have chosen your business's phone number(s), add them to your WhatsApp account to validate the phone number(s) and create the associated display name.
See Connect Your Phone Number to Your WhatsApp Business Account for more information about using the Facebook Business Manager to add your phone number to your WhatsApp business account.
See Migrate Phone Number to a Different WABA for phone migration between WABAs.
You can use a phone number that is already registered in the Android, iPhone, or Business application versions of WhatsApp. However, in order to register this phone number on WhatsApp Business API, you need to follow the steps below to delete the WhatsApp account associated with that phone number.
Any incoming messages after deleting the WhatsApp account on your Android or iPhone are queued by the WhatsApp servers and delivered upon successful registration.
When you register the number, you start receiving any incoming messages received after you deleted your WhatsApp account (step 6). Especifically, the queued messages are released once you request and confirm your registration code. There is no rate limit for the release of queued messages.
After you migrate your number to the API, you will no longer be able to use the WhatsApp Business App with that number. If you do not perform a backup, you will also lose chat history.
To start using the WhatsApp Business API, you will need to register your phone number with a display name by following the Registration documentation. During the registration process, a 6-digit registration code will be sent to the phone number you want to register.
As mentioned in the previous section, the phone number you select must be able to receive SMS or voice calls directly. If your phone number is behind an IVR like 1-800 or other toll-free numbers, please refer to the section addressing them above. If you have a phone number already registered using a manual code before, it will continue to work normally.