How to migrate from regular WhatsApp to the Official API without breaking your operation
Migration is scary because it involves a new number, Meta approval, new costs and tool changes. But it can be done in 2-3 weeks without losing a single conversation.

If you still use the regular WhatsApp Business app (the "green B" version on your phone) for support, sooner or later you'll hit the ceiling. And when it hits, the problem doesn't announce itself: it shows up as a number banned on Friday night, or as a salesperson who quit and walked out with all the conversations, or as three people answering the same customer without knowing.
The solution is to migrate to the WhatsApp Official API (Meta's "WhatsApp Business Platform" or "Cloud API"). It's not trivial, but it's not the seven-headed beast people make it out to be either. This text is the guide I wish I'd had the first time I went through this.
We'll cover:
- Why migrate (and when it's not yet worth it)
- What changes in practice — what improves, what gets worse
- How much it costs (real numbers, not marketing estimates)
- How to migrate keeping the same number and history
- The most common mistakes that block Meta approval
- Realistic timeline — how long each step takes
Let's go.
Why migrate (and when it's not worth it yet)
Before anything, it's worth understanding if you actually need to migrate. Migrating because of trend is waste. Migrating late is a headache.
You need to migrate if:
- More than 2 people answering the same number
- Receiving more than 200 new messages per day
- Want to integrate WhatsApp with CRM, order system, or AI
- Need to send campaign messages (broadcast) to a customer list
- Already had a number banned for intense commercial use
- Want history that survives a salesperson leaving
- Need serious support reports and metrics
If you're still structuring basic support before migrating, it's worth starting with the master guide on how to sell more on WhatsApp in 2026 — it covers what needs to be right before the API.
You don't need to migrate yet if:
- You're a one-person business, low volume (up to ~100 messages/day)
- You don't use any automation or integration
- You don't send mass campaigns
- You're testing the channel — haven't validated it's worth the effort
For this small profile, regular WhatsApp Business solves it, with the caveat that the ceiling comes fast. When it does, it's time to migrate.
What changes in practice
The biggest confusion is thinking the Official API is "more advanced regular WhatsApp." It's not. They're different things, with different audiences.
What gets better
- Multiple agents on the same number: 5, 10, 50 reps can answer the same number simultaneously, with shared inbox.
- Permanent and centralized history: conversations live on the server, not on the rep's phone. Rep leaves, history stays.
- No risk of ban for volume: the API was built for intense commercial use. You can send thousands of messages per day fearlessly (within Meta's rules).
- Real integrations: connects with CRM, ERP, e-commerce, AI, automations. All via API.
- Green "Official Business Account" badge when approved (boosts customer trust).
- Approved templates for proactive messages (campaigns) — without these, you can't initiate a conversation.
- Webhooks that notify your system in real time when a message arrives.
What gets worse (or requires adaptation)
- You don't use the green app on your phone — all support runs through the CRM/inbox tool you choose.
- Proactive messages require Meta-approved templates (24h-48h to approve). You can't "just send a message" to a new customer — you need a template.
- There's a "24-hour window": after the customer messages you, you have 24h to reply freely. Past that, only template messages.
- You pay per conversation (not per message). More on cost below.
- You can't send naturally recorded audio from the rep's phone — has to be recorded and sent via inbox.
- No traditional "online" status from the app — the customer sees "business number" and can't see when you're typing.
Most of these changes are acceptable trade-offs for those who need to scale. But you should understand them before migrating, because there's no point complaining after.
How much it really costs
Information here gets confusing because Meta changed the billing model in 2025 (to a "per conversation" model) and announced another adjustment in 2026. Here are valid numbers for April 2026.
Meta's billing model
Meta charges per conversation (24-hour session between you and a customer), not per message. Official rates live in the WhatsApp Business Platform pricing documentation — always verify there before any planning, since Meta updates frequently. The categories are:
- Service (customer-initiated support, e.g., customer asks a question): free within the 24-hour window, generally
- Marketing (you start a conversation via promotional template): most expensive, ~$0.06 to $0.16 per conversation depending on country
- Utility (transactional messages: order confirmation, reminder, OTP): mid-range, ~$0.03 to $0.06
- Authentication (verification codes): cheapest, ~$0.01 to $0.03
For most businesses, conversations initiated by the customer are free — so Meta's cost is low if you don't run many marketing campaigns.
BSP cost (Business Solution Provider)
You can't access the API directly. You have to go through a BSP — Meta-authorized provider (official list at developers.facebook.com). CRM Whats Pro is one, others include Twilio, 360Dialog, Take Blip, etc.
Each BSP has its own pricing model. Most charge:
- Fixed monthly fee for access ($20 to $200+, depending on plan)
- Markup per conversation (some) or conversation billed directly by Meta (others)
- Included: inbox, automations, integrations — depends on plan
Typical SMB scenario (2,000 conversations/month, 90% customer-initiated, 200 campaigns):
- BSP monthly fee: $60 to $160/month
- Customer-initiated conversations: 1,800 × $0 = $0
- Marketing conversations: 200 × $0.10 = $20/month
- Total: $80 to $180/month
Compare with the "invisible cost" of regular WhatsApp: a banned number = losing the entire customer base on that number. That risk alone justifies migration.
How to migrate keeping the same number (and history)
This is the most-asked question: "will I lose my number?". No. But you have to do it the right way.
Step-by-step migration with number retention
1. Pre-migration (1-2 days):
- Full backup of WhatsApp Business conversations (Settings → Chats → Backup)
- Note important contacts in a spreadsheet (name, number, conversation status)
- Notify key customers about the transition (optional but recommended)
2. BSP onboarding (3-7 days):
- Choose the BSP (CRM Whats Pro, Twilio, etc) and open an account
- Register your Meta Business Manager (if you don't have one, create — takes 1 day)
- Verify your business in Business Manager (submit documents: tax ID, address proof, etc — Meta approves in 1-5 days)
3. Request number transfer (1-3 days):
- In the regular WhatsApp Business app, open Settings → API → "Migrate number to WhatsApp Business Platform"
- Enter the code provided by your BSP
- The number is unlinked from the phone and migrated to the API
4. Initial setup on the new platform (1-3 days):
- Set up business profile (photo, description, hours, address)
- Import contacts from the spreadsheet
- Configure initial templates and submit for approval (Meta approves in 24-48h)
- Train the team on the new interface
5. Test and go-live (1-2 days):
- Test the support flow with 2-3 pilot customers
- Verify notifications, distribution, integration with CRM/AI
- Officially turn on for all reps
Realistic total: 2-3 weeks start to finish, counting Meta approvals. (To see this in practice, we recorded the entire migration process on video — available on our YouTube channel and with a written checklist at help.crmwhatspro.com.)
What happens to history
Here's the part nobody talks about clearly: history of previous conversations is NOT imported to the API. Meta doesn't allow this.
What you can do:
- History stays in the local backup you made before migrating (Google Drive, iCloud)
- Contact list can be imported into the CRM customer base
- From go-live onward, all new history is permanent on the platform's server
In practice, the history discontinuity affects you less than it seems. Most active customers come back within 7-30 days and start the new history naturally. Old contacts you need to preserve can be exported manually as reference.
Stop losing leads on WhatsApp.
CRM Whats Pro centralizes support, automations, and AI in a single platform. Try free for 7 days.
Start free trial →The most common mistakes that block Meta approval
Meta has criteria for approving a business account. If you fall into any of the items below, your approval gets stuck — or worse, gets rejected and you go into quarantine.
Mistake 1: poorly configured Business Manager
Before requesting API, your business needs to be verified in Meta's Business Manager. This requires:
- Active tax ID
- Commercial address (not residential) matching official records
- Official website with your own domain (don't just use Linktree or Instagram)
- Corporate email (@yourcompany.com), not Gmail/Hotmail
Without this, Meta rejects or asks for more documentation — adding weeks to the process.
Mistake 2: industry policy violation
Some industries are prohibited or restricted by Meta's commercial policy:
- Gambling and games of chance
- Tobacco and related products
- Weapons and ammunition
- Supplements with curative claims
- Unregulated crypto assets
- Adult content
If your business falls in any gray area, Meta may reject even if you have everything else right. Worth checking the official commercial policy before starting.
Mistake 3: templates rejected in sequence
Message templates are reviewed by Meta. Common rejection reasons:
- Aggressive commercial language: "BUY NOW!!!", "LAST CHANCE!"
- Variables without context:
{{1}} your offer {{2}}(can't tell what'll appear) - Poor formatting: all caps, excessive emojis
- Suspicious links: shorteners (bit.ly, etc) tend to get rejected
- Outcome promise: "guaranteed to double your sales"
Approved templates have clear, professional language with explained variables and obvious context. Try three; if three templates are rejected, your account goes into manual review and slows down.
Mistake 4: spam right after go-live
Even if your account is approved, you start with a low daily message limit (1,000 unique contacts in the first 30 days, typically). If you fire off broadcasts to 50,000 contacts on day one, Meta limits or bans you.
Right strategy: scale slowly. First week, only reactive support. Second week, first small broadcast (100-500 contacts). Increase gradually. In 2-3 months you unlock the high limit.
Mistake 5: ignoring the 24-hour window
Customer messaged Monday. You only reply Wednesday. Now you can't send free messages anymore — only templates. This breaks the conversation and you start looking unprofessional.
The fix is simple but requires discipline: every new message gets a reply within 24h (ideally 5 minutes, but minimum the next business day). Use AI to cover overnight and weekends if needed.
Realistic migration timeline
Summary of what to expect:
| Step | Duration | Depends on |
|---|---|---|
| Decide BSP and open account | 1-3 days | You |
| Verify Business Manager | 1-5 days | Meta |
| Request number transfer | 1-3 days | Meta |
| Configure profile + templates | 2-5 days | You + Meta (template approval) |
| Train team + pilot tests | 3-7 days | You |
| Go-live + stabilization | 2-4 weeks | You + customers |
Realistic sum: 2-3 weeks to have everything running. Add another 2-4 weeks of "stabilization" — period when your team gets used to it, you adjust processes, and new templates get approved.
The gains that appear (and when they appear)
To close with the right expectations:
Week 1 post-migration:
- Shared inbox working — visible who's handling what
- Real-time notifications
- Initial sense of "phew, no more lost leads"
Month 1:
- First response time drops 40-60%
- Team stops asking "can someone reply to WhatsApp?"
- You start having real support data
Month 2-3:
- First automation starts taking repetitive load off the team
- History becomes an asset (rep checks old conversation, closes a sale)
- Metrics start showing what's going well or badly
Month 4-6:
- Well-configured AI absorbs 50-80% of conversations
- Team focuses only on closing and negotiation
- Migration ROI becomes obvious (typically pays back in 2-4 months)
To get a clear pipeline structure after migration, the 7 stages of the WhatsApp sales funnel serve as a map of what each conversation should advance through.
Migration isn't comfortable. There are bad weeks, reps complaining about the new interface, some campaign that doesn't fire as expected. But it's an investment that pays — because the regular WhatsApp ceiling arrives, and hits hard when it does.
Better to migrate before the problem than after the ban.