> ## Documentation Index
> Fetch the complete documentation index at: https://help.eazybe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding to Coexistence via Eazybe

> Complete guide to connect your WhatsApp Business App phone number to the WhatsApp Cloud API without losing chats, contacts, or requiring re-registration.

## Introduction

WhatsApp Coexistence allows businesses to connect their active WhatsApp Business App phone number to the WhatsApp Cloud API — without losing chats, contacts, or requiring re-registration.

**This guide covers:**

* What Coexistence is
* Prerequisites before onboarding
* Step-by-step setup process
* Common issues and troubleshooting
* FAQs for beginners
* Best practices after onboarding

***

## What is WhatsApp Coexistence?

Coexistence (Coex) allows businesses to:

* Connect the WhatsApp Business App to the Cloud API
* Continue using the Business App normally
* Sync messages and contacts into a Cloud API platform
* Avoid re-registering the number
* Preserve the Verified badge (if applicable)

**Key Benefits:**

* Use the same phone number across both Business App and API
* Real-time message and contact synchronization
* Combine human interaction with automation
* Preserve chat history and contacts
* Maintain access to the familiar WhatsApp Business App interface

<Note>
  This is the safest method to migrate to Cloud API without losing data.
</Note>

***

## Prerequisites

Before starting the onboarding process, ensure you meet these requirements:

<Steps>
  <Step title="WhatsApp Business Account Required">
    Your number must be registered on the WhatsApp Business App. Personal WhatsApp numbers are not supported.
  </Step>

  <Step title="WhatsApp Business App Version 2.24.17 or Newer">
    Older versions will fail during QR-linking. Update your app before proceeding.
  </Step>

  <Step title="Phone Number Health Requirements">
    Your number must have:

    * Regular WhatsApp activity
    * No Meta restrictions
    * No policy violations
    * Active and genuine usage both before and after the Coexistence connection (real 1:1 conversations and consistent activity for at least 3–7 days)
  </Step>

  <Step title="Facebook Business Page with Admin Access">
    You need admin access to a Facebook Business Page to complete the setup.
  </Step>

  <Step title="Meta Business Account Required">
    A Meta Business Account is required for the integration.
  </Step>

  <Step title="Number Eligibility">
    Your number cannot be currently linked to another WhatsApp API provider.
  </Step>
</Steps>

<Warning>
  Numbers from Nigeria or South Africa may be subject to additional Meta regulations and restrictions.
</Warning>

***

## Step-by-Step Onboarding Process

### Initial Setup

<Steps>
  <Step title="Email Login">
    Enter your email address to begin the onboarding process.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908028628.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=b50a846b2a103294685e5a969d954c11" alt="Email Login" width="1050" height="504" data-path="images/1908028628.png" />
  </Step>

  <Step title="Enter OTP">
    Enter the OTP code sent to your email address.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908029950.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=66710991e5929a238956e280a5f43aa4" alt="Enter OTP" width="1895" height="824" data-path="images/1908029950.png" />

    After OTP verification, you will be redirected to the Get Started page.
  </Step>

  <Step title="Click Add Number">
    Click the **Add Number** button to proceed with connecting your WhatsApp number.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908032104.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=ac117ad094789682e61f201c369541f5" alt="Add Number" width="940" height="405" data-path="images/1908032104.png" />
  </Step>

  <Step title="Facebook Login">
    Log in with your Facebook account. You can click **Continue as** if your Facebook login is already saved.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908034817.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=5dbf202a8f15123709a7fed55b412c4b" alt="Facebook Login" width="1102" height="548" data-path="images/1908034817.png" />
  </Step>

  <Step title="Grant Permissions">
    Review the permissions page and click **Continue** to proceed.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908035914.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=a520653ab5a15d0f4924874d336a39db" alt="Permissions Page" width="734" height="859" data-path="images/1908035914.png" />
  </Step>

  <Step title="Fill Business Details">
    Enter your business information in the required fields.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908036666.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=b30adc381688434e2cf81c2dda9b46be" alt="Business Details" width="1098" height="562" data-path="images/1908036666.png" />
  </Step>

  <Step title="Choose or Create Business Portfolio">
    Select an existing business portfolio or create a new one.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908037094.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=5bbba6f26b07296681b855a771592730" alt="Choose Business Portfolio" width="1100" height="562" data-path="images/1908037094.png" />

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908040842.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=b1674d4f050de06bcc79a9d1cecb109b" alt="Create New WABA" width="745" height="883" data-path="images/1908040842.png" />
  </Step>
