> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp coexistence: use the Business app with Flowella

> Connect your WhatsApp Business app number to Flowella and keep using the app: what Meta changes, what appears in Flowella, and how to set it up.

**WhatsApp coexistence** (also spelled **co-existence**) lets you connect the number you use in the WhatsApp Business app to Flowella without giving up the app. Your team can keep chatting in the app, while Flowella sends templates and Flows and receives your customers' messages on the same number.

## What is coexistence?

Coexistence connects your WhatsApp Business app account and number to the **WhatsApp Business Platform (Cloud API)**, the Meta service Flowella uses. Afterwards:

* You can keep sending and receiving one-to-one messages in the WhatsApp Business app.
* Flowella can send messages from the number, and customers' messages arrive in Flowella.
* Messages your staff send from the WhatsApp Business app **don't appear in Flowella or HubSpot**.

> [!WARNING]
>
> Because replies sent from the Business app never reach Flowella, a conversation can look unanswered in the Flowella Inbox, and HubSpot only sees part of it. Agree which tool your team replies from.

> [!NOTE]
>
> **In Flowella.** Partly supported. Flowella sends and receives on a co-existence number like any other. Meta reports messages your staff send from the app (`smb_message_echoes`), and Flowella records them but doesn't show them in the Inbox or HubSpot. Flowella doesn't use Meta's one-time sync of past chats and contacts. Co-existence isn't exclusive to Flowella: other providers, including HubSpot, offer it too.

## When to use coexistence

Use coexistence if you:

* Already have a WhatsApp Business app number that customers know and trust
* Want to send templates and Flows from Flowella without changing your number
* Still want staff to use the WhatsApp Business app for quick one-to-one replies

If the number is already connected to another WhatsApp provider through the API, contact Flowella support before you connect it.

## Coexistence, moving off the app, or a new number

| Approach | Keep using the Business app? | Keep the same number? | Typical when |
| - | - | - | - |
| **Coexistence** | Yes, for one-to-one chats | Yes | Your number is on the WhatsApp Business app and you want Flowella and the app together |
| **Move off the app** | No | Yes | You'll run all conversations in Flowella. Delete the WhatsApp account in the app first, then connect the number as normal |
| **New number** | Optional, on the old number | No, customers learn a new number | You want a clean split between the app and Flowella |

Official Meta overview: [Onboard WhatsApp Business app users (coexistence)](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users).

## Requirements

To connect a WhatsApp Business app number, you need:

* **WhatsApp Business app version 2.24.17 or higher**
* The phone that runs the WhatsApp Business app for that number, to hand while you connect
* A Facebook account with admin access to your Meta business portfolio, for Meta's popup

## What changes after you connect

Meta changes some WhatsApp Business app features so the app and the platform can share the number:

