Skip to main content

​
Connect WhatsApp Business to Whatsable (Embedded Signup + Coexistence)

Keep the WhatsApp Business app on your phone and add Whatsable on the same number. Meta calls this Coexistence. This guide covers what Coexistence actually means, what to check before you start Embedded Signup, the signup flow at a high level, and what changes (and what doesn’t) once you’re connected.

​
What Coexistence means

Meta Coexistence lets one WhatsApp number run in two places at the same time: the WhatsApp Business app on your phone, and Whatsable in the background.
  • You keep the WhatsApp Business app installed and can keep using it. Connecting to Whatsable does not require removing it.
  • Messages sync both ways. A reply typed on your phone reaches Whatsable, and a message sent from Whatsable reaches your phone.
  • At the QR / Coexistence step, you’ll get the option to share chat history. Meta may label it “From last 6 months”. Choosing it can bring roughly the last 6 months of your 1:1 chats into Whatsable (about 180 days), per Meta’s own docs.
  • Groups, Status, and Calls stay on the WhatsApp Business app. They are not synced to Whatsable, no matter what you choose at the chat history step.
  • If you skip sharing chat history, that’s fine too. Only new messages sync from that point forward.
Do not uninstall the WhatsApp Business app after you connect. Coexistence depends on the app staying installed on that number.

​
Before you start

A Meta Business Portfolio. Embedded Signup requires a Business Portfolio, not a personal Facebook profile. You can create one during the flow, but having one ready first is faster. For the website field, a business website is fine, but an Instagram or Facebook page URL also works if you don’t have one yet.
A phone number with some recent activity on it. A brand-new, never-used number may fail Coexistence. The number should also already be registered on the WhatsApp Business app (not the consumer WhatsApp app).
Confirm your number’s country isn’t restricted. See country restrictions below.

​
Country restrictions

Meta doesn’t support new WhatsApp Business Platform connections from Iran, Cuba, North Korea, Syria, and some regions of Ukraine. If your number is registered in one of these, an existing number can’t connect. You’d need a different number outside those restrictions.

​
If you’re already using an unofficial WhatsApp tool on this number

Turning on Coexistence replaces whatever unofficial (non-Meta) API tool was running on that number. Once Coexistence is active, those unofficial tools stop working on it. That’s expected.

​
Pricing

The phone number itself is free. Meta doesn’t charge for it. What you pay for is your Whatsable plan; Whatsable passes Meta’s conversation costs through at 0% markup. See pricing for current plans.

​
Embedded Signup, at a high level

1

Start Connect WhatsApp from Whatsable

From your Whatsable account, start the Connect WhatsApp flow.
2

Log in with Facebook

Meta’s Embedded Signup opens. Log in with the Facebook account tied to your Meta Business Portfolio.
3

Pick or create your Business Portfolio

Select the Meta Business Portfolio this number belongs to, or create one if you don’t have one yet.
4

Pick or create a WhatsApp Business Account

Choose an existing WhatsApp Business Account, or let Meta create a new one.
5

Add your phone number

Enter the number you want to connect. If Meta detects that number is already active in the WhatsApp Business app, it offers Coexistence instead of a fresh registration.
6

Scan the QR code and choose Coexistence

Confirm you want to keep the number in the WhatsApp Business app. When asked about your chat history, choose to share chat history (Meta may show this as “From last 6 months”). That brings roughly the last 6 months of your 1:1 chats into Whatsable. Groups, Status, and Calls stay on the WhatsApp Business app either way. Skipping this step just means only new messages sync from here on.
7

Finish verification

Complete any remaining verification Meta asks for (business verification, payment method) and wait for confirmation.
Embedded Signup runs inside your Whatsable account. Technical footnote: the underlying console lives at notifyer.whatsable.app. You may see that domain during signup; it’s Whatsable, not a separate product.

​
After you connect

  • If your Meta Business Portfolio is already verified, expect to be able to send your first message in about 20 minutes.
  • Both sides stay live: keep replying from the WhatsApp Business app, and send and receive through Whatsable at the same time.
  • Any unofficial API tool that used to run on this number stops working once Coexistence turns on.
  • Phone replies typed in the WhatsApp Business app still reach your automations. See Phone replies in the WhatsApp Business app still hit your webhook.

​
Limits & honesty

  • Throughput is set by Meta, not Whatsable. Meta enforces a messages-per-second limit on the Cloud API side for every connected number. Whatsable doesn’t control or raise this limit. It’s the same one any Cloud API number gets from Meta.
  • Country restrictions are Meta’s, not Whatsable’s. Numbers registered in Iran, Cuba, North Korea, Syria, or some regions of Ukraine can’t complete Embedded Signup today.
  • Each number connects on its own. Coexistence, and the connection itself, apply per number. There is no cross-number setup step in this guide.

​
Troubleshoot

Run Embedded Signup again from Whatsable, using the same number. That clears it most of the time. If it’s still stuck after a second attempt, contact support.
Messages like “temporarily prevented…” or a generic “An error occurred. Please try again.” don’t say what actually went wrong. To see more detail, go to business.facebook.com, open Settings (bottom left), then WhatsApp, and check your WhatsApp Accounts. Click the small white arrow next to Add (not the Add button itself), then choose Add WhatsApp Business App. That path on Meta’s side usually surfaces the real error Embedded Signup was hiding, often a Business Portfolio mismatch or a partner lock (see the two items below). It doesn’t always spell out which portfolio is the problem, so you may still need to check your portfolios by hand.
If the Instagram or Facebook page tied to your account belongs to a different Meta Business Portfolio than the one you’re using for WhatsApp, Embedded Signup can fail without a clear reason. Connect using the Business Portfolio that actually owns that page, or move the page into the right portfolio first.
If this number was previously set up through another Meta Business Partner (BSP), that partner link can block Embedded Signup. Go to business.facebook.com, then Settings, then WhatsApp, then the Partners tab. Remove the partner tied to this number and wait a few minutes before retrying. While you’re there, also confirm you’re using the right Business Portfolio and that Business verification isn’t the actual holdup.
Confirm the number is registered on the WhatsApp Business app (not the consumer WhatsApp app) and has some recent activity. A brand-new number sometimes needs a day or two of normal use before Meta offers Coexistence.
Wait 24 hours and try again with the same number, or try the other verification method (SMS vs. call). Don’t uninstall the WhatsApp Business app while you retry.
Meta doesn’t support new WhatsApp Business Platform connections from Iran, Cuba, North Korea, Syria, or some regions of Ukraine. Contact support to talk through options.
A full reset touches your Meta Business Portfolio and WhatsApp Business Account configuration. Contact support rather than trying to undo it yourself.

Phone replies still hit your webhook

Coexistence means WhatsApp Business app replies keep flowing to your automation. See the exact fields to filter on.

Pricing

The phone number is free. See current Whatsable plans.

Start your free trial

Create a Whatsable account and start Connect WhatsApp.

Need help?

Our support team can help with Embedded Signup, Coexistence, and connection issues.