</Steps>

<Tip>
  Always create a **NEW WABA account** for the coexistence setup. This ensures fresh usage and a healthy connection flow.
</Tip>

***

### Choose Your Onboarding Method

You have two options:

1. **Connect existing WhatsApp Business number** — Recommended for most users
2. **Start with a new WhatsApp contact number**

<Warning>
  **Constraints:**

  * Number cannot be currently linked to another partner
  * Must be a new or existing WhatsApp Business number
  * Number cannot be blocked by Meta
</Warning>

***

### Connect Existing WhatsApp Business Number

<Steps>
  <Step title="Enter Phone Number">
    Select your country code and enter your phone number, then click **Next**.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908044314.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=c70d95671e9a3135becd70897903f4fc" alt="Enter Phone Number" width="1112" height="560" data-path="images/1908044314.png" />
  </Step>

  <Step title="Scan QR Code">
    A WhatsApp message will be sent to your number. Click **Scan QR Code** and scan the displayed code with your WhatsApp Business App.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908049708.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=4359e2d8d60aef655f19826561f756ff" alt="Scan QR Code" width="1124" height="560" data-path="images/1908049708.png" />
  </Step>

  <Step title="Choose Chat History Import">
    After scanning the QR code, configure your import preferences:

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908050113.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=76ddd25b0f9fc008fc60d72c8a3e84a7" alt="Chat History Import" width="954" height="502" data-path="images/1908050113.png" />

    * **Contacts:** All contacts are imported automatically
    * **1:1 Chats:** Optional — Import up to 6 months of chat history
    * **Media:** Optional — Import up to 2 weeks of media files
    * **Group Chats:** Not imported
  </Step>

  <Step title="Wait for Account Verification">
    Your account will be verified. This process may take some time.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908052548.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=b6f92960ba1ea02f81d2312f1795b9a9" alt="Account Verification" width="1124" height="560" data-path="images/1908052548.png" />
  </Step>

  <Step title="Click Finish">
    Once verification is complete, click **Finish** to complete the setup.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908055256.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=45b2232ba8c0f0a0385491758a826ec4" alt="Finish Setup" width="1132" height="570" data-path="images/1908055256.png" />
  </Step>
</Steps>

***

## Troubleshooting

### Issue 1: Integration Failed

**Common reasons:**

* Old WhatsApp version
* Number inactivity
* Meta restrictions
* No Facebook Page admin access

<Tip>
  **Solution:** Use another number with active WhatsApp Business usage and no past violations.
</Tip>

***

### Issue 2: Chat History Did Not Import

If the import fails, follow these steps:

<Steps>
  <Step title="Open WhatsApp Business App">
    Launch the WhatsApp Business App on your phone.
  </Step>

  <Step title="Navigate to Settings">
    Go to **Settings → Business Tools → WhatsApp Business Platform**.
  </Step>

  <Step title="Disconnect">
    Tap **Disconnect** to remove the current connection.
  </Step>

  <Step title="Restart Onboarding">
    Start the Coexistence onboarding process again from the beginning.
  </Step>
</Steps>

<Warning>
  If you manually skipped history import initially, you must fully offboard and onboard again. Note that chat backups may not restore if you chose the wrong option during the initial signup.
</Warning>

***

### Issue 3: Number Has Meta Restrictions

**Symptoms:**

* Coexistence onboarding fails instantly
* QR code doesn't complete
* No "Connect to Business Platform" message appears

<Tip>
  **Solution:** Use a new number with zero policy issues and frequent legitimate WhatsApp Business activity.
</Tip>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I use a personal WhatsApp number?">
    No. Only WhatsApp Business App numbers are allowed for Coexistence.
  </Accordion>

  <Accordion title="Will my chats stay in my phone app?">
    Yes. Nothing is deleted from the WhatsApp Business App. Your existing chats remain intact.
  </Accordion>

  <Accordion title="Can I still use the WhatsApp Business App after Coex?">
    Yes. You can continue using the WhatsApp Business App normally while also benefiting from the Cloud API integration.
  </Accordion>
</AccordionGroup>

***

## Related Articles

* [Getting Started with Your Official WhatsApp Business Account (WABA)](/en/waba/overview)
* [How to Connect Your WhatsApp Business Account (WABA) to Eazybe](/en/waba/connect-waba)
* [WABA: Frequently Asked Questions (FAQ)](/en/waba/faq)