Client Documentation
Get StartedStatus Page
  • 360Dialog
    • Why you should use 360dialog as Business Solution Provider (BSP)
    • Prices, plans and payment options
  • client hub
    • 360Dialog Client Hub
    • Numbers
      • Manage your WABA
        • Account Statuses
    • Activity
    • Funds
      • Month Closing Invoice (MCI)
    • Payment Management
    • API Keys
    • Template Message Management
    • Partner Change
    • Cancellation
    • Downgrade
  • WhatsApp Marketing
    • Best practices to maintain Account Health and prevent being blocked
    • Driving users to your WhatsApp account
      • WhatsApp Channels
    • Business Search
    • Linking a WABA to a Facebook Page /EN
      • Vinculando uma conta WABA à uma página do Facebook /PT
      • Cómo vincular un WABA a una página de Facebook /ES
    • Linking a WABA to Google Message Ads
    • Ads that Click to WhatsApp (CTWA) /EN
      • Anúncios de Clique para o WhatsApp (CTWA) /PT
        • Como usar o WhatsApp para marketing e vendas? /PT
      • Anuncios que Click to WhatsApp (CTWA) /ES
        • ¿Cómo usar WhatsApp para marketing y ventas? /ES
    • Conversions API (CAPI)
    • Create Ads lookalike audience based on WhatsApp events
    • MM Lite API Beta
      • Onboarding
      • Sending Messages
  • waba basics
    • WhatsApp Business Platform
    • WhatsApp Accounts structure
    • WABA for Government Agencies
    • WABA Policy Enforcement
    • Architecture and Security
    • The Basics (Overview)
    • Webhook Events and Notifications
    • Messaging API
      • Messaging Health Status
      • Step to Step to move to Cloud API
        • [will be deprecated] WABA Integration (On-Premise)
    • Migrating Phone Numbers
      • Migrate number from Meta or alternate BSP to 360dialog Cloud API
      • Migrate a phone number to a new WABA
      • Migrate to alternate BSP
  • waba management
    • Creating new WABA
      • Using a new phone number
      • WhatsApp Coexistence
        • Coexistence Onboarding
        • Coexistence Webhooks
    • Display Name Guidelines
    • Meta Business Verification
    • Official Business Account (OBA) or blue badge
    • WABA Profile Info
    • Capacity, Quality Rating, and Messaging Limits
      • Accelerated Onboarding
    • Hosting type Change
  • waba Messaging
    • Sandbox (Test API Key)
    • Receiving messages
    • Before sending a message
      • Checklist for Message Broadcasts and Campaigns
    • Conversations
    • Messaging
    • Conversational Components
    • Media Messages
      • Upload, retrieve or delete media
    • Template Messages
      • Template Elements
      • Sending Template Messages
      • Authentication Templates
        • Zero-Tap Authentication Templates
        • One-Tap Autofill Authentication Templates
        • Copy Code Authentication Templates
      • Catalog Templates
      • Product Card Carousel Templates
      • Single-Product Message Templates
      • Coupon Code Templates
      • Limited-Time Offer Templates
      • Multi-Product Templates
    • Interactive Messages
      • Single and Multi Product Messages
      • Location Request Message
    • Flows
    • Products & Catalogs
    • Contacts and Location Messages
    • Payments (India Only)
      • Receive WhatsApp Payments via Payments Gateway
      • Receive WhatsApp Payments via Payment Links
      • Order Details Template Message
    • Payments (Singapore only)
      • Receive WhatsApp Payments via Stripe
  • Partners
    • Partner Documentation
  • Support
    • Help and Support
      • Opening Hours & Response Time
      • Status Pages
      • Meta Support
      • Common Issues
    • Error Messages
    • Imprint & Data Privacy
    • FAQ
Powered by GitBook
On this page
  • WhatsApp Coexistence
  • Why Use WhatsApp Coexistence?
  • Key Benefits
  • How it works
  • Sessions and Pricing
  • Linked devices
  • Limitations
  • Geo Restrictions
  • Important Notes
  • FAQ
  • Getting Started: Account Creation

Was this helpful?

  1. waba management
  2. Creating new WABA

WhatsApp Coexistence

You now have the possibility of onboarding a number to the WhatsApp Cloud API even if it is already connected to the WhatsApp Business App.

WhatsApp Coexistence

Onboarding a number already registered with the WhatsApp Business App allows you to enable API functionalities without losing chat history and while maintaining access through the mobile app.

This feature enables both interfaces to coexist using the same phone number, allowing businesses to use the benefits of both platforms simultaneously: message at scale and still have the ability to send messages via WhatsApp Business App. You can find a reference to this functionality as "WhatsApp Coexistence", or "Coex" in this documentation.

Why Use WhatsApp Coexistence?

By enabling Coexistence, your business can enjoy the full capabilities of the WhatsApp API—such as API messaging, Meta Insights, Click-to-WhatsApp (CTWA) campaigns, and more—without losing their existing number, messaging history, or audience.

This is ideal for businesses looking to scale their messaging strategies, while maintaining their current setup. Messages will be mirrored between the mobile App and the API, using echoes.

💬 Message echoes:

  • Messages sent via the API will appear in the WhatsApp Business App.

  • Messages sent via the App will appear in the Cloud API conversation history.

