Fetch the connected business phone number's metadata. (docs)
GET /{phone_number_id}
🟢 low
— no
What the agent can do
Capability
API call
Risk
Needs approval
Send a text (or template) message to a WhatsApp user as the business. (docs)
POST /{phone_number_id}/messages
🟡 medium
✅ yes
Connecting it
You provide: Cloud API access token
Where to get it: developers.facebook.com → your App → WhatsApp → API Setup. Copy a permanent System User access token and the Phone Number ID. Add this app's webhook URL with your Verify Token, then paste the token + Phone Number ID here.
Account needed: A Meta Business account with a WhatsApp Business Account (WABA) and a registered phone number in the WhatsApp Business Platform.
App registration: Create a Meta app (type Business) → add the WhatsApp product → in API Setup copy the Phone Number ID + a permanent System User token → configure the webhook URL + Verify Token and subscribe to the 'messages' field.
Verification required: Business verification is required to raise messaging limits and use the number in production; a test number is available for development before verification.
Testing: Meta provides a free test phone number that can message up to 5 allow-listed recipients without business verification.
Limits
Cloud API throughput tiers (e.g. 1K/10K/100K business-initiated conversations/day) that auto-scale with quality rating; per-number messaging caps apply. HTTP 429/80007 on throttle.