Account Migration
This guide assists users with all migrations use cases.
Migration Guide: Moving a WhatsApp Number from API to Coexistence
Overview
If your WhatsApp number is currently connected to another provider via the WhatsApp Business Platform (API), moving it to Coexistence (WhatsApp Business app + API) requires a specific migration path. You cannot switch directly β the number must be disconnected, re-registered on the WhatsApp Business app, warmed up, and only then connected to Chakra.
Estimated timeline: Up to 1 week (depends on how quickly you complete the warm-up period).
Phase 1: Disconnection (Day 0)
Goal: Free the number from any existing API connection.
- Contact your current provider and request a complete disconnection/unlink of the number from the WhatsApp Business Platform.
- Confirm with them that the number is fully released and no longer has any active API connection.
- Do not attempt to register the number on the WhatsApp Business app until the disconnection is confirmed.
β οΈ Important: If the number is still linked to an API provider, you will not be able to register it on the WhatsApp Business app. Wait for written confirmation from your current provider.
Phase 2: Registration & Warm-up (Days 1β7)
Goal: Re-register the number on the official WhatsApp Business app and establish normal business activity before connecting to Chakra.
Step 2.1 β Register on the WhatsApp Business App
- Download the official WhatsApp Business app on a mobile device.
- Register the number using the official instructions:
π How to register your WhatsApp Business account - Complete your business profile (name, category, description, address, etc.).
Step 2.2 β Establish Activity (Warm-up Period)
Use the app actively for 4 to 7 days. This is a mandatory warm-up period to establish normal business behavior.
Recommended warm-up actions:
- Send messages to 7β10 different contacts.
- Reply to incoming messages from those contacts.
- Keep conversations natural β avoid bulk blasts or automated spam.
- Use the app daily for normal business communication.
β³ Do not skip this step. Connecting to Coexistence too early can cause verification delays or number restrictions.
Phase 3: Connection to Chakra (After Warm-up)
Goal: Connect the warmed-up number to Chakra via Coexistence.
- After the number has been active on the WhatsApp Business app for at least 4β7 days, proceed with the Coexistence connection inside Chakra.
- Follow the step-by-step guide:
π Connect WhatsApp via Coexistence - During onboarding, refer to the complete setup guide if needed:
π All-in-One Account Setup Guide
Once connected, your number will operate in Coexistence mode β available on both the WhatsApp Business app and Chakraβs API.
Quick Checklist
Phase | Task | Status |
|---|---|---|
1 | Contact current provider to disconnect/unlink the number | β |
1 | Receive confirmation that the number is fully released | β |
2 | Download WhatsApp Business app and register the number | β |
2 | Complete business profile | β |
2 | Send/reply to 7β10 different contacts over 4β7 days | β |
3 | Connect the number to Chakra via Coexistence | β |
3 | Verify the number appears in Chakra WhatsApp Setup | β |
Important Notes & Caveats
- Downtime: The number will be unavailable on any API during Phase 1β2. Plan customer communication accordingly.
- Chat history: Disconnecting from the API does not automatically migrate previous chat history. Back up any important conversations before disconnection.
- Templates: Existing message templates may need to be recreated or resubmitted after Coexistence connection. Check with Chakra support.
- Warm-up is mandatory: Skipping or rushing the warm-up period increases the risk of number restrictions or failed verification.
- One device: The WhatsApp Business app must remain active on a mobile device for Coexistence to work.