> ## 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.

# Set up Meta for WhatsApp Business: step-by-step order

> Connect WhatsApp to Flowella in the right order: prepare your accounts, complete Meta's popup, then finish business verification and a Meta payment method.

Connecting WhatsApp to Flowella takes one popup from Meta and two follow-ups that run on Meta's timeline. This page shows the order, what each step needs and how to check it worked.

For a checklist of everything to prepare, including HubSpot, see [Before you start](https://knowledge.flowella.io/before-you-start.md).

## Before you connect

**In Flowella**

* Sign in as an **Owner** or **Admin**. Anyone in the organisation can connect WhatsApp, but only these roles can name the organisation and manage numbers after you connect.
* Give your organisation a name. If it has none, the **Connection** tab shows "Name your organisation before connecting WhatsApp." instead of the connect button.

**In Meta**

* A Facebook account with admin access to your Meta business portfolio (called Business Manager in older guides). If you don't have a portfolio, Meta's popup can create one. See [Business portfolio](https://knowledge.flowella.io/whatsapp/accounts/business-portfolio.md).
* A phone number you can verify by SMS or phone call, and that isn't in use with WhatsApp. See [Phone numbers](https://knowledge.flowella.io/whatsapp/accounts/phone-numbers.md).
* If the number is on the WhatsApp Business app and you want to keep using the app, read [Coexistence](https://knowledge.flowella.io/whatsapp/accounts/co-existence.md) first.

## How the setup fits together

This flowchart shows the path from naming your organisation to a number that can send paid messages and Flows.

```mermaid theme={null}
flowchart TD
  A["Name your organisation in Flowella"] --> B["Settings → WhatsApp (Meta): Connect WhatsApp"]
  B --> C{"Number on the WhatsApp Business app?"}
  C -- "Yes, keep the app" --> D["Coexistence: confirm in the Business app"]
  C -- "No" --> E["Meta's popup: portfolio, WABA, number, code, display name"]
  D --> F["Number listed in Connected WhatsApp numbers"]
  E --> F
  F --> G["Business verification in Meta's Security Center"]
  F --> H["Default payment method in Meta"]
  G --> I["Flows can be published; limit can rise to 2,000"]
  H --> J["Paid messages keep delivering"]
```

You can start business verification before you connect. It doesn't block the connection.

## Connect WhatsApp

**1. Name your organisation**

Flowella offers your organisation name to Meta's popup as your business name. If the **Connection** tab asks you to name the organisation, select **Continue** and enter the name. See [Organization settings](https://knowledge.flowella.io/settings/organization.md).

**2. Open Settings → WhatsApp (Meta)**

On the **Connection** tab, select **Connect WhatsApp**. If you already have a number connected, the button is **Add WhatsApp number**. For everything else on this screen, see [WhatsApp (Meta) settings](https://knowledge.flowella.io/account/meta-integration.md).

**3. Complete Meta's popup**

Sign in with your Facebook account. To use an existing business portfolio, the account must be an admin of it. In the popup you:

* choose or create the business portfolio
* choose or create the WhatsApp Business Account (WABA), which holds your templates and payment method
* enter the phone number and verify it with the code Meta sends by SMS or phone call
* set the display name customers see

The order of the screens can vary. Finish the popup in one go: if it stays open too long, Flowella shows "The Meta connection window timed out" and you start again.

**4. Check the number in Flowella**

The popup closes and the number appears in **Connected WhatsApp numbers**. If the number isn't registered with WhatsApp yet, Flowella registers it for you and sets a [two-step verification PIN](https://knowledge.flowella.io/whatsapp/accounts/phone-numbers.md#two-step-verification-pin). Flowella gets your WABA from Meta's popup, so you don't copy any IDs into Flowella. Your first number becomes the default number.

**5. Complete business verification**

Meta verifies your business in its **Security Center**. Until Meta shows your business as verified, a banner in Flowella tracks the status and Flowella can't publish Flows. See [Business verification](https://knowledge.flowella.io/whatsapp/accounts/business-verification.md).

**6. Add a payment method in Meta**

Add a card in Meta and make it the **Default** payment method for the WABA Flowella uses. Meta bills paid messages to this card, including replies after each number's free monthly service messages. See [Meta payment method](https://knowledge.flowella.io/whatsapp/accounts/payment-method.md) and [Pricing and WhatsApp message categories](https://knowledge.flowella.io/account/pricing-and-conversation-categories.md).

> [!NOTE]
>
> The [setup guide](https://knowledge.flowella.io/onboarding.md) ticks **Payment method in Meta** as soon as WhatsApp connects, because Flowella can't see your Meta billing. **Connect WhatsApp** stays **In progress** until Meta shows your business as verified.

## How the steps depend on each other

* **The organisation name comes first.** Owners and Admins see the connect button only after the organisation has a name.
* **One popup covers the Meta assets.** The business portfolio, WABA, phone number and display name are all set in Meta's popup. You don't need to create them separately beforehand.
* **Verification doesn't block the connection.** It blocks publishing Flows. It is also one of Meta's ways to raise your [messaging limit](https://knowledge.flowella.io/whatsapp/limits/messaging-limits.md) from 250 to 2,000 unique recipients in a moving 24-hour period.
* **The payment method doesn't wait for verification.** Add it as soon as the WABA exists. Without it, Meta stops delivering paid messages.
* **Each number joins on its own.** Run **Add WhatsApp number** once for each extra number. Flowella adds the number you pick in the popup. See [Multi-channel](https://knowledge.flowella.io/essentials/multi-channel.md).

## Coexistence: keep the WhatsApp Business app

If your number is on the WhatsApp Business app and you want to keep using the app, Meta's popup takes you through coexistence. Meta shows a code or QR code in the popup, and you confirm the connection in the Business app on your phone.

Customers' messages then arrive in Flowella, but messages your staff send from the Business app don't appear in Flowella or HubSpot. Read [Coexistence](https://knowledge.flowella.io/whatsapp/accounts/co-existence.md) before you choose this route.

If you'd rather move the number off the app completely, delete the WhatsApp account in the Business app first, then connect it as a new number.

## Check that it worked

1. Open **Settings → WhatsApp (Meta)** and confirm the number is listed under **Connected WhatsApp numbers**.
2. From your own phone, send a WhatsApp message to the business number. It appears in the [Inbox](https://knowledge.flowella.io/app/inbox.md).
3. Open the [setup guide](https://knowledge.flowella.io/onboarding.md). **Add phone number** is ticked under **Connect WhatsApp**.

## Troubleshooting

> [accordion] Flowella asks me to name my organisation
>
> The connect button appears once the organisation has a name. Select **Continue**, enter the name, then return to **Settings → WhatsApp (Meta)**.

> [accordion] The Meta connection window timed out
>
> Meta's popup was open too long, or Flowella's sign-in session for it expired. Select **Connect WhatsApp** again and finish the popup without long pauses.

> [accordion] This WhatsApp Business Account is already linked to another Flowella organization
>
> A WABA can belong to only one Flowella organisation. Remove its numbers from the other organisation, or choose a different WABA in Meta's popup.

> [accordion] Embedded signup did not return the WhatsApp asset you chose
>
> Flowella needs both the WABA and the phone number from the popup. Run the popup again and make sure you add and verify a phone number. If it happens again, reload the page or try another browser.

> [accordion] Flowella says WhatsApp needs reconnecting
>
> Flowella checks each WhatsApp connection every hour. When Meta stops accepting Flowella's access, for example because it expired or was removed, Flowella shows a banner at the top of the app: "WhatsApp needs reconnecting." Owners and admins also get an email headed "WhatsApp needs reconnecting", with a link to reconnect. Flowella sends the email again at most once a day while the problem lasts, and also when the access is due to expire within 14 days or 3 days.
>
> Reconnect by connecting the same WhatsApp Business Account again in **Settings → WhatsApp (Meta)**. Until you do, HubSpot **Send WhatsApp Template** steps wait instead of sending. See [The step keeps waiting](https://knowledge.flowella.io/troubleshooting/hubspot-sync-failures.md#the-step-keeps-waiting).

> [accordion] My business portfolio doesn't appear in the popup
>
> The Facebook account you signed in with isn't an admin of that portfolio. Ask a portfolio admin to give you full control, or sign in with their account. See [Business portfolio](https://knowledge.flowella.io/whatsapp/accounts/business-portfolio.md).

For more connection problems, see [Onboarding troubleshooting](https://knowledge.flowella.io/troubleshooting/onboarding.md).

## Related

> [card] [WhatsApp (Meta) settings](https://knowledge.flowella.io/account/meta-integration.md)
>
> Labels, default number, removing numbers and read receipts.

> [card] [Business verification](https://knowledge.flowella.io/whatsapp/accounts/business-verification.md)
>
> What Meta needs and what each Flowella banner means.

> [card] [Meta payment method](https://knowledge.flowella.io/whatsapp/accounts/payment-method.md)
>
> Add a Default card so paid messages keep delivering.

> [card] [Connect HubSpot](https://knowledge.flowella.io/hubspot/setup.md)
>
> The next step after WhatsApp is connected.

> [card] [Send your first Flow](https://knowledge.flowella.io/send-your-first-flow.md)
>
> From a HubSpot form to your first Flow submission.

> [card] [Coexistence](https://knowledge.flowella.io/whatsapp/accounts/co-existence.md)
>
> Keep the WhatsApp Business app on the same number.


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