Skip to content

WhatsApp coexistence: use the Business app and API on one number

How WhatsApp Business coexistence works: one number in the phone app and the official API, what syncs, what changes in the app, requirements, costs and when it pays off.

Marlos Carmo

Founder of Tolky

Updated on November 16, 2026

10 min read
WhatsApp coexistence: use the Business app and API on one number

Share

Many businesses put off the official WhatsApp API for a simple reason: the number customers know lives on the phone of the owner, the front desk or the sales team, with years of conversations on it. Until recently, moving to the API meant taking that number out of the app and losing a way of working that did the job.

Coexistence breaks that deadlock. With it, the same number stays in the WhatsApp Business app and also starts working on the API, connected to a customer service platform, an AI agent and a CRM.

This guide explains how the feature works, what changes in the app, what the requirements are and when it pays off, based on Meta's documentation consulted on November 16, 2026.

Updated in November 2026.

What is WhatsApp coexistence?

Coexistence is the Meta feature that connects a number already on the WhatsApp Business app to the official WhatsApp Business API, keeping the number active in both places and the conversations in sync. Meta's support pages call it "Coexistence", while the developer documentation describes the process as onboarding WhatsApp Business app users through Embedded Signup.

Once connected, the business can send messages at volume through the platform and keep chatting one on one in the app. Meta converts the existing account into a compatible messaging account and keeps the same identifier. Source: onboarding WhatsApp Business app users, consulted on 11/16/2026.

The connection happens through the Embedded Signup flow of a Meta partner. In other words, the business does not turn on coexistence by itself on the phone: it goes through the flow of a platform or provider that offers the feature.

How does coexistence work in practice?

Every message sent or received on the number shows up in both places: in the phone app and in the platform connected to the API. When someone replies from the app, the platform receives a copy of the message and shows it in the conversation history.

Three Meta rules shape day-to-day operations:

  • Cost: messages sent from the app stay free. Messages sent through the API follow the Cloud API pricing table.
  • Customer service window: the API's 24-hour window only opens with messages the customer sends after the connection. Messages exchanged through the app do not open or extend the API window.
  • First reply: if the customer wrote shortly before the connection, the reply through the API has to be an approved template.

For the price of each category, see the WhatsApp Business cost guide or run the numbers in the WhatsApp pricing simulator.

What syncs and what changes in the app?

Coexistence syncs contacts and the history of one-on-one chats from the last 180 days, but it turns off some app features. The table sums up what the documentation describes.

FeatureWhat happens with coexistence
One-on-one chatsMirrored between app and API; up to 180 days of history can be synced once
ContactsCan be synced with the platform, one time only
GroupsStay in the app, but are not synced with the API
Broadcast listsTurned off; existing ones become read-only
Disappearing messagesTurned off in one-on-one chats
View onceTurned off in one-on-one chats
Live locationTurned off in one-on-one chats
Edit and delete messageBecome supported in one-on-one chats
Calls, channels and catalogStay in the app, with no API integration

The sync window is short: the platform has 24 hours after the connection to sync the history. Media only gets an identifier when it is sent within the 14 days after the connection. Source: onboarding WhatsApp Business app users, consulted on 11/16/2026.

What are the requirements for coexistence?

To use coexistence, a business needs an up-to-date WhatsApp Business app and a Meta partner platform that offers the flow. The other points are operational precautions.

  • App version: WhatsApp Business 2.24.17 or higher.
  • Partner: the connection is made through the Embedded Signup flow of a Meta partner that supports the feature.
  • Active primary phone: Meta disconnects the number from the API if the primary device stays inactive for about 14 days.
  • Linked devices: up to four, but the connection unlinks all of them and they need to be linked again. WhatsApp for Windows and for WearOS are not compatible.
  • Availability: depends on the number, the country and the provider. Confirm it before you plan.

There is also a technical limit: numbers in coexistence have a fixed throughput of 20 messages per second so they stay compatible with the app. For customer service and mid-sized campaigns this is usually enough; for very large sends, it is worth considering a full migration.

How to turn on coexistence, step by step

Activation happens in the provider's Embedded Signup flow, with the number's phone in hand. The process takes a few minutes when the requirements are in order.

Step 1: Update the app and organize the portfolio

Update WhatsApp Business on the primary phone and confirm who manages the business portfolio at Meta. The account should sit in the company's own portfolio, not an agency's.

Step 2: Start the connection on the platform

On the platform you chose, open the WhatsApp connection, sign in with your Meta account and enter the number that is already on the app. The flow detects the app usage and moves on to coexistence.

Step 3: Confirm on the phone and authorize the history

The WhatsApp Business app receives a message from Meta's official account to connect the number to the business platform. The business confirms on the phone, decides whether to share the chat history and enters the verification code in the flow. Without authorizing the history, only new conversations show up.

Step 4: Decide who answers what

Before turning on the AI, agree with the team on which conversations stay on the phone and which go through the platform. This prevents two replies to the same customer.

Coexistence or full migration: which should you choose?

