Connecting Meta and WhatsApp | MsgOrb Documentation

All connection work happens on WhatsApp Settings, in the card headed Meta WhatsApp Connection.

The connection form is disabled until your subscription is active. If you see Active Subscription Required, open Billing first.

Option A — Meta Embedded Signup (recommended)

1On WhatsApp Settings, click Connect with Facebook.
2A Meta window opens. Sign in with the Facebook account that owns your business, then follow Meta's steps to select or create a WhatsApp Business Account and a phone number.
3When Meta finishes, the window closes and MsgOrb exchanges the returned code for a token by itself.
4You will see the alert Meta WhatsApp Business connected successfully, and the card changes to the green Successfully Connected state.

Everything in that window belongs to Meta, and the exact screens depend on whether your business already has a WhatsApp Business Account. MsgOrb does not control that flow and does not add steps to it.

Option B — Paste credentials by hand

Use this when you already have a permanent System User token, or when Embedded Signup is not available to your business.

MsgOrb asks for two values only:

Field	Where to find it
Permanent Access Token	Meta Business Settings → Users → System users → your system user → Generate new token
WhatsApp Business Account ID	Meta → WhatsApp → API Setup, labelled WhatsApp Business Account ID

Paste both and click Save Connection. MsgOrb validates the pair against Meta before storing anything, then reads your Phone Number ID from the WABA automatically.

The WABA ID and the Phone Number ID are different numbers that look alike. Pasting the Phone Number ID into the WABA ID field is the single most common cause of a failed save, and it also blocks template submission afterwards.

There is a second, equivalent form at Advanced Setup → Manual WABA Configuration (WhatsApp API Credentials). It accepts an optional Phone Number ID for the rare case where a WABA holds several numbers, and it refuses to save if the two IDs are identical.

How you know it worked

The connection card shows Successfully Connected.
The WhatsApp Number Health card below it shows your number, a messaging limit tier and a quality rating. Those values come from Meta, so they only appear once the credentials are genuinely working.

Disconnecting

The Disconnect Waitlist button on the connection card clears the stored credentials. Nothing else deletes them — a failed save attempt never overwrites a working connection.