How do get the official WhatsApp business API through Twilio?

WhatsApp has begun to provide access to its official business API, which is required to create chatbots using official methods.

This can only be done through large Facebook partners, who in this case act as intermediaries.

One such available partner is the American company Twilio.

👉 The main condition for Facebook is to have a registered legal entity.
For an individual, access will not work.

1. Creating an account in Facebook Business Manager

2. Company verification in Facebook Business Manager

3. Registering an account with Twilio

4. Request to Twilio to activate the ability to add WhatsApp senders

5. Upgrade Twilio account

6. Buying a phone number in Twilio to create a WhatsApp sender

7. Registering WhatsApp Sender with Twilio

8. Completing WhatsApp Sender Registration with Twilio



1️⃣ Creating an account in Facebook Business Manager


👉 If you is already created Facebook Business Manager, you can skip this step.


Log in to your personal Facebook account and create a Business Manager account. To do this, follow the link business.facebook.com/overview and press the "CREATE ACCOUNT" button, a window for entering company data will open.

According to the prompts above the fields, enter the company name, first and last name, e-mail and press the "Send" button.

In the next window, enter information about the company and press the "Submit" button.

After sending, a message appears that the account has been created and you need to confirm your email address.


👉 Let's go to the mail and click on the "Confirm" button from the letter.


2️⃣ Company verification in Facebook Business Manager


👉 If your company is already verified by Facebook, you can skip this step.


After accepting the request from Twilio, you need to verify the company in Facebook Business Manager.

To do this, follow the link — Facebook Business Manager → Company Settings → Security Center and in the “Business Verification” section, click the “Start Verification” button, which will become active after accepting the request from Twilio.

The official information from Facebook about the confirmation of the company can be found at the link →

In the first step of confirmation, we will enter the data of our company:

The legal name of the company — is the name of the company as indicated in the documents for the registration of the company.

Country — the country where the company is registered.

Address (street, house no.) — street and house number of the legal address of the company, as indicated in the documents for the registration of the company.

Address 2 / Locality — enter, if available City - the city of the legal address of the company, as indicated in the documents for the registration of the company.

State / Province / Region — the region of the registered office of the company as indicated in the company incorporation documents.

Postal Code — the postal code of the registered office of the company, as indicated in the documents for the registration of the company.

Company phone number — the phone number that belongs to this legal entity (there must be supporting documents: agreement, invoices for payment for the phone, etc.).

Website — the address of the company's website (the website domain must match the domain of the company's email address).



The second step, you need to find your business in the list that Facebook will offer or upload documents confirming your business:



In the fourth step, you need to get and enter a confirmation code:

To do this, you need to select a phone number in the "Choose how to contact you" section and click the "Call me" button.

Leave the field "My work email address" blank.

The robot will call and dictate the numbers that need to be entered in the confirmation code entry field.

Enter the numbers of the confirmation code and click the "Submit" button.

We are waiting for confirmation from Facebook, as they write to us in the letter to Twilio, it can take 4-7 business days.

We received a confirmation of the company from Facebook within 1 working day.


3️⃣ Registering an account with Twilio

Let's register a Twilio account at twilio.com/try-twilio. It is not at all difficult to do this, registration is free and does not require bank card details, you just need to enter your first name, last name, e-mail and come up with a password.

Регистрация аккаунта в Twilio


👉 Next we confirm the e-mail.


👉 After we confirm the phone number.

4️⃣ Request to Twilio to activate the ability to add WhatsApp senders

Now you need to prepare and send a request to Twilio to activate the ability to add WhatsApp senders.

To do this, go to the "WhatsApp Senders" section using the link and click the "Sign Up to Receive Updates" button.

This will open a request form to activate the ability to add WhatsApp senders to Twilio. We fill in the form fields with the data indicated above when creating an account with Facebook Business Manager:

First Name — your First Name;

Last Name — your Last Name;

Phone Number — Company phone number (listed in Facebook Business Manager);

Email Address — Company email address (listed in Facebook Business Manager);

Company Name — Company name listed in Facebook Business Manager);

Company Website — Company website (listed in Facebook Business Manager);

Company HQ Country — Country of incorporation of the company (specified in Facebook Business Manager);

Twilio Account SIDCopy the Twilio Account ID from the ACCOUNT SID field

Facebook Business Manager IDCopy the ID of the created Facebook Business Manager account from the "Business Manager ID"

Facebook Business Manager → Business Settings → Business Information


I've completed Facebook Business Verification — put “No” if Facebook Business Manager → Business Settings → Business Information → Business confirmation status → “Not Confirmed” or “Yes” if “Confirmed” is indicated;

Company Vertical — choose the direction of the company's activity from the list;

What is your use case? — choose from the list what WhatsApp will be used for: Notifications, Customer Support, 2FA or User Verification;

Which regions are you sending messages to? — select from the Global list;

How many messages are you sending per month during the first year? — select the range you need from the list;

I wish to provision this account with a third party vendor — choose "No";

Assign approval to alternate Account SID (Optional) — do not enter anything, leave the field empty;

I understand Twilio can modify my SMS/Voice URL and that approval is only for the brand submitted. — agree and choose "Yes".


To send a request, press the button "Request Now".

After successful submission, a corresponding notification will appear: “Thank you for your interest. We will keep you updated as access open up"

Уведомление об успешной отправке запроса на активацию возможности добавления WhatsApp отправителей в Twilio


👉 We receive the following letter in the mail:

Письмо от Twilio после отправки запроса на активацию возможности добавления WhatsApp отправителей в Twilio


Now we are waiting 3-4 weeks for a response from Twilio, as indicated in the letter.

After 4 weeks, we receive a response from Twilio that now you can add a WhatsApp sender and continue the registration process:

Ответ от Twilio на запрос по активации возможности добавления WhatsApp отправителей в Twilio

5️⃣ Upgrade Twilio account

To continue, you need to make sure to transfer the Twilio project from Trial to a working Upgrade. To do this, you need to top up your balance.

The trial Twilio account will not be able to register the sender's WhatsApp. The minimum deposit amount is $20.

Then this money can be spent on renting phone numbers for WhatsApp senders and paying for incoming and outgoing messages in WhatsApp.

Renting a phone number starts at $1 per month. Incoming and outgoing messages in WhatsApp - 0.005 $ per 1 message.

To upgrade your account, follow this link →



Fill in the fields in the "Add Company Address" section.

Пополнение баланса Twilio: Добавление адреса компании


Press the "Validate Address" button to confirm the address. In the window that opens, click the "Use This Address" button.

Пополнение баланса Twilio: Валидация адреса компании


👉 Similarly, fill in the fields in the "Add Billing Address" section with the same data.

Пополнение баланса Twilio: Добавление адреса компании для выставления счетов


👉 And we confirm the address here too.

Пополнение баланса Twilio: Валидация адреса компании для выставления счетов


In the "Add Payment Information and Funds" section, enter the bank card details and press the "Upgrade Account" button to complete the payment.

Пополнение баланса Twilio: добавление данных о способе оплаты и проведение платежа


👉 After a successful payment, we will receive a notification.

Сообщение об успешной оплате в Twilio

6️⃣ Buying a phone number in Twilio to create a WhatsApp sender.

To purchase a Twilio phone number, follow the link

Select a country in the "COUNTRY" field, if you wish, you can set other additional search parameters, and press the "Search" button.

Подбор телефонного номера в Twilio для аренды
Подбор телефонного номера в Twilio для аренды


Select the desired phone number and press the "Buy" button.

In the next window, we confirm the purchase.

Подтверждение покупки телефонного номера Twilio


7️⃣ Registering WhatsApp Sender with Twilio

To register a WhatsApp sender in Twilio, go to the "WhatsApp Senders" section using the link →

Добавление отправителя WhatsApp в Twilio


Fill in the form that opens:

Select a Number (Required) — Select the phone number we bought from Twilio above.

Business Display Name (Required) — A display name that must be related to your company as required by Facebook. You can simply specify the company name that we entered when registering an account with Facebook Business Manager.

Company Address (Optional) — Company address (optional).

Company Email (Optional) — Company email address (optional).

Website (Optional) — Company website (optional).

Link to Logo (Optional) — Link to the company logo (optional). The minimum image size is 640x640 px in PNG or JPG formats (JPG is recommended), the background should not be transparent.

Check if profile is for a client. I've read the third party guidelines — Don't check this box.


To send, press the "Submit Request" button, which will become active after filling in the required form fields.

An entry with the status "Waiting for Approval from WhatsApp" will appear in the list of senders, which means that now you need to wait for confirmation from WhatsApp.

Статус WhatsApp отправителя Waiting for Approval from WhatsApp в Twilio


And we receive an email from Twilio that they are considering our request, and will contact us shortly.

Письмо от Twilio после отправки формы регистрации WhatsApp отправителя


😴 Now you need to waiting for the completion of registration of WhatsApp sender from Twilio.



8️⃣ Completing WhatsApp Sender Registration with Twilio

About an hour and a half later, we receive another email from Twilio that Facebook Business Manager needs to accept a request from Twilio in order to grant them permission to create a WhatsApp Business account.

To do this, follow the link: Facebook Business Manager → Company Settings → Requests → Received → click the "Approve" button.

After 4 hours, we receive an email from Twilio that they have checked our business profile on WhatsApp and have submitted our company's display name for review. The display name verification timeline is typically 24 to 48 hours.

Письмо от Twilio, что они проверили наш бизнес-профиль в WhatsApp.


😴 Wait 24-48 hours for a response from Twilio as indicated in the email.

After about 24-48 hours, we receive an email from Twilio that our WhatsApp sender profile with the selected phone number has been successfully registered.

Письмо от Twilio, что профиль отправителя WhatsApp с выбранным номером телефона успешно зарегистрирован.

Log into your Twilio account, go to the WhatsApp Senders section at and see that the record has changed its status to “Approved”.

WhatsApp отправитель одобрен в Twilio и готов к работе.

Outcome

This completes the connection of the official WhatsApp business API through Twilio. Now it can be used to integrate with various services for communicating with users and for creating chat bots.


Now you can connect your WhatsApp number for integration!


Share, is the instruction up-to-date or need to be updated?

😞 In reality, not so... | 😐 There are differences | 😃 Everything is fine

Did this answer your question?