Coexistence is better for businesses that want to keep the phone in the operation; full migration is better for those who want maximum volume and everything centralized on the platform. Compare the two paths.

CriterionCoexistenceFull migration to the API
Number in the phone appStaysLeaves the app
Previous historyUp to 180 days syncedNot brought into the API
Messages from the appFreeThere is no app
ThroughputFixed at 20 messages per secondFollows Cloud API capacity
App broadcast listsTurned offReplaced by template campaigns
Disconnection riskIf the primary phone stays inactive for about 14 daysDoes not depend on a phone
Best forSmall and mid-sized operations, gradual transitionHigh-volume operations and large teams

A common strategy is to start with coexistence, measure what the AI resolves and migrate fully once the phone is no longer needed. For the steps of a direct migration, see how to get the official WhatsApp API.

How do you avoid conflicts between the phone and the AI?

The biggest risk of coexistence is not technical: it is the same conversation getting answered twice, by the person on the phone and by the automation. The rule has to be clear before you turn on any agent.

Good practices:

  • define which topics the team keeps handling on the phone;
  • make the automation stop when a person takes over the conversation;
  • log in the CRM the conversations that happen only in the app;
  • review your templates for re-engaging contacts outside the window;
  • document the handoff rules between AI and people.

To go deeper on the hand-off between AI and humans, read AI-to-human handoff: 7 rules.

How do you disconnect coexistence?

You disconnect from inside the WhatsApp Business app itself, under Settings > Account > Business Platform > Disconnect Account. The platform gets a notice and stops sending and receiving messages on the number.

Meta also disconnects the number automatically in some cases, such as the primary phone being inactive for about 14 days, a number change or a new app registration on another device. When that happens, you need to redo the connection through the provider.

Where does Tolky fit in?

Tolky connects the number to the official WhatsApp Business API, either directly with Meta (Cloud API, through the "Connect with Meta" button) or via Gupshup, an official Meta partner, and offers coexistence when it is enabled for your account. With it, the number stays in the WhatsApp Business app on the phone and also shows up in Tolky.

Coexistence in Tolky can run only logging conversations to the CRM or with the AI replying. If someone on the team replies from the phone, the AI pauses in that conversation, and the full history stays on the platform for whoever takes over next. See the WhatsApp integration and the WhatsApp customer service solution.

Availability depends on the account and the number, and Meta's limitations apply equally in Tolky: a throughput of 20 messages per second, broadcast lists turned off and groups left out of the sync.

Frequently asked questions

Can I use the same number on the WhatsApp Business app and the API?

Yes, with coexistence. The number stays in the phone app and starts working on the official API, with conversations mirrored between the two. Activation happens through the Embedded Signup flow of a Meta partner that offers the feature.

Do I lose my chat history when I turn on coexistence?

No. The history stays in the app, and one-on-one chats from the last 180 days can be synced with the platform if the business authorizes it. Groups are not synced.

Are messages sent from the phone charged?

No. According to Meta's documentation, messages sent from the WhatsApp Business app stay free. Only messages sent through the API follow the Cloud API pricing table.

What happens to broadcast lists?

They are turned off. You cannot create new ones, and existing ones become read-only. Sends at volume move to template campaigns approved on the platform.

Does coexistence work with WhatsApp Web?

Yes, with up to four linked devices, which need to be linked again after the connection. WhatsApp for Windows and for WearOS are not compatible.

Can I request the official business account badge with coexistence?

The official business account documentation says Meta does not grant the status to numbers on the WhatsApp Business app. Confirm eligibility with Meta before you apply. See how the official business account works.

Why was my number disconnected from the API?

The most common reasons are the primary phone being inactive for about 14 days, a new app registration on another device or a number change. In those cases, redo the connection through the provider.


Conclusion

Coexistence removed the main barrier to bringing a number that already works on the phone onto the official API. The number stays in the app, conversations are mirrored and the AI comes in without the team losing its way of working. The limits, such as the fixed throughput and the features turned off in the app, need to be part of the plan from the start. For other topics, check the WhatsApp Business Guide.

See the WhatsApp integration, check the plans or talk to the team →. Let's talk?

Share

Tags

  • WhatsApp coexistence
  • WhatsApp Business app and API on the same number
  • WhatsApp Coexistence Meta
  • migrate number to WhatsApp API
  • #WhatsApp Business API
  • Embedded Signup
  • WhatsApp chat history
  • AI agent on WhatsApp

About the author

Marlos Carmo

Founder of Tolky

Marlos Carmo is an AI entrepreneur and founder of Tolky, the conversational-era infrastructure and AI CRM that unifies intelligent service, multi-channel support (such as WhatsApp and voice), live CRM, and operational intelligence in a single ecosystem. He is a finalist for the SXSW Innovation Awards and a member of Francesco's Economy, a global network of young entrepreneurs focused on innovation and social impact. He works connecting Artificial Intelligence and digital transformation in projects for large organizations.

Next step

Want to bring this to your operation?

Tati, Tolky's AI assistant, understands your scenario in a few questions, suggests the best path and connects you with someone from the team, with full context.

Read also