Choosing the right WhatsApp API phone number is the first step toward automating a company’s customer service. A business can connect a new number, use a line already active on WhatsApp Business through coexistence, or migrate a personal number.
Understanding these options prevents integration mistakes and speeds up approval by Meta. Below are the technical requirements and the step-by-step process to connect the channel and create AI agents in minutes.
Key Takeaways
- Meta accepts landlines, mobile numbers, and toll-free numbers, as long as they can receive an SMS or a voice call.
- Coexistence lets the business keep the number in the WhatsApp Business app while it is used on the official API.
- New business portfolios start with a limit of two numbers, which can grow to 20 after verification.
- The display name must follow strict rules and can be changed up to 10 times in 30 days.
- Final registration happens through an API endpoint, with a limit of 10 attempts in 72 hours.
What to Consider When Choosing a WhatsApp API Phone Number
The choice of number directly affects customer service and sales operations. Meta sets strict technical guidelines on which formats are compatible, so businesses need to plan their infrastructure before connecting the channel to advanced platforms. Understanding the initial requirements, or the process to move from an unofficial API to coexistence without losing the number, requires close attention to verification and authentication rules.
Number Types Meta Accepts
The platform requires proof of ownership through a six-digit code. According to Meta, mobile numbers are the recommended format because they natively support SMS and standard voice calls. Landlines and toll-free numbers are also widely accepted for business accounts, with one difference: verification happens only through an automated phone call, so the line must be free at the moment of registration.
Any WhatsApp API phone number must include a valid country code and area code. Short codes, often used in traditional bulk SMS campaigns, are not supported. Meeting these format rules lets the business move on to registration and set up WhatsApp with multiple agents on a single channel customers recognize.
Technical Requirements for IVR and VoIP
Businesses that use interactive voice response (IVR) systems face an extra challenge during activation. Numbers behind an IVR can be registered normally, as long as the infrastructure can receive international calls, since Meta’s verification system calls from abroad. The phone route must also be able to forward the call or SMS with the temporary PIN directly to a person or reachable extension, so the verification call does not get stuck in the company’s menu.
Virtual (VoIP) lines have known technical limits for receiving text messages, which makes the voice call the default and safer option for verification. Meeting these technical requirements is the key step before following the instructions on how to connect WhatsApp to the official API and turning on artificial intelligence agents. Preparing the line in advance reduces authentication failures and speeds up activation.
How Coexistence Works on WhatsApp Business
Coexistence is a feature that lets a business use the same WhatsApp API phone number on the API and in the app at the same time. The business can connect the channel to AI agents without giving up direct access from the phone, combining automation at scale with traditional manual customer service.
Benefits of Keeping the Number in the App
Chat history is preserved throughout the integration. According to Meta, one-on-one messages from the last six months can be synced to the platform, so the context of earlier conversations is kept. The team can alternate between the app and the AI agent’s automations, and this flexibility makes it worth understanding what keeps working on WhatsApp Web with coexistence and on other linked devices.
The hybrid setup also directly affects costs. Messages sent and answered directly in the app remain free for the business. Automated conversations and sends through the official WhatsApp API follow Meta’s standard pricing, which charges per delivered message, by category and by the recipient’s country (see the official pricing page). For a detailed breakdown, see WhatsApp coexistence pricing.
Requirements to Turn On Coexistence
To enable the hybrid mode, the WhatsApp Business app on the phone must be updated to version 2.24.17 or later. The integration must be carried out through a Tech Provider verified by Meta, such as ConverZAP; the business cannot set it up on its own. The number is validated on the platform while it stays active on the agent’s phone.
After setup, customer service management becomes more transparent. Messages sent from the phone appear in the platform inbox labeled “Sent from phone”, so other team members can see where each reply came from. If problems come up during the initial sync, reviewing common WhatsApp coexistence errors helps quickly resolve issues related to the app version or number registration restrictions.
Already using the WhatsApp Business app?
With coexistence, the same number stays on the phone and also runs on the official API, with the ConverZAP AI agent for WhatsApp and a team inbox.
See how coexistence worksNumber Migration: When and How to Do It
In some cases, a business chooses to migrate an existing number instead of keeping the app active on the team’s phone. This requires attention to the platform’s technical requirements so the transition happens without interrupting customer service. The right method depends on where the number is set up today.
Regular WhatsApp vs. WhatsApp Business
Numbers in use on regular WhatsApp cannot be registered directly on the official integration. The first required step is to move the line to Meta’s business app. During this step, backing up messages helps keep old information saved on the phone before the move to the business environment.
Once that first step is done, there are different paths for the final connection. The admin chooses between deleting the profile in the app for good or setting up both together. To decide which format fits the operation best, comparing coexistence vs. Cloud API helps define the ideal setup for the WhatsApp API phone number.
Deleting the Account to Register on the API
If the business chooses to delete the account directly in the app, the chat history stored on the phone is lost permanently. According to Meta, this disconnects the profile from the mobile version and frees the number for registration only on the cloud infrastructure. This path is usually chosen by operations that run their entire flow through customer service platforms and artificial intelligence agents.
Even after the profile is deleted from the app, the number registered on the API can still make regular phone calls and send standard SMS through the carrier. The only technical restriction is that the number can no longer be used on the regular WhatsApp Messenger. All WhatsApp communication is then managed only by the system connected to the official integration.
Verifying Ownership of the Number
Platform security requires the business to prove it owns the number before completing registration on the official API. This prevents unauthorized use of phone lines and keeps communication legitimate when the channel connects to advanced customer service tools, such as an artificial intelligence agent that qualifies leads continuously.
Receiving the Verification Code
Meta verifies ownership by sending a six-digit code by SMS or international voice call. During this step, the number must be active and have good signal to receive the message at the exact moment of registration. Lines that block unknown callers or use anti-spam filters need those settings turned off temporarily so the code gets through.
For landlines, voice verification is the default, according to Meta’s guidelines. If the line uses an IVR, the company’s internal system must be able to forward the international call to a person or a reachable voicemail, so the code can be heard and written down. This step is essential to move forward with WhatsApp Business verification and set up the account correctly.
Registration Through the API Endpoint
Final registration of the number does not happen in WhatsApp Manager but directly through a specific API endpoint (/register). After the code is validated, the platform activates the number technically in Meta’s developer environment. According to the official documentation, the system accepts up to 10 registration requests per number in a rolling 72-hour period, so care is needed to avoid temporary blocks from too many attempts.
Note that the two-step verification PIN, traditionally used in the app, is being phased out for eligible numbers in this technical flow. The focus shifts to direct authentication through the official API, which simplifies setup for platforms such as ConverZAP, a Tech Provider verified by Meta that connects virtual agents.
Display Name Rules
The name shown on the business profile is the customer’s first point of contact and must follow the platform’s strict guidelines. Getting it right when preparing a WhatsApp API phone number avoids rejections that delay the start of customer service.
Meta’s Approval Criteria
According to Meta, a display name is required at the exact moment the number is registered. The review requires a clear link to the brand: the name must match the legal company name, the trade name, or a variation the public easily recognizes.
Purely generic terms, standalone locations, or vague product descriptions are not accepted under the platform’s policy. The review usually takes a few hours or days, and messages exchanged on the channel follow the normal rates, which can be estimated in the API cost calculator.
Changes and Re-Registration
Businesses that go through a rebrand or operational changes can update the profile. The current rule allows the display name to be changed up to 10 times in every 30-day window, which gives flexibility for structural changes.
After the new name is approved, the number must be registered again on the platform within 14 days. Rejected names require opening a support ticket and sending additional documentation, such as trademark records, to dispute the decision and get the name approved.
Number Limits in the Business Portfolio
How many numbers a business can connect to Meta’s official API depends on the account’s status and sending history. The business portfolio organizes these connections and has scaling rules that protect the platform from abuse. Understanding these stages helps structure customer service without surprises when adding a new WhatsApp API phone number.
Restrictions for New Accounts
New business portfolios start limited to just two registered business numbers, according to Meta. This initial restriction aims to prevent spam and protect the quality of the messaging ecosystem, so businesses must build a positive conversation history before expanding.
Recently created Facebook accounts may face extra security barriers during integration. For organizations that use WhatsApp Business as their main sales channel, starting with this limit requires planning: prioritize the lines with the highest customer volume until the limit increases.
How to Raise the Limit to 20 Numbers
The limit rises automatically to 20 numbers once the business completes business verification in Meta’s dashboard. Besides document verification, reaching the 2,000-message limit with good quality also unlocks the expansion automatically, with no need to open a support ticket.
Managing multiple numbers makes it easier to split customer service by physical branch, subsidiary brand, or department. With the higher ceiling, the operation can connect different lines to specialized AI agents, routing leads to sales and questions to support in an organized, scalable way.
Common Mistakes When Connecting a WhatsApp API Phone Number
Some technical obstacles can come up while integrating an official WhatsApp API phone number. Understanding the error codes Meta returns speeds up resolution and avoids delays in activating artificial intelligence agents in the inbox.
Outdated App or Blocked Number
An attempt to connect the number to the platform can fail because of version issues or usage restrictions set by the system. Error 4563015, for example, means the WhatsApp Business app installed on the phone is outdated. To fix it, open the phone’s app store and update to version 2.24.17 or later.
Other blocks are tied to the account’s history or the location of the SIM card. The most frequent cases include:
- Error 3441045: Meta indicates the account needs more active use in the WhatsApp Business app before it can be connected to the API. The recommendation is to keep using it routinely for a few more days or register a new number.
- Error 3441042: The integration feature is not available in the current registration region, so the business needs a phone line from a supported area.
Conflicts With Other Platforms
Provider migrations or earlier settings in the Facebook ecosystem can also block registration. Code 3441030 means the line is already connected to the API through another company. To free it up, the admin must request disconnection on the previous platform, open the business platform settings in the app, remove the link, and wait 15 minutes before trying to connect to ConverZAP, a Tech Provider verified by Meta.
Beyond third-party integrations, internal links to Meta assets can also stall setup. Error 2655082 occurs when the phone number is tied directly to a Facebook Page. The fix is to open the business portfolio settings, remove the Page associated with the number, and continue activating the automation.
Costs and Number Formats: Brazil-Specific Details
Running a WhatsApp API phone number in Brazil requires attention to formatting details and to Meta’s billing model. Understanding these local rules helps avoid integration failures and budget surprises in automated customer service.
The Ninth Digit Issue
Brazilian phone numbers have a known variation when integrated with the official platform: mobile numbers can appear with or without an extra ninth digit. For Brazil, the Cloud API may change this extra digit when sending or receiving messages, so connected systems need to adapt.
According to Meta, this behavior is expected and not a platform bug. The official recommendation is to always send the + sign followed by the country code (55) in requests. When building a WhatsApp chatbot, the technical team needs to prepare the database to handle this ninth-digit variation without duplicating contacts.
Message Pricing
Messages sent through the official API are charged per delivered message, by category (marketing, utility, authentication, or service) and by the recipient’s country, as shown on Meta’s official pricing page. To estimate the exact costs of the operation, the business can use the ConverZAP WhatsApp API cost calculator.
An important difference applies when the business keeps the app active. According to Meta’s documentation, under coexistence, messages sent manually from the phone remain free. Only sends and automated replies through the API generate costs, which optimizes the budget for businesses that use AI assistants on WhatsApp together with human agents.
Frequently Asked Questions
To migrate a number already registered on another platform, the admin must request disconnection from the current provider. Then open the business platform settings in the app, remove the link, and wait about 15 minutes before connecting to the new system.
Creating a business portfolio on Meta requires valid business details. In Brazil, that usually means a CNPJ (company registration number). Although the initial process allows testing, full business verification, which raises sending and number limits, requires official company documentation.
There is no risk of losing ownership of the line, because the number belongs to the business through its phone carrier. The process only changes the software channel where the messaging service is active.
Meta’s review and approval of the display name is usually quick, ranging from a few hours to one business day. Keeping the business portfolio information organized helps speed up this step.
Yes. Platforms like ConverZAP offer a multi-agent inbox connected to the same number, so the human team can take over the conversation at any time when specialist help is needed.
Conclusion
Choosing the right number for Meta’s official API and understanding the connection requirements prevents blocks and keeps WhatsApp Business operations secure. With the right strategy, a business centralizes customer service and scales results efficiently.
Connect your number to the official API
ConverZAP, a Tech Provider verified by Meta, connects a new number or your WhatsApp Business app number through coexistence, with AI agents and a team inbox.
Start your free trialSee how to connect
