> For the complete documentation index, see [llms.txt](https://learn.doubletick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.doubletick.io/get-started-with-doubletick/migration/cloud-api-to-coex-migration-guide.md). # Cloud API to CoEx migration guide Learn how to move a WhatsApp number from Cloud API to Coexistence on DoubleTick, including the mandatory 7-day WhatsApp Business App waiting period. If your WhatsApp phone number is currently connected to DoubleTick through Cloud API and you want to switch to Coexistence, this guide walks you through the full migration process from start to finish. In Cloud API, your number is connected exclusively to the WhatsApp API. In Coexistence, the same number can be used simultaneously on both the WhatsApp Business App and the WhatsApp API through DoubleTick — giving you the flexibility to manage conversations from both the app and the platform at the same time. #### What's covered * [What happens during this migration](/get-started-with-doubletick/migration/cloud-api-to-coex-migration-guide.md#what-happens-during-this-migration) * [What you need before you begin](/get-started-with-doubletick/migration/cloud-api-to-coex-migration-guide.md#before-you-begin) * [Assets you may lose after deleting the number](/get-started-with-doubletick/migration/cloud-api-to-coex-migration-guide.md#important-assets-you-may-lose-after-deleting-the-number) * [Step-by-step migration process](/get-started-with-doubletick/migration/cloud-api-to-coex-migration-guide.md#step-1-delete-the-phone-number-from-facebook-business-manager) * [Key takeaways](/get-started-with-doubletick/migration/cloud-api-to-coex-migration-guide.md#key-takeaways) * [Frequently asked questions](/get-started-with-doubletick/migration/cloud-api-to-coex-migration-guide.md#frequently-asked-questions) #### What happens during this migration Migrating from Cloud API to Coexistence is a multi-step process. You'll need to delete the number from Facebook Business Manager, re-register it on the WhatsApp Business App, use it actively for seven days, link it to the correct Meta Business Portfolio, and then complete Coexistence onboarding inside DoubleTick. #### Before you begin Make sure you have: * **Admin access** to the correct Meta Business Portfolio. * Access to **business.facebook.com**. * Access to your **DoubleTick account**. * Access to the **phone number** you want to migrate. * The ability to receive an **OTP** via SMS or phone call. * A **mobile device** where you can install or access the WhatsApp Business App. #### Important: assets you may lose after deleting the number {% hint style="warning" %} When you delete a phone number from Facebook Business Manager, you may permanently lose approved message templates, your current messaging limit, Official Business Account (OBA) status, and any webhook or integration setup associated with the number. This action cannot always be reversed — make sure you understand the impact before deleting the number. {% endhint %} #### **Step by step migration process** **Step 1: Delete the phone number from Facebook Business Manager**\ To start, remove your phone number from its existing Cloud API configuration in Meta. Log in to [business.facebook.com](https://business.facebook.com) with admin access, open the correct **Business Portfolio**, and go to **Business Settings → Accounts → WhatsApp Accounts**. Select the WhatsApp Business Account containing your number, delete the phone number, and confirm. Wait a few minutes for Meta to update before moving to the next step. **Step 2: Register the number on the WhatsApp Business App**\ Download and open the **WhatsApp Business App** on your phone, then enter the same phone number you deleted from Facebook Business Manager and verify it using the OTP. Once verified, complete your business profile setup in the app. {% hint style="warning" %} Once set up, you must use the WhatsApp Business App actively for seven days before you can onboard the number on Coexistence. This waiting period is a requirement from Meta and cannot be skipped. {% endhint %} {% embed url="" %} **Step 3: Link the number to your Meta Business Portfolio**\ After the 7-day waiting period, log in to business.facebook.com, open the correct Business Portfolio, and go to **Accounts → WhatsApp Accounts**. Click **Add → Link a WhatsApp Business Account**, enter your phone number with the country code, and click Continue. Meta will send a verification code to your WhatsApp Business App. Open the app, enter the code in the pop-up, and click Continue to link the number to your Meta Business Portfolio. {% embed url="" %} **Step 4: Complete Coexistence onboarding on DoubleTick** * Log in to your DoubleTick account using your registered mobile number and OTP, then go to **Settings** → **Manage Channels** and click **Connect new channel**. In the pop-up, select **Add Number using Embedded Sign-up**, then choose **Coexistence Onboarding**, select **Connect Your Existing WhatsApp Business Number**, and click **Confirm and Proceed**. * Log in to Facebook if needed and click **Continue**, then select the correct Business Portfolio, open the **WhatsApp Business Account** dropdown, select **Connect WhatsApp Business App**, and click **Next**. Enter the same phone number with the country code and click **Next** — if you see an option like **Connect Existing Business App**, click **Next** again. * A QR code will appear: open the WhatsApp Business App on your mobile phone, tap **Connect** on the message from Facebook Business, and scan the QR code with your camera. The import of your contacts and chat history from the last 6 months begins automatically, so wait for it to complete. Select your correct time zone, click **Next**, then click **Confirm**. * Once connected, click **Finish** — the status will change to **Connected** once setup completes. Your WhatsApp Business number is now successfully migrated from Cloud API to Coexistence on DoubleTick — you can now use the same number on both the WhatsApp Business App and the DoubleTick platform simultaneously. #### Key takeaways * This migration involves deleting the number from Facebook Business Manager, re-registering it on the WhatsApp Business App, and completing Coexistence onboarding on DoubleTick. * Deleting the number may permanently lose approved templates, messaging limits, OBA status, and webhook or integration setup — review this carefully before proceeding. * Meta requires the number to be active on the WhatsApp Business App for seven days before it can be onboarded on Coexistence. This waiting period cannot be skipped. * After migration, the number works simultaneously on both the WhatsApp Business App and DoubleTick. #### Frequently asked questions **What do I lose when I delete the number from Facebook Business Manager?**\ You may permanently lose approved message templates, your current messaging limit, Official Business Account status, and any webhook or integration setup tied to the number. Review this carefully, as it can't always be reversed. **Why do I need to wait 7 days before onboarding on Coexistence?**\ Meta requires the number to be actively used on the WhatsApp Business App for 7 days after registration before it's eligible for Coexistence onboarding. This requirement cannot be skipped. **Can I use the number on both the app and DoubleTick after migrating?**\ Yes — that's the point of Coexistence. Once migrated, the number works simultaneously on the WhatsApp Business App and the DoubleTick platform. **What access do I need before starting this migration?**\ Admin access to the relevant Meta Business Portfolio, access to business.facebook.com and your DoubleTick account, access to the phone number, and the ability to receive an OTP. **How much chat history transfers during this migration?**\ Up to the last 6 months of contacts and chat history import automatically once you scan the QR code during Coexistence onboarding. #### Related topics * [Getting Started with Co-Existence](/co-existence/getting-started-with-co-existence.md) * [How to onboard a phone number on Coexistence](/get-started-with-doubletick/onboarding/how-to-onboard-a-phone-number-on-coexistence.md) * [How to Manage Channels](/settings/how-to-manage-channels.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://learn.doubletick.io/get-started-with-doubletick/migration/cloud-api-to-coex-migration-guide.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.