Phone Numbers

Phone Numbers


A WhatsApp Business Account (WABA) needs a valid, dedicated business phone number. This guide explains how to select a business phone number, add it to your account, and how to delete a phone number from your account.

If you are working with a Business Solution Provider (BSP) they will manage your phone number for you.

Requirements

The phone number for your business must be a valid phone number which meets the following criteria:

  • Owned by you
  • Has a country and area code, such as landline and cell numbers
  • Able to receive voice calls or SMS
  • Not a short code
  • Not previously used with the WhatsApp Business Platform

If you want use a phone number already registered with WhatsApp or the WhatsApp Business App, refer to our migration guides:

You can still use this number for everyday purposes, such as calling and receiving messages after registering it on the WhatsApp Business Platform.

1-800 and Toll Free Numbers

Businesses may want to register a 1-800 or other toll free number on the platform. These numbers are usually behind an Interactive Voice Response (IVR) system, however, which a WhatsApp registration call cannot navigate. Phone numbers behind an IVR system can be registered, but must be able to accept calls from international numbers and be able to redirect our SMS message or voice call to a real person.

To register a phone number that is behind an IVR system:

  1. WhatsApp shares with you 1 or 2 phone numbers that the registration call will come from.
  2. Create an allow list for these numbers. If you are unable to create an allow list for these numbers, add the phone number to your WABA and open a Direct Support ticket asking for the registration call phone numbers and include the phone number you are trying to register in the ticket.
  3. Redirect the registration call to an employee or a mailbox to capture the registration code.

Phone numbers behind an IVR system that are unable to receive registration calls are not supported.

Manage WABA Phone Numbers

Add Phone Number to a WABA

Once you have chosen your business's phone number(s), you need to add them to your WABA.

If a phone number is banned by WhatsApp it cannot be added to a WABA. If you believe the phone number was banned in error, please contact support.

Delete Phone Number from a WABA

Requirements

  • Only a business admin for the WhatsApp Business Account can delete a phone number.
  • A number can not be deleted if the business has sent paid messages within the last 30 days using that number.
    • If the business has sent paid messages in the past 30 days, you will be redirected to the Insights page showing the date of the last paid message. You will be able to delete the phone number 30 days after this date.

To delete a phone number, complete the following steps:

  1. In the Business Manager, go to your Business Settings page.
  2. Go to Settings > Business Settings > WhatsApp Accounts > WhatsApp Manager > Phone Numbers.
  3. From the WhatsApp Manager, find the phone number that you wish to delete. Click on the trash icon under Delete in the upper right.
  4. You may be asked to provide the password for your Facebook account connected to the WABA if the phone number had the status “Connected” previously.

Once a number has been deleted from the WhatsApp Business Platform, it can be used again in the WhatsApp app, or may be registered again in the WhatsApp Business Platform. Note that different rules apply to deleted phones that had been banned by the WhatsApp Business Platform.

Display Names

A business phone number display name is the name that appears in WhatsApp Manager. Having a business phone number with an approved display name is one requirement for your business to become an Official Business Account.

You can set a display name when you add a business phone number in the App Dashboard > WhatsApp > API Setup panel, or in the WhatsApp Manager > Account tools > Phone numbers panel, if you haven't reached your phone number limit.

If you submit your business for business verification and it becomes verified, we will either:

  • approve your display name
  • reject your display name
  • ask you to message more

In each case, we will notify you by phone_number_name_update webhook and Meta Business Suite notification.

If approved, we will set your business phone number's name_status to APPROVED.

If rejected, we will set your business phone number's name_status to DECLINED. We recommend that you re-review our display name guidelines, edit your display name accordingly, and file an appeal via Developer Support or Enterprise Developer Support.

If asked to message more, we don't have enough API usage data to determine if your number warrants a display name. Continue using the API, monitor phone number and message quality and take appropriate actions to improve your quality scores, and we will automatically re-review your display name at a future date.

Phone Number Limits

Business phone numbers can only be registered for use with one API at a time: Cloud API or On-Premises API.

Business accounts are initially limited to 2 registered business phone numbers, but this limit can be increased to up to 20.

If your business has been verified and your business phone number has an approved display name (or if you have two business phone numbers and they both have approved display names) we will determine if your API usage warrants a phone number limit increase.

If we determine an increase is warranted, we will automatically increase your limit and notify you by business_capability_update webhook and Meta Business Suite notification of your new limit.

If we determine that an increase is not warranted, we will keep your limit at 2. If more than a week has passed since your business has been verified and your limit is still 2, ensure that you are monitoring phone number and message quality and take appropriate actions to improve your quality scores. After improving your quality scores, if we determine that your business warrants an increase, we will automatically increase your limit and notify you by webhook and Meta Business Suite notification of the new limit.

If you have access to Enterprise Support and need your limit increased beyond 20, open a Direct Support Ticket with the following selections and explain why your need more than 20 numbers:

WABiz: Account & WABA > Request type > Increase Phone Number Limits

Resetting Verification Code in WhatsApp Manager

If you forget or misplace your PIN, follow these steps to reset it in WhatsApp Manager:

  1. Go to settings, log into your Facebook Business, and click the business you are using to manage your WABA (WhatsApp Business Account)
  2. In the settings screen, click WhatApp Accounts and find the WABA you want to reset the verification code for. Click on the WABA and a panel with its respective info will come up on the right-side of the page
  3. In the WABA information module, click Settings
  4. In the new tab, click WhatsApp Manager
  5. In WhatsApp Manager, find your phone number and click Settings
  6. Click Two-step verification
  7. In the Two-step verification tab, click Turn off two-step verification. A message with instructions will be sent to your email address
  8. Your two-step verification code is now removed and depending on your platform, you can set it using one of these APIs:

    • Related Articles

    • How to connect your phone number to your WhatsApp Business account

      This article is intended for businesses and business solution providers that use the WhatsApp Business platform. If your business uses the WhatsApp Business app, don't follow the steps in this article. To send and respond to messages, you need to ...
    • Mastering Template Creation: A Comprehensive Guide

      Mastering Template Creation: A Comprehensive Guide The ability to create templates is a valuable talent in the fast-paced field of communication management as it may assure professionalism, consistency, and time savings. Having well-designed ...
    • API Documentation

      Running an API in Postman is a straightforward process, but it becomes even more useful when you need to include custom headers and a specific JSON request body. In this guide, we'll walk you through the steps to run the WABA API using Postman with a ...
    • STOP-LIGHT DOCUMENTATION for Template API

      STOP-LIGHT DOCUMENTATION The released documentation covers how to use APIs to send templates directly from the Marketing panel. POST https://connect.api-wa.co/project-apis/v1/project/{project_id}/messages PARAMETER Project_id : XXX AUTH ...
    • Understanding Live Chat Features: A Comprehensive Guide - Marketing Panel

      Understanding Live Chat Features: A Comprehensive Guide - Marketing Panel Live chat systems have become essential tools for organizations to effectively communicate with their clients in the areas of customer service and communication. Whether ...