Skip to main content
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.

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.
  • A phone number you can verify by SMS or phone call, and that isn’t in use with WhatsApp. See Phone numbers.
  • If the number is on the WhatsApp Business app and you want to keep using the app, read Coexistence 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. 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.
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.
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. 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.
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 and Pricing and WhatsApp message categories.
The setup guide 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 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.

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 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.
  3. Open the setup guide. Add phone number is ticked under Connect WhatsApp.

Troubleshooting

The connect button appears once the organisation has a name. Select Continue, enter the name, then return to Settings → WhatsApp (Meta).
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.
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.
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.
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.
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.
For more connection problems, see Onboarding troubleshooting.

WhatsApp (Meta) settings

Labels, default number, removing numbers and read receipts.

Business verification

What Meta needs and what each Flowella banner means.

Meta payment method

Add a Default card so paid messages keep delivering.

Connect HubSpot

The next step after WhatsApp is connected.

Send your first Flow

From a HubSpot form to your first Flow submission.

Coexistence

Keep the WhatsApp Business app on the same number.
Last modified on November 11, 2026