> ## 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 Coex/API

> Complete guide to onboarding to WhatsApp Coexistence via Eazybe

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

## What is Coexistence?

<CardGroup cols={2}>
  <Card title="Connect to Cloud API" icon="cloud">
    Connect the WhatsApp Business App to the Cloud API seamlessly
  </Card>

  <Card title="Keep Using Business App" icon="mobile">
    Continue using the Business App normally after connection
  </Card>

  <Card title="Sync Everything" icon="arrows-rotate">
    Real-time message and contact synchronization
  </Card>

  <Card title="No Data Loss" icon="shield-check">
    Preserve chat history and contacts without any data loss
  </Card>
</CardGroup>

<Info>
  This is the safest method to migrate to Cloud API without losing data. You can use the same phone number across both the WhatsApp Business App and API.
</Info>

## Prerequisites

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

<AccordionGroup>
  <Accordion title="WhatsApp Business Account" icon="whatsapp">
    You must have an existing WhatsApp Business account/number. **Personal WhatsApp numbers are not supported.**
  </Accordion>

  <Accordion title="App Version" icon="mobile">
    WhatsApp Business App **Version 2.24.17 or newer** is required. Older versions will fail during QR-linking.
  </Accordion>

  <Accordion title="Phone Number Health" icon="heart-pulse">
    Your number must have:

    * Regular WhatsApp activity
    * No Meta restrictions
    * No policy violations
    * Active genuine usage for **3-7 days minimum**
  </Accordion>

  <Accordion title="Facebook Business Page" icon="facebook">
    A Facebook Business Page with **Admin Access** is required.
  </Accordion>

  <Accordion title="Regional Restrictions" icon="globe">
    Numbers from **Nigeria or South Africa** are not currently supported due to Meta regulations.
  </Accordion>

  <Accordion title="Number Eligibility" icon="check-circle">
    Your number must not be:

    * Linked to another WhatsApp API provider
    * Blocked by Meta
  </Accordion>
</AccordionGroup>

## Setup Guide

<Steps>
  <Step title="Enter Email and Login">
    Enter your email address and log in with your account.

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

  <Step title="Enter OTP">
    Enter the OTP sent to your Gmail inbox.

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

  <Step title="Add Number">
    Click **Add Number** to proceed with the embedded sign-up flow.

    <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">
    Enter your Facebook login credentials, or click **Continue as** if your session is 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">
    Click **Continue** on the permissions page to authorize the connection.

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

  <Step title="Fill Business Details">
    Complete the business details form with accurate information.

    <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="Create Business Portfolio">
    Create or choose your business portfolio.

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

    <Warning>
      Always create a **NEW WABA account** for coexistence to ensure fresh usage and healthy flow.
    </Warning>
  </Step>

  <Step title="Choose Onboarding Method">
    Select your onboarding method:

    1. Connect existing WhatsApp business number
    2. Start with new WhatsApp contact number

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

    <Info>
      **Constraints:** Number must not be linked to any other partner, must be a new or existing WhatsApp Business number, and not blocked by Meta.
    </Info>
  </Step>

  <Step title="Enter Phone Number">
    Select your country code and enter your phone number.

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

  <Step title="Scan QR Code">
    Scan the QR Code using 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="QR Code Scan" width="1124" height="560" data-path="images/1908049708.png" />
  </Step>

  <Step title="Import Chat History">
    Choose whether to import chat history:

    * All contacts are imported automatically
    * Optional: Up to **6 months** of 1:1 chats
    * Optional: Up to **2 weeks** of media
    * Group chats are **not** imported

          <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" />
  </Step>

  <Step title="Verify Account">
    Wait for account verification. The connection process takes some time.

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

  <Step title="Complete Setup">
    Click **Finish** to complete the setup process.

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

## Troubleshooting

### Integration Failed

<Warning>
  Common reasons for integration failure:

  * Old WhatsApp version
  * Number inactivity
  * Meta restrictions
  * No Facebook Page admin access
</Warning>

**Solution:** Use another number that has active WhatsApp Business usage and no past violations.

### Chat History Did Not Import

<Steps>
  <Step title="Open WhatsApp Business App">
    Navigate to **Settings > Business Tools > WhatsApp Business Platform**
  </Step>

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

  <Step title="Restart Onboarding">
    Restart the Coex onboarding process from the beginning
  </Step>
</Steps>

<Info>
  If you manually skipped history import initially, you must fully offboard and onboard again to import chat history.
</Info>

### Number Has Meta Restrictions

**Symptoms:**

* Instant failure
* QR code doesn't complete scanning
* No "Connect to Business Platform" message appears

**Solution:** Use a number with zero policy issues and frequent legitimate WhatsApp Business activity.

## FAQs

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

  <Accordion title="Will my chats stay in my phone app?" icon="question">
    **Yes.** Nothing is deleted from the WhatsApp Business App. All your chats remain intact.
  </Accordion>

  <Accordion title="Can I still use the WhatsApp Business App after Coex?" icon="question">
    **Yes.** You can continue using the WhatsApp Business App normally after setting up Coexistence.
  </Accordion>
</AccordionGroup>

## Need Help?

If you have any questions or need further assistance, feel free to reach out to us at [hey@eazybe.com](mailto:hey@eazybe.com). We're happy to help!