Meta Business API Compatibility & Rules
Ensure your number complies with Meta’s technical specifications before initiating migration.
Accepted Numbers
Accepts mobile, landline, and virtual numbers capable of receiving international SMS or voice calls.
Blocked Regions
Meta restricts numbers matching country codes for Crimea, Cuba, Iran, North Korea, and Syria from creating API accounts.
Single API Client
A single phone number cannot connect to multiple API accounts simultaneously. Separate numbers are required for distinct accounts.
Normal Operations
Standard voice calls and cellular carrier SMS will work as usual. Only app-based WhatsApp features migrate to the API.
Step-by-Step Migration Guide
Follow this precise workflow to transition your active number to the API without configuration locks.
Manual Chat Backup
Open WhatsApp on your device, navigate to Settings > Chats > Chat Backup and trigger a manual backup. For business-critical conversations, export individual chat logs as TXT files, since API transition permanently deletes standard cloud backups.
Meta Manager Registration
Log into your **Meta Business Suite Manager**, add your phone number under Business Settings, and specify your **Display Name**. Submit the Display Name for approval. It must directly align with your business branding guidelines, or campaigns won't schedule.
Delete Existing App Account
Open WhatsApp on your mobile device. Go to Settings > Account > Delete my account. Enter your number in full international format and execute deletion.
Important: Do not just uninstall the app. You must trigger the account deletion settings, then wait at least 3 minutes before attempting to register the API to let Meta's database clear.
Partner API Linkage & OTP
Trigger the Embedded Signup flow in your partner interface (Wati, Brevo, AiSensy, etc.). Request the 6-digit OTP verification via SMS or Voice call. If using an IVR system, ensure you have set up a temporary bypass routing rule to capture the validation code.
Final Verification & Sync
Once verified, your API client is active. Note that incoming messages sent while the deletion was active may take a few minutes to queue and deliver. If you get Access Denied (Error 1005), wait 5 minutes and try again.
Using Toll-Free / 1-800 Numbers behind an IVR?
Because WhatsApp's automated verification calls cannot navigate interactive phone trees (e.g. "press 1 for support"), you must open a Meta Direct Support ticket. Request the originating numbers for the validation calls (usually 1 or 2 static numbers), allow-list them in your IVR configuration, and route them directly to a physical handler extension to capture the code.
Frequently Asked Questions
Got questions? Here are detailed answers addressing WhatsApp Business API setups.