All WhatsApp Business Platform accounts rely on a valid phone number. This document discusses how to pick a phone number and add it to your WhatsApp Business Account (WABA).
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.
Your 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 the WhatsApp Business app 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.
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 can no longer be able to use the WhatsApp Business App with that number. If you do not perform a backup, you lose chat history.
To start using the WhatsApp Business API, you need to register your phone number with a display name. During the registration process, a 6-digit registration code is 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 continues to work normally.
See our documentation below for more information:
No. The WhatsApp Business API solution requires a clean number.
Toll-free numbers are allowed as long as your country code is included. The reason is that toll-free numbers without country codes cannot be uniquely identified — the same number can apply for two different countries.
Also note that there are added complexities around toll-free numbers. Typically, if you call a toll-free number with the country code when you're inside the country, it will fail. This means that there is a chance your customers from your country will try to dial what shows in the business contact (country code included) and they won't be able to reach you. If this is a concern, you will need to let them know explicitly.
Read more about toll-free numbers here.
You can register new phones numbers and delete old one in your WhatsApp Account in the Facebook Business Manager.
Unfortunately, you will need to pick a different phone number that is capable of receiving SMS or voice in order for us to send the registration code. In the past, we had allowed manual registration codes, but this is no longer supported. Phone numbers that used manual registration codes before will continue to be supported as required. For any new phone numbers, we will only deliver registration codes via SMS or voice call.
If you want to use your 1800 or toll free number, please read this guide.
If registration is failing with "sms" because of too many attempts and you see an "access denied" message, then please try registering with "voice"
Yes, we can set up a new phone number or change the verified name when you are ready to go live.