AI Agents · 9 min

WhatsApp Coexistence: Use the Business App and the Cloud API on One Number

WhatsApp coexistence explained: eligibility, 6-month history sync, features that stop, 20 mps, pricing and Meta's AI-provider terms. Request a demo.
WhatsApp Coexistence: Use the Business App and the Cloud API on One Number
On this page

WhatsApp coexistence lets a business connect its existing WhatsApp Business app number to the Cloud API through a Meta partner, while staff keep sending one-to-one messages from the app on the same number. Contacts and up to six months (180 days) of individual chat history can be synced, every message is mirrored between the app and the API, and app messages stay free. The trade-offs are a fixed 20 messages per second, disabled broadcast lists and a few chat features switched off in the app.

This guide is for owners and operations leads in Saudi Arabia, the UAE, the wider Gulf and Türkiye who run sales or support on a WhatsApp Business app number and want automation without changing that number. If the goal is an AI agent that answers on that line, see how the NourSky AI Employee works on top of the Cloud API.

What is WhatsApp coexistence, exactly?

Meta’s developer documentation calls it onboarding WhatsApp Business app users, which explains why people search for that phrase together with “6 months” and “history”. Before it existed, putting a number on the API meant deleting the app account. Meta’s migration page still describes that route, and is blunt about the cost: the existing history is lost and the number cannot go back to the app unless it is deregistered from Cloud API.

Coexistence is the alternative. The phone stays the primary device. A partner’s platform (a CRM, shared inbox or AI agent) gets API access to the same number, and both sides see the same conversation.

Who is eligible, and what do you need?

  • App version: WhatsApp Business app 2.24.17 or higher on the primary phone.
  • A qualifying partner: onboarding runs through Meta’s Embedded Signup, offered by a company that is already a Solution Partner or Tech Provider. You cannot switch it on yourself inside the app.
  • A Meta business portfolio to own the WhatsApp Business account and billing.
  • Country availability: Meta’s current coexistence documentation does not publish a country list, and the lists circulating on provider blogs contradict each other. Ask your partner to confirm support for your number’s country code before you plan around it.

Normal API limits still apply. Meta’s messaging limits page says newly created business portfolios can reach 250 unique users in a moving 24-hour period with messages sent outside a customer service window. Business verification is one of the ways to scale beyond that.

How does coexistence onboarding work?

  1. Update the WhatsApp Business app on the primary phone.
  2. In the partner’s Embedded Signup window, choose to connect an existing WhatsApp Business app account and enter the number.
  3. Open the message that arrives in the app, tap Connect, then Connect to the Business Platform.
  4. Decide whether to share chat history. This choice is one-time: changing it later means disconnecting and starting again.
  5. Enter the verification code back in the signup window to finish.
  6. Keep the app open while contacts and history sync, then re-link companion devices, because Meta unlinks all of them during onboarding.

Behind the scenes the partner skips phone-number registration, since the number is already registered, subscribes to extra webhooks (including message echoes for anything sent from the app) and has 24 hours to request the history sync. If that window is missed, the business has to be offboarded and run the flow again.

What syncs to the API, and what stays in the app?

Data Synced to Cloud API? Detail from Meta’s docs
Contacts Yes All contacts with a WhatsApp number
1:1 text history Yes, if you agree to share it Messages sent or received within 180 days before onboarding
Media history Partly Only media sent within 14 days of onboarding
Group chats No Not synchronized and not supported on the API
New messages after onboarding Yes, both ways App-sent messages reach the partner as echo webhooks

Contacts and history can each be requested once. Agree the timing with your partner before you tap Connect.

What stops working in the WhatsApp Business app?

Meta’s feature table separates what changes in the app from what is simply unavailable through the API.

  • Turned off in the app for 1:1 chats: disappearing messages, view-once messages and live location.
  • Broadcast lists: disabled. You cannot create new lists, and existing ones become read-only. Bulk outreach moves to approved template messages on the API.
  • Unchanged in the app but not available on the API: voice and video calls, business tools, messaging tools, the business profile and Channels.
  • Companion devices: up to four are supported, except WhatsApp for Windows and WhatsApp for WearOS.

If your team relies on the Windows desktop app, move them to WhatsApp Web or the Mac app before onboarding day. Our guide to WhatsApp Business auto-reply covers what the app’s built-in tools can and cannot do.

How do pricing and throughput change?

The coexistence documentation states that messages the business sends from the WhatsApp Business app stay free, while messages sent through Cloud API follow Cloud API pricing. App messages do not open, extend or affect API customer service windows. So a staff reply typed on the phone does not give your automation a fresh 24 hours.

On the API side, Meta’s pricing page sets the rules:

  • Since 1 July 2025, Meta charges per delivered message, by category and market.
  • A 24-hour customer service window opens when a user messages or calls you. Outside it, only approved templates (marketing, utility, authentication) can be sent.
  • As of 1 October 2026, each business phone number gets 1,000 free service messages per month, and Meta charges from the 1,001st. Utility templates sent inside an open window, previously free, are now charged too.

Throughput is the other cost. Meta’s throughput page gives regular Cloud API numbers 80 messages per second by default, upgradable automatically to 1,000. Coexistence numbers are fixed at 20 mps. That suits conversational support and sales, but can bottleneck a large campaign.

What can disconnect a coexistence number?

The connection is tied to the phone. Among the disconnection reasons Meta lists in its account-update webhooks is a primary device that has been inactive for approximately 14 days, and a companion device inactive for approximately 30 days. Treat the onboarding phone as infrastructure: keep it charged, online and opened regularly.

To leave on purpose, the business disconnects from inside the app under Settings > Account > Business Platform. Meta notes that the Deregister API cannot be used for numbers active on both platforms.

Do Meta’s AI-provider terms affect a WhatsApp AI agent on coexistence?

This is the question behind searches for “business solution terms” and “AI providers”. Meta’s Terms for WhatsApp Business Platform (last modified 23 September 2026) define AI Providers as makers of large language models, generative AI platforms, general-purpose assistants and similar technologies. Those providers are barred from using the platform to offer such technology when it is the primary, rather than incidental or ancillary, functionality, as Meta decides. Meta’s AI providers page dates that update to 15 January 2026. It lists markets where Meta is legally required to allow general-purpose assistants: Brazil, a list of EU and EEA countries, Italy, and Türkiye (+90) since 15 October 2026.

A business answering its own customers is in a different position, and the terms say so directly:

“Notwithstanding the foregoing, you may retain an AI Provider as your Solution Provider.” (Meta Terms for WhatsApp Business Platform, section 4.7)

When the terms were announced, Meta also confirmed to TechCrunch that businesses using AI to serve their own customers are not affected. The same section adds a data rule: you may not let WhatsApp Business Platform Data be used to train or improve AI models in general, though you may fine-tune a model reserved exclusively for your own use. In practice, an agent that answers questions about your properties, appointments or orders, and hands off to staff, is the intended use. A “chat with any AI about anything” bot on your number is not.

What does a coexistence conversation look like?

The point of coexistence is that the customer sees one thread, whoever is replying.

Customer: Hi, do you have a dermatology slot this Saturday morning?

AI agent: Hello! Saturday has 10:00 and 11:30 open with the dermatology clinic. Which one suits you, and is this your first visit with us?

Customer: 11:30 please. First visit. Also, can I use my insurance?

AI agent: I’ve held 11:30 for you. Insurance coverage depends on your provider and plan, so I’ve passed your question to our front desk. They’ll confirm here shortly.

Front desk (from the Business app): Hi, this is Mariam from reception. Please send a photo of your insurance card and we’ll check it before Saturday.

The agent handles the booking through the API. The receptionist answers the judgement call from the phone, and the CRM records both. For what it takes to run the agent side well, read AI Agent for WhatsApp Business: how it works and what it takes to run. Still weighing a scripted bot? Read AI Agent or chatbot.

Is coexistence the right choice for your business?

  • Choose coexistence if your team lives in the app, the last six months of chats matter, and your outbound volume fits within 20 messages per second.
  • Choose a full migration if you want every conversation inside one system with proper permissions and audit trails, or you need higher throughput for large template sends.
  • Stay on the app alone if one person can comfortably answer every message on the day it arrives.

Not sure the volume justifies it? The lost leads calculator estimates what slow replies are costing you.

Keep your number and your history, and add an agent that replies instantly

NourSky connects your WhatsApp Business number to the Cloud API, then builds an AI agent on it that answers from your approved information and hands off to your team inside the same thread.

Request a live demo →

Frequently asked questions

How much chat history does WhatsApp coexistence sync?

Meta’s documentation covers individual (1:1) messages sent or received within 180 days, about six months, before onboarding, plus media from the last 14 days only. Group chats are not synced. You must agree to share history during signup, and the partner must request the sync within 24 hours.

Are messages sent from the WhatsApp Business app charged after coexistence?

No. Meta states that messages sent from the app remain free. Messages sent through Cloud API follow Cloud API pricing, and app messages do not open or extend API customer service windows.

Can I use coexistence without a Meta partner?

No. Coexistence onboarding runs through Meta’s Embedded Signup, offered by a Solution Partner or Tech Provider that has built support for WhatsApp Business app numbers.

Keep reading

More from Insights.

Property Management CRM in Saudi Arabia: What Landlords and Managers Need
CRM & Sales · 8 min
What a property management CRM in Saudi Arabia should hold, how it works alongside Ejar, and how to handle renewals, WhatsApp rent reminders and owner reports.
AI Workflow Automation in Saudi Arabia: What to Automate First
AI Agents · 8 min
Which AI workflows pay back first for Saudi businesses, what to keep human, WhatsApp and PDPL basics, and the questions to ask an automation partner.
WhatsApp AI Agent for Quotes: Collect Details, Send Estimates, Hand Off to Your Team
AI Agents · 9 min
How a WhatsApp AI agent collects details, quotes only from your approved price table, and hands serious enquiries to your team with the context attached.
Ready when you are

Reading helps. A working system helps more.

Tell us where inquiries slip through today. You leave the call with a clear next step, not a sales pitch.