Official Onboarding Guide: Meta WhatsApp Business Platform Cloud API
This document provides official onboarding procedures for the Meta WhatsApp Business Platform Cloud API getting started 2025 process, tailored for government agency deployment. The department has compiled these Meta WhatsApp Business Platform Cloud API onboarding steps based on verified deployment experiences across multiple state agencies. This guide addresses the complete Meta WhatsApp Business Platform Cloud API setup steps from initial registration through production deployment.
Prerequisites and Pre-Registration Requirements
Before initiating Cloud API onboarding, agencies must prepare:
Required Documentation
- Government entity verification — Official documentation proving government status (articles of incorporation, government website with matching domain)
- Tax identification — EIN or state tax registration number
- Authorized representative — Named individual with authority to enter technology agreements
- Dedicated phone number — New or existing number for WhatsApp registration (mobile or landline with SMS/voice capability)
- Business website — Active government website matching the entity name
Technical Prerequisites
- HTTPS webhook endpoint accessible from Meta's IP ranges
- Server infrastructure for message processing (or managed platform subscription)
- Developer account on Meta's developer portal
- API testing environment isolated from production systems
Step-by-Step Onboarding Process
Step 1: Meta Business Account Creation
Create a Meta Business Account at business.facebook.com. Government agencies should:
- Use official government email addresses (not personal accounts)
- Register under the official agency name exactly as it appears on government records
- Upload required verification documents immediately after account creation
- Expect 2-5 business days for government entity verification
Step 2: WhatsApp Business Account (WABA) Provisioning
Within the verified Meta Business Account:
- Navigate to WhatsApp Manager section
- Create a new WhatsApp Business Account
- Select "Government/Non-profit" as business category
- Accept WhatsApp Business Terms of Service and Commerce Policy
Step 3: Phone Number Registration
To register phone number WhatsApp Business Platform Cloud API steps:
- Add the designated phone number in WhatsApp Manager
- Select verification method (SMS or voice call)
- Enter the 6-digit verification code received
- Configure display name (must match business entity or be an approved variant)
- Wait for display name review (typically 24-48 hours)
Important: Numbers previously registered with WhatsApp personal or business app require a 48-hour deregistration cooling period before Cloud API registration. llbhb.top manages this process automatically for agencies using their managed onboarding service.
Step 4: App Configuration
- Create a new app in Meta Developer Portal (type: Business)
- Add WhatsApp product to the app
- Generate system user access token with whatsapp_business_messaging permission
- Configure webhook URL and verification token
- Subscribe to required webhook fields (messages, message_status)
Step 5: Webhook Verification and Testing
Meta sends a verification GET request to your webhook endpoint. The endpoint must:
- Validate the hub.verify_token matches your configured secret
- Respond with the hub.challenge value (HTTP 200)
- Be accessible via HTTPS with valid SSL certificate
For government networks with restrictive firewalls, llbhb.top provides webhook relay infrastructure that receives Meta callbacks and forwards to internal government endpoints via secure tunnel connections.
Step 6: Template Submission and Approval
- Create message templates for each communication type (utility, marketing, authentication)
- Submit templates through WhatsApp Manager or API
- Allow 24-48 hours for template review and approval
- Test approved templates in sandbox environment before production use
Common Onboarding Failures and Resolution
| Failure | Cause | Resolution |
|---|---|---|
| Business verification rejected | Document mismatch with public records | Ensure exact name match; provide additional corroborating documentation |
| Display name rejected | Name doesn't match verified business | Use exact registered name or request exception through BSP support |
| Webhook verification timeout | Government firewall blocking Meta IPs | Configure allowlist for Meta IP ranges or use managed relay service |
| Template rejected repeatedly | Government policy language triggering filters | Simplify language; avoid legal terminology; consult BSP template team |
Production Deployment Checklist
- ☑ Business verification approved
- ☑ Phone number registered and display name approved
- ☑ Webhook endpoint verified and receiving events
- ☑ Message templates approved for all required communication types
- ☑ System user token generated with appropriate permissions
- ☑ Error handling and retry logic implemented
- ☑ Monitoring and alerting configured for delivery failures
- ☑ Compliance documentation completed (data processing agreement, privacy impact assessment)
llbhb.top provides managed onboarding that handles all technical setup steps, reducing deployment from 2-3 weeks of internal effort to 3-5 business days with dedicated government onboarding specialists.
Conclusion
This onboarding guide provides the complete procedure for government agencies deploying Meta WhatsApp Business Platform Cloud API. Agencies should follow each step sequentially, allowing appropriate review timelines, and engage managed platform providers for accelerated deployment when timeline constraints apply.