| Feature | After you connect |
| - | - |
| Message throughput | Fixed at **20 messages per second (mps)**. See [Throughput](https://knowledge.flowella.io/whatsapp/limits/throughput.md) |
| Group chats | Unchanged in the app; not available in Flowella |
| Disappearing messages | Turned off for all one-to-one chats |
| View once messages | Turned off for all one-to-one chats |
| Live location | Turned off for all one-to-one chats |
| Broadcast lists | Turned off; existing lists become read-only |
| Voice and video calls | Still work in the app; not available in Flowella |
| Business app tools (greeting and away messages, quick replies, labels, catalogue) | Keep working in the app; not available in Flowella |
| Linked devices | Unlinked when you connect. You can link supported devices again (WhatsApp for Windows and WearOS aren't supported) |

## Connect your WhatsApp Business app number

**1. Start in Flowella**

Open **Settings → WhatsApp (Meta)** and select **Connect WhatsApp**, or **Add WhatsApp number** if you already have one connected. Meta's popup opens. Sign in with the Facebook account that is an admin of your business portfolio.

**2. Enter your Business app number**

Enter the number you use in the WhatsApp Business app. If Meta asks you to choose a setup, choose to connect your existing WhatsApp Business app.

**3. Note the code in Meta's popup**

Meta's popup shows a verification code, or a QR code, and the steps to follow. Keep the popup open.

**4. Open the WhatsApp Business app**

On your phone, open the WhatsApp Business app and look for a message from the official **Facebook Business** account. Tap **Connect**, then **Connect to the Business Platform**.

If you don't see the message, go to **Settings → Account → Business Platform** and select **Connect to the Business Platform**.

**5. Choose whether to share chat history**

The app asks whether to share your chat history. Flowella doesn't import past chats, so only messages from after you connect appear in Flowella, whichever you choose.

**6. Enter the code**

Enter the code from Meta's popup in the WhatsApp Business app, or scan the QR code if that's what the popup shows.

**7. Finish Meta's popup**

Return to your browser and complete the remaining steps in Meta's popup. Flowella adds the number to **Connected WhatsApp numbers**.

Then complete [business verification](https://knowledge.flowella.io/whatsapp/accounts/business-verification.md) and add a [payment method](https://knowledge.flowella.io/whatsapp/accounts/payment-method.md), as for any other number. See [Setup sequence](https://knowledge.flowella.io/whatsapp/accounts/setup-sequence.md).

## What appears in Flowella

| Data | In Flowella? |
| - | - |
| Messages customers send after you connect | Yes, in the Inbox, and in HubSpot if it's connected |
| Customers deleting their messages | Yes. The Inbox marks the message as deleted |
| Customers editing their messages | Not at the moment. Meta currently reports edits as unsupported messages while it restores support. When it does, the Inbox shows the edited text |
| Messages you send from Flowella or HubSpot | Yes |
| Messages your staff send from the WhatsApp Business app or its linked devices | No |
| Chats from before you connected | No. Meta offers a one-time sync within 24 hours of connecting, which Flowella doesn't use |
| Your Business app contacts | No. Meta's one-time contact sync isn't used |
| Group chats | No |
| Messages from customers who use WhatsApp for Windows or WearOS | No. Meta doesn't pass these messages to Flowella |

## Pricing and messaging rules

* Messages sent from the **WhatsApp Business app** stay free, under Meta's app rules.
* Messages sent from **Flowella (Cloud API)** follow Meta's Cloud API pricing. See [Pricing and WhatsApp message categories](https://knowledge.flowella.io/account/pricing-and-conversation-categories.md).

Meta opens a 24-hour customer service window when a customer messages your business after you connect. If a customer messaged you shortly before you connected, you can only reply from Flowella with a **template** until they message again. Messages sent from the Business app don't open or extend the 24-hour window for Flowella.

## Disconnecting

To stop using the number with Flowella:

1. Open the **WhatsApp Business app**.
2. Go to **Settings → Account → Business Platform → Disconnect Account**.

Once disconnected, Flowella can no longer send or receive messages for that number. Removing the number in **Settings → WhatsApp (Meta)** only stops Flowella using it; the number stays connected to the Business Platform until you disconnect it in the app. See [Remove a number](https://knowledge.flowella.io/account/meta-integration.md#remove-a-number).

## Device change and automatic reconnect

If you **change phones**, reinstall the WhatsApp Business app or re-register the number, Meta automatically disconnects the platform from the number. When you finish registering on the new phone, WhatsApp shows your previously connected platform products with a pre-ticked option to keep them. Leave it ticked, and Meta usually reconnects the number within a few minutes. It keeps the same account and doesn't create a new WABA.

While Meta reconnects the number, Flowella can't send or receive messages on it. Linked devices such as WhatsApp Web aren't restored automatically, so link them again.

Meta documents this under [Reconnect offboarded coexistence clients](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/reconnect-offboarded-coexistence-clients). If Flowella stops sending after a phone change, check that registration finished on the new phone with the platform products still ticked, then contact Flowella support with the approximate time of the change.

## Why Meta disconnects a coexistence number

Meta can disconnect a coexistence number from the platform without a phone change. Until the number is reconnected, Flowella can't send or receive messages on it. These are the reasons Meta reports:

| Reason | What happened | What to do |
| - | - | - |
| Main phone inactive | The phone that runs the WhatsApp Business app was inactive for about 14 days. | Open the app on that phone, then [reconnect the number](https://knowledge.flowella.io/troubleshooting/whatsapp-connection.md#reconnect-the-number). |
| Companion device inactive | Meta reports that a companion device was inactive for about 30 days. | Reconnect the number. |
| Phone change or re-registration | You moved to a new phone, reinstalled the app or registered the number again. | This usually reconnects on its own. See [Device change and automatic reconnect](#device-change-and-automatic-reconnect). |
| Number changed | You changed the number in the WhatsApp Business app. | Connect the new number. |
| Registered on WhatsApp Messenger | The number was registered in the consumer WhatsApp app instead of the WhatsApp Business app. | Register the number in the WhatsApp Business app again, then reconnect it. |
| Disconnected or deleted | Someone disconnected the number under **Business Platform** in the app, the WhatsApp account was deleted, or Meta took enforcement action. | If it wasn't intended, reconnect the number. For enforcement, see [Policy and enforcement](https://knowledge.flowella.io/whatsapp/messaging/policy-and-enforcement.md). |

Flowella may keep showing the number as **Connected** after Meta disconnects it. To check, open **Settings → Account → Business Platform** in the WhatsApp Business app. If templates stop loading or sends fail, see [Fix a WhatsApp number that shows Connected but doesn't work](https://knowledge.flowella.io/troubleshooting/whatsapp-connection.md).

## Troubleshooting

> [accordion] Flowella shows Connected, but templates don't load or sends fail
>
> Meta may have disconnected the number from the platform. Check **Settings → Account → Business Platform** in the WhatsApp Business app, then follow [Fix a WhatsApp number that shows Connected but doesn't work](https://knowledge.flowella.io/troubleshooting/whatsapp-connection.md). Don't remove the number in Flowella first: removing it deletes its conversations and opt-out list.

> [accordion] I didn't receive the message from Facebook Business
>
> * Update the WhatsApp Business app to version 2.24.17 or higher.
> * Go to **Settings → Account → Business Platform** in the app and connect from there.
> * Check your internet connection and that notifications are turned on.

> [accordion] The verification code doesn't work
>
> * Close Meta's popup and select **Connect WhatsApp** again, so Meta shows a new code.
> * Don't copy extra spaces when you paste the code.
> * Use the QR code if the popup offers one.

> [accordion] I get an error when switching from another provider
>
> If you used another provider before and still share their credit line, Meta may block the switch until that's resolved. Contact Flowella support and share the error details.

> [accordion] Some messages don't appear in Flowella
>
> Messages your staff send from the WhatsApp Business app never appear in Flowella. Messages from customers who use WhatsApp for Windows or WearOS don't reach Flowella either, because Meta doesn't pass them on. Everything else customers send after you connect should appear in the Inbox. If it doesn't, contact Flowella support.

## FAQs about WhatsApp coexistence

> [accordion] Is coexistence the same as co-existence?
>
> Yes. Meta's developer documentation calls the feature **Coexistence** (no hyphen). Flowella and many partner articles also write **co-existence**. Both mean connecting an existing WhatsApp Business app number to the platform, so the app and Flowella share the same number.

> [accordion] Can I keep using the WhatsApp Business app after connecting to Flowella?
>
> Yes. That's the purpose of coexistence. Your team can keep using the app for one-to-one chats while Flowella sends templates and Flows. Messages sent from the app don't appear in Flowella or HubSpot.

> [accordion] Do replies I send from the Business app reach HubSpot?
>
> No. Flowella only receives messages your customers send and messages sent from Flowella or HubSpot. To keep the full conversation in HubSpot, reply from Flowella or HubSpot instead.

> [accordion] Will my old chats appear in Flowella?
>
> No. Flowella shows messages from after you connect. Your past chats stay in the WhatsApp Business app.

> [accordion] Will group chats appear in Flowella?
>
> No. Group chats stay in the WhatsApp Business app only.

> [accordion] Are messages from Flowella free when coexistence is on?
>
> No. Meta keeps WhatsApp Business **app** messages free under its app rules, but messages sent through the platform (including from Flowella) use Cloud API pricing. App messages also don't open or extend the 24-hour customer service window.

> [accordion] Why is throughput only 20 messages per second?
>
> Meta fixes coexistence numbers at **20 mps** so the Business app and the platform stay compatible. That's separate from [portfolio messaging limits](https://knowledge.flowella.io/whatsapp/limits/messaging-limits.md) (unique recipients in a moving 24-hour period).

> [accordion] What happens if I change my phone?
>
> Meta disconnects the platform when you change devices or re-register, then reconnects it automatically if you keep the platform products ticked when you register again. See [Device change and automatic reconnect](#device-change-and-automatic-reconnect).

## Related

> [card] [Phone numbers](https://knowledge.flowella.io/whatsapp/accounts/phone-numbers.md)
>
> How a number becomes a WhatsApp Business Platform sender.

> [card] [WhatsApp Business Account](https://knowledge.flowella.io/whatsapp/accounts/whatsapp-business-account.md)
>
> The WABA your number lives in, and Meta's account types.

> [card] [Setup sequence](https://knowledge.flowella.io/whatsapp/accounts/setup-sequence.md)
>
> The order for connecting WhatsApp, including coexistence.

> [card] [Inbox](https://knowledge.flowella.io/app/inbox.md)
>
> Where customers' messages arrive in Flowella.

Checked against Meta's documentation on 18 November 2026: [Onboarding WhatsApp Business app users](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users), [Reconnect offboarded coexistence clients](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/reconnect-offboarded-coexistence-clients), [smb\_message\_echoes webhook](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/smb_message_echoes) and [Throughput](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.