WhatsApp Cloud API overview
The five Meta objects you are about to create, how they fit together, and why there is no QR code.
Before you start clicking through Meta's tools, it helps to know what you are building. Almost every setup problem comes from confusing two of these five things.
The pieces
| Thing | What it is | What the app needs |
|---|---|---|
| Meta Business Manager | The container for your company's assets on Meta. | Business ID (optional) |
| Meta App | A developer app that holds the WhatsApp product. | — |
| WhatsApp Business Account (WABA) | The messaging account that owns your numbers, templates and quality rating. | WABA ID |
| Phone number | The actual number customers message. Lives inside the WABA. | Phone Number ID, which the app reads from Meta when you pick the number |
| System user + token | A non-human account whose token lets this app act for you. | Access token |
A useful mental model: the Business Manager owns the WABA, the WABA owns the phone number, and the system-user token is the key that lets us use them.
Phone Number ID is not your phone number
+260 97 123 4567 is your display number. The Phone Number ID is a ~15
digit identifier Meta assigns to it, like 109534567891234. They are different
values and the app needs the ID. You don't have to copy it: the setup wizard
lists your numbers and fills it in when you pick one. Same trap with WABA ID vs
Business ID.
Two ways to create them
You don't have to build all five by hand:
| Connect with Facebook (recommended) | Manual setup | |
|---|---|---|
| Business Manager, WABA, phone number | Created or chosen inside a Meta window | You create them in Meta's tools |
| Meta App | Ours. You don't need one | You create one |
| System user + token | Not needed. Meta gives us access when you finish | You create the system user and paste the token |
| Best for | Most businesses | Teams that manage their own Meta assets |
With Connect with Facebook the table above still describes what exists, but Meta creates it for you and you never copy an ID or a token. See Connect with Facebook. The manual path is the sequence of pages starting at Meta Business Manager.
Why there is no QR code
If you have used other WhatsApp tools you may expect to scan a QR code with your phone. That approach drives the normal WhatsApp app through an unofficial connection. It is quick to set up and it is fragile: numbers get banned, sessions drop, and it is against Meta's terms.
This platform uses the official Cloud API only. That means:
- Your number will not get banned for using automation — this is the sanctioned path.
- Messages are hosted by Meta, so nothing depends on a phone staying online.
- You get real infrastructure: message templates, quality ratings, delivery receipts, interactive Flows, a product catalog.
- The setup is longer, because Meta verifies who you are first.
The trade is a harder first hour for a connection that does not fall over.
Two rules that shape everything
The 24-hour service window
You can only send free-form messages to someone within 24 hours of their last message to you. Outside that window you must use a pre-approved template. This is a Meta rule, not ours — the inbox shows a countdown timer on each conversation so agents can see where they stand. Full detail in The 24-hour window and templates.
Messaging limits and quality
New numbers start limited (typically 250 business-initiated conversations per day) and step up as you send well-received messages. Getting blocked or reported pushes your quality rating down and can cut your limit. See Messaging limits and quality rating.
Next
- Quickest: Connect with Facebook.
- Manual: start with Meta Business Manager.