Migrate from WhatsApp Business App to API
Outgrowing the WhatsApp Business App is a good problem to have. It means your business is scaling. The API offers multi-agent support, automation, integrations, and no device dependency. Migration involves moving your phone number from the app to the API, and while the process is straightforward, careful planning prevents disruptions to your customer communications.
Step-by-Step Instructions
- 1
Audit your current WhatsApp Business App setup
Document everything you'll need to recreate: your business profile information, quick replies, labels, auto-reply messages, and any automation you've set up using the app's built-in features. Export your chat history (Settings > Chats > Export Chat) for any important customer conversations since chat history doesn't transfer to the API.
- 2
Set up your API environment first
Sign up with a BSP, complete Meta Business Verification, and configure your entire API setup using a temporary phone number. Build your chatbot flows, set up team access, create message templates, and test everything thoroughly. Don't migrate your actual number until your API environment is fully ready. You want zero downtime for customers.
- 3
Prepare your contacts for the transition
Inform key customers and contacts about the migration, especially if you're using the app to handle active support conversations. Send a broadcast message letting people know you're upgrading your WhatsApp to serve them better. Resolve any open support tickets or ongoing conversations before migrating, as these will be interrupted.
- 4
Delete the WhatsApp Business App from your phone
You must remove the WhatsApp Business App (or regular WhatsApp) from the phone with the number you're migrating. Go to the app, navigate to Settings, and delete your account from within the app. This releases the phone number so it can be registered with the API. Simply uninstalling the app is not enough. You must delete the account.
- 5
Register the number with the API
In your BSP dashboard, initiate phone number registration using the number you just released. You'll receive a verification code via SMS or phone call. Enter the code to complete registration. Your number is now live on the API, and customers can start messaging you immediately.
- 6
Verify and optimize post-migration
Send test messages to confirm everything works. Check that your business profile displays correctly, templates send successfully, and your chatbot responds properly. Monitor incoming messages closely for the first 48 hours. Re-import your contact lists into your BSP and set up any segments or tags you had in the app.
Pro Tips
- Never migrate during peak business hours. Schedule the migration for late evening or early morning when message volume is lowest.
- You can migrate from the free WhatsApp Business App to the API without changing your phone number, but you cannot use both simultaneously on the same number.
- Back up all chat history before migration. There's no way to recover it from the API side after the switch.
- Give your API environment at least a week of testing with a temporary number before migrating your production number.
Ready to get started?
Start your free 14-day trial and put this guide into action.