Register WhatsApp senders using Self Sign-up
Learn how direct customers can register a WhatsApp sender using Self Sign-up in the Twilio Console.
A WhatsApp sender is a phone number associated with a WhatsApp Business Account (WABA). When you register a WhatsApp sender, you can send and receive WhatsApp messages from your business or brand using the Twilio APIs.
Note: If you're an Independent Software Vendor (ISV), you must join Meta's Tech Provider program, complete a technical integration, and onboard your customers through the program.
- Create and upgrade your Twilio account.
Sign up for your Twilio account and upgrade it. To upgrade your account, in the Twilio Console, click Upgrade at the top of the page, or go to Admin > Account billing and click Upgrade account. - Make sure you have administrator access to your Meta Business Portfolio.
Check if your company already has a Meta Business Portfolio.- If your company already has a Meta Business Portfolio, request administrator access with full permissions. This access is required to create a WhatsApp Business Account (WABA) during the Self Sign-up process.
- If your company doesn't have a Meta Business Portfolio or you can't get administrator access to an existing one, you can create one during the Self Sign-up process. After creating the Business Portfolio, you'll need to complete Meta business verification before you can move into production.
You can use either a Twilio phone number or a non-Twilio phone number to register a WhatsApp sender.
- The phone number must meet the WhatsApp compatibility requirements.
- The phone number must not already be registered with WhatsApp. Learn how to check if a phone number is registered with WhatsApp and how to use an already registered phone number.
- If the phone number is non-Twilio, it must be able to receive SMS or voice calls.
- If the phone number is registered with an Interactive Voice Response (IVR) system or a computer-operated phone system, you can't receive One-Time Passwords (OTPs).
- If the phone number is only available for outbound messages or calls, you can't use it to register a WhatsApp sender because Meta can't deliver OTPs.
The WhatsApp sender display name must comply with Meta's display name guidelines. Meta reviews the name after registration. If Meta rejects the name, the phone number is limited to 250 business-initiated messages per 24-hour period, and Meta might disconnect the sender.
- In the Twilio Console, go to Messaging > Senders > WhatsApp Senders or navigate to WhatsApp Senders.
- Click Create new sender.
The New Sender page opens.
Under 1. Select a phone number to register, select a phone number and click Continue. You can choose either a Twilio phone number or your own phone number (Non-Twilio phone number).
- Under 2. Link WhatsApp Business Account with your number, click Continue with Facebook.
This opens a Self Sign-up pop-up window. - Complete the steps in the Self Sign-up pop-up window.
- Keep both the Self Sign-up pop-up and Twilio Console windows open.
- Don't share the pop-up window URL with anyone else. The registration will fail.
- Complete all steps in the same browser so Meta and Twilio can exchange data properly.
The following sections describe the steps in the Self Sign-up pop-up window.
- In the Self Sign-up pop-up window, log in to Facebook with your credentials. If you're already logged in, click Continue as [your name].
- Review the permissions to allow Twilio to manage your WABA, then click Get started.
- Create a new Meta Business Portfolio or select an existing one.
When you select a Meta Business Portfolio, its associated business information is pre-filled in the form. - Click Next.
- Create a new WABA or select an existing one.
(warning)
Warning
Don't select a WABA that's been created outside of Twilio. If you already have an approved WhatsApp Sender with another provider, create a new WABA to use specifically with Twilio.
- If you're registering your first WhatsApp sender, create a new WABA.
- If you're registering an additional WhatsApp sender in the same Twilio account or subaccount, you must select the same WABA you used to register your first WhatsApp sender.
- You can see the ID of the WABA that's connected to your Twilio account in the Twilio Console window.
- Twilio requires all WhatsApp senders in an account to be within the same WABA and maintains a one-to-one relationship between a Twilio account and a WABA.
- Select Create a new WhatsApp Business profile.
- Select Instruct Meta to automatically identify order and lead events.
- Click Next.
-
Set the following fields:
Field Customer-Facing Description WhatsApp Business account name No The name of your WABA. Pre-filled if you selected an existing WABA. WhatsApp Business display name Yes The display name that your customers see when they receive WhatsApp messages from your business. Must comply with Meta's display name guidelines. Category Yes The category of your business displayed in your profile. You can update the category later in the Twilio Console. -
Optionally, click Show more options to set the following fields:
Field Customer-Facing Description Business description Yes The description of your business displayed in your profile. Website Yes The website of your business displayed in your profile.
Meta requires you to verify ownership of each phone number before it can send or receive WhatsApp messages. Meta verifies ownership through SMS or voice call OTPs.
The registration process depends on the phone number type (Twilio or non-Twilio) and capabilities (SMS or voice) to receive the OTP for verification.
Phone number type | Capabilities | OTP verification code delivery |
---|---|---|
Twilio | SMS | Receive the OTP verification code in the Twilio Console |
Voice | Configure the phone number to receive the OTP verification code via email | |
Non-Twilio | SMS | Receive the OTP verification code via SMS |
Voice | Receive the OTP verification code via voice call |
Don't use WhatsApp-provided numbers
Don't select Use a display name only. This option uses a free WhatsApp-provided number (555 business number) that doesn't require verification. Twilio doesn't support WhatsApp-provided numbers at this time.
- In the Twilio Console window, under 2. Link WhatsApp Business Account with your number, in the 2. Copy the phone number you register section, click Copy next to the phone number.
- In the Self Sign-up pop-up window, on the Add your WhatsApp phone number page, select Add a new phone number and paste the phone number you copied from the Twilio Console.
- Select Text message as the verification method and click Next.
The Twilio Console displays the verification code. - In the Twilio Console window, under Verify the selected number with WhatsApp, click Copy next to the verification code.
- In the Self Sign-up pop-up window, paste the verification code you copied from the Twilio Console and click Next.
After verifying the phone number, the Self Sign-up pop-up window opens the Review Twilio's access request page. Review the access requests and click Confirm.
When you confirm the access requests, the following occurs:
- The Self Sign-up pop-up window closes.
- Twilio starts the registration process. This might take a few minutes.
- The Twilio Console window automatically refreshes and shows the WhatsApp sender you registered.
After registration is complete, you can manage your sender by clicking Edit Sender:
- Set your inbound message webhooks.
- Update your WhatsApp Business profile, including your profile picture.
- Add the sender to a Messaging Service or change the Messaging Service.
- Delete the sender.
Info
Business verification is free and isn't the same as Meta's subscription product, "Meta Verified".
If you created a new Meta Business Portfolio during the Self Sign-up process or your existing Meta Business Portfolio hasn't completed business verification, you must complete business verification on Meta before you can move into production.
When you complete business verification, you can:
- Increase your messaging limits.
- Add more than two WhatsApp senders.
- Request a WhatsApp Official Business Account (OBA).
To complete business verification, follow the steps in How to verify your business on Meta. You can check your business verification status in Meta's Security Center.
Meta's processing time for business verification varies by region and can take several weeks. Start the verification process early to avoid delays in moving into production.
Note: After completing Meta business verification, you might still see a notice that directs you to complete verification. If you've already completed it, you can ignore the notice.
To register additional WhatsApp senders, you can repeat the Self Sign-up process or use the Senders API.
When to use Self Sign-up or Senders API
Twilio recommends using the API only when you need to onboard a large number of senders across many accounts (bulk registration). Use the WhatsApp Self Sign-up for a small number of senders.
When registering additional WhatsApp senders, keep this in mind:
- For each sender, you must select the same Meta Business Portfolio and WABA that you used for the first WhatsApp sender. Selecting a different Meta Business Portfolio or WABA will result in an error.
- You can't use multiple WABAs in one Twilio account.
The following troubleshooting steps can help you resolve common issues when you register a WhatsApp sender.
To check if a phone number is registered with WhatsApp, use one of the following methods:
- Send a test message: Open
https://wa.me/<PHONE_NUMBER>?text=hi
in a browser (include the country code without+
, for example,15551234
). If the number is registered, you'll receive "hi" in WhatsApp. - Search contacts: In WhatsApp, tap New Chat > New Contact and enter the phone number. If the number is registered, you'll see "This phone number is on WhatsApp".
- Check error logs: Open the Error Logs page in the Twilio Console. If the number is registered, you'll see Error 63110.
To use a phone number that's already registered with WhatsApp:
- If registered with WhatsApp or WhatsApp Business app: Delete the WhatsApp account to make the phone number available for the WhatsApp Business Platform with Twilio.
- If registered with another WhatsApp Business Platform: In the WhatsApp Manager, turn off Two-Factor Authentication (2FA) for the number on the WhatsApp Business Platform and register a WhatsApp sender with the number. Contact your Solution Partner if you can't turn off 2FA by yourself.
Learn more about migrating phone numbers and WhatsApp senders. If you need further assistance, contact Twilio Support.