Services

Start a project Chat on WhatsApp
News & Insights

Can You Use the WhatsApp Business App and the API on the Same Number? Yes, and Here Is How

A small business owner in an apron using a mobile phone in a flower shop

For years, a business on WhatsApp had to choose. You could keep your number in the WhatsApp Business app on your phone, where you and your team reply by hand, or you could move the number to the WhatsApp Business Platform, the API, where a chatbot and a shared inbox handle the volume. Moving meant giving up the app. That trade off is now gone. Meta’s coexistence onboarding lets one number run in the WhatsApp Business app and on the Cloud API at the same time, so the owner keeps replying from the phone while a bot and a team work the same conversations through the API.

This guide explains what coexistence is, what you need before you start, what carries over from your phone, what it costs, and the limits worth planning around.

What coexistence actually is

Meta describes the feature in its developer documentation as onboarding WhatsApp Business app users. Most of the industry calls it coexistence. A business that already uses the WhatsApp Business app connects its number to a Cloud API integration through Meta’s Embedded Signup, and Meta converts the account so the app and the API can both send and receive on the same number.

Messages flow both ways. A customer’s message arrives on the phone and at the API. A reply sent from the phone is reported to the API as an echo, so the platform sees the whole conversation, not only the half it sent itself. A reply sent through the API shows up in the app as well. Nothing about the number changes for the customer. They message the same number they always have.

This is different from a full migration to the API. A full migration takes the number off the phone entirely, and the app stops working for that number. Coexistence leaves the number on the phone and adds the API beside it.

What you need before you start

Four things decide whether a number can use coexistence.

First, the number must already be active in the WhatsApp Business app, not the ordinary WhatsApp app that most people have on their phones. Coexistence onboards Business app accounts. If your number sits on personal WhatsApp, it needs to be on the WhatsApp Business app first.

Second, the app must be version 2.24.17 or higher. Meta names this version explicitly in its documentation. Update the app before you begin, and check the version on the phone that holds the number.

Third, onboarding happens through a Solution Partner or Tech Provider that offers Meta’s Embedded Signup. Meta documents the coexistence flow for partners and providers, and the signup is how the number is connected. Embedded Signup versions 2 and 3 were deprecated on 15 October 2026, so ask your provider whether they are on version 4 or later. In version 4 the coexistence flow has to be requested explicitly, and in version 5 it is on by default.

Fourth, the phone that runs the app has to stay in use. Meta can disconnect the number if the phone is inactive for about 14 days, so the handset is still part of the setup even after the API is connected. Keep it charged, online, and in regular use.

What carries over from your phone

When the number is onboarded, your one to one chat history can sync to the platform. Messages from the last 180 days, about six months, can come across. Media only syncs from the 14 days before onboarding, so older photos and voice notes stay on the phone. Group chats do not sync at all.

Both syncs have to be requested within 24 hours of onboarding, and each one can be requested only once. If you miss the window, the history does not come across later, so plan the timing before you start the signup rather than after.

Companion devices need attention too. A coexistence number supports up to four companion devices, except WhatsApp for Windows and Wear OS, which are not supported. Onboarding unlinks the existing companion devices, and you link them again afterwards. If your team relies on a desktop app, check this before you commit.

What it costs

Coexistence adds no Meta fee of its own. The costs are the ordinary two, and they split cleanly.

Messages sent from the WhatsApp Business app stay free, exactly as before. Messages sent through the API are billed at the normal Cloud API rates, which have been charged per delivered message since 1 July 2025, by category and by the recipient’s country. Since 1 October 2026 that includes service messages, the free form replies inside an open 24 hour window. Each number gets 1,000 free service messages a month, and service messages beyond that are charged. Unused free messages do not roll over.

So the owner answering a customer from the phone pays nothing for that reply, while the bot answering the same customer through the API pays the Cloud API rate. That split is worth understanding before you decide which replies the bot handles and which stay with a person.

One more cost detail matters for planning. Throughput on a coexistence number is fixed at 20 messages per second. A campaign to 10,000 contacts takes at least eight minutes and twenty seconds to send, and the sending code has to pace itself to that limit. Standard API numbers start higher, so if you regularly send large broadcasts, factor the slower pace into your plans.

What you lose, or cannot use through the API

Coexistence is not a way to get everything from both sides. Some things stay in the app only.

Calls stay in the WhatsApp Business app. Meta does not support Cloud API calls on coexistence numbers, so voice calls with customers still happen from the phone.

Groups, broadcast lists, the catalogue, and the app’s messaging tools are not available through the API. Your team can still use them from the phone, but the platform cannot send to a broadcast list or manage a catalogue on your behalf.

And the phone itself remains a single point of failure. If it is lost, broken, or left unused for about two weeks, the number can be disconnected. Treat the handset as part of your business infrastructure, not as a spare phone.

Who coexistence suits

Coexistence suits an owner who wants to keep chatting from the phone while a small team and a bot handle the volume on the API. It suits a shop where the owner answers the regulars personally and the bot answers the repeated questions about prices, opening hours, and delivery. It suits a business that wants to move to the API gradually, adding automation one workflow at a time instead of switching everything in a single day.

It suits Digilistan’s own clients for the same reason. Our WhatsApp platform connects numbers through Meta’s Embedded Signup, including coexistence onboarding, so a business keeps its number in the app while the platform adds a shared inbox, a chatbot, and campaigns on the same number.

It does not suit a business that wants to stop using the phone altogether. If nobody will keep the handset active, a full API migration is the cleaner choice, because coexistence depends on that phone staying in use.

What to do this week

Start with three checks. First, confirm the number is on the WhatsApp Business app and the app is version 2.24.17 or higher. Second, decide what the bot should answer and what stays with a person, because that split decides what the API side of the bill looks like. Third, ask your provider two questions: are they on Embedded Signup version 4 or later, and do they support coexistence onboarding for your number.

If the answers are yes, the move itself is straightforward. The number stays where customers already know it, the history comes across if you request it inside the first day, and the owner keeps the phone while the team and the bot get the tools they need.

If you would like help setting that up, our AI chatbots service builds bots that answer from your real business information and hand over to a person when a chat needs one. You can read about it on our AI chatbots page, or talk to us through the contact page and we will look at your current setup together.

Start the conversation

Tell us what you are building

Whether you need a website, a chatbot that never sleeps or a workflow that gives your team its evenings back, start with a short conversation. We reply to every serious enquiry personally.

  • Your message goes to the founder, not a call center.
  • We suggest the smallest service that fixes the problem.
  • The first conversation costs nothing but a few minutes.

Prefer to talk first? Message us on WhatsApp and skip the form.

Chat with us