whatsapp-number-onboardinglisted
Install: claude install-skill RabbitDesigns22/claude-skills
# WhatsApp number onboarding (Meta Cloud API)
Connecting a number looks like 10 clicks. In practice it fails on the order
of steps, on which portfolio owns what, and on Meta screens that say
"connected" when nothing is delivered. This skill is the safe order plus the
blocks that actually happened, with their fixes.
**Confidence tags used below:** `[official]` = stated on developers.facebook.com
(URL in the table); `[field]` = happened in real onboardings and the fix was
confirmed live; `[unconfirmed]` = seen, cause or fix never proven. Never present
`[field]` or `[unconfirmed]` as Meta policy.
## Words: never mix these four
- **Business portfolio** (Business Manager): the company in Meta.
- **WhatsApp Business Account (WABA)**: lives inside a portfolio. In the UI, use the **Messaging account** ID, not the "WhatsApp account/presence" ID (the latter returns "This API is not supported") `[field]`.
- **Phone number**: lives inside a WABA. Its **Phone number ID** is not the phone number.
- **Meta app**: lives in a developer account and is linked to a portfolio; it holds the token, app secret and webhook.
When you state a limit, say which of the four it is about.
## Limits that decide the plan `[official]`
- A new portfolio can register **2 phone numbers**; the cap rises to **20** when the business is verified or reaches the 2,000 messaging limit.
- Messaging limits are **per portfolio, shared by all its numbers**: 250 → 2,000 → 10,000 → 100,000 → unlimited. One busy number ca