Key Benefits

  • Maintain access to the WhatsApp Business App while using the WhatsApp Business API.

  • Message at scale via the API while retaining one-to-one messaging in the app.

  • Simplifies migration for businesses already using WhatsApp Business App.

How it works

Sessions and Pricing

Once Coexistence is enabled, sessions from the WhatsApp Business App and the Cloud API are treated independently.

Here’s how the pricing works across different scenarios:

1

Scenario 1: The end-user sends a message, and your business replies via the WhatsApp Business App.

✅ No charge — messages through the App are free.

2

Scenario 2: The end-user sends a message, and your business replies via the Cloud API.

3

Scenario 3: Your business initiates a message to the end-user via Cloud API.

4

Scenario 4: The end-user sends a message, you reply via the App, and later want to send a message through Cloud API.

5

Scenario 5: The end-user sends a message, you reply via Cloud API, and then continue the conversation through the App.

✅ No additional charge — the Cloud API session is a service conversation, and App usage is free.

In summary:

  • Sessions from WhatsApp Business App and Cloud API run in parallel and do not interfere with each other.

  • Cloud API conversations are charged as usual; template messages are still required to initiate conversations.

  • Messages via the WhatsApp Business App remain free regardless of Cloud API usage.

Clients will also need a 360dialog account and subscription plan, as Cloud API usage and fees are charged normally.

Linked devices

However, after onboarding to Cloud API, all companion apps will be unlinked, you can re-link only supported devices after onboarding.

  • Messages from unsupported companion devices will not trigger webhooks, so the business won't be able to mirror the message through the API. You can still use the App to respond to this message.

Messages viewed on an unsupported companion device will show a placeholder text instructing users to check their primary device.

While WhatsApp users can still message an onboarded business from an unsupported companion client, these messages will not trigger smb_message_echoes webhooks, meaning the business will be unable to mirror them in their app.

Limitations

Coexistence is not compatible with APIs that are not officially supported. So, if that’s your use case, please know that those will be deactivated and 360Dialog cannot offer support for unofficial products.

Geo Restrictions

Important Notes

✅ You can sync message history from the WhatsApp Business App into the Cloud API. ❌ Do not uninstall the WhatsApp Business App—doing so will disconnect the account 🔁 You must open the WhatsApp Business App at least once every 13 days to keep the account active.

Chat history sync for direct clients (clients who do not have an integration partner) may require additional setup. Please reach out to support before onboarding.

FAQ

Eligibility for WhatsApp Business API Access

While the WhatsApp Business API is now accessible for App numbers, it is intended for businesses that are already actively using the WhatsApp Business App and looking to scale their messaging capabilities. Businesses with newly created Business App accounts are not immediately eligible for API access.

Eligibility is determined based on factors such as account tenure and messaging quality to ensure a reliable and effective messaging experience. Meta recommends businesses to use Coexistence only if they are already using the WhatsApp Business App consistently and can benefit from advanced API tools to scale operations.

Are marketing messages sent from a Partner platform via Cloud API supported on the WhatsApp Business App?

Yes, both the WhatsApp Business App and Cloud API support the same types of messages, including Marketing, Utility, Service, and Authentication messages.

Can a business using the Coexistence via Cloud API switch back to WhatsApp Business App with the same number?

Yes. To disconnect your number from the Cloud API, go to Settings > Account > Business Platform and click the Disconnect button.

⚠️ Important: Please do not disconnect the app without first consulting our team to ensure you don’t lose any data and to understand the implications.

  • Stop sending messages from your phone number? You do not need to disconnect the number; simply stop sending messages.

  • Remove access to the app? This is not possible through the API.

Can a business use their WhatsApp API number to register on the WhatsApp Business App?

No, this process only works for numbers registered in the App. If the number is connected to the WhatsApp API, this CoExistence Onboarding won't work.

Is this solution applicable to larger enterprises?

The primary use case is to assist SMBs that have not previously onboarded to the WhatsApp Business API. The solution is not specifically designed for larger enterprises.

Will businesses with Meta Verified blue badges on WhatsApp Business App maintain their verification when connecting to the WhatsApp Business API?

Getting Started: Account Creation

To onboard an existing number to the WhatsApp Business API, see our documentation below:

PreviousUsing a new phone numberNextCoexistence Onboarding

Last updated 20 days ago

Was this helpful?

💰 Charged — this opens a new conversation session, according to conversations pricing.

💰 Charged — this opens a paid session according to .

💰 A template message must be sent to. Charges apply based on the template used.

Businesses can link up to four "companion" devices to their WhatsApp Business App (described as "" in Meta Help Center).

and are not supported.

WhatsApp Coexistence comes with some functional limitations. Please refer to to understand what features are supported on Cloud API and if there are changes in your WhatsApp Business App.

Some regions do not currently support onboarding WhatsApp Business App numbers into the Cloud API. For the full list of restrictions and supported regions, check .

Currently, the blue badge verification does not transfer between the WhatsApp Business App and Cloud API. You will need to go through the again.

Cloud API
Cloud API rules
initiate a session on Cloud API
linked devices
WhatsApp for Windows
WhatsApp for WearOS
Meta's feature comparison
Meta’s official documentation
OBA process
Coexistence Onboarding