Documentation
Everything you need to integrate and build with Waalfa API.
Getting Started
Follow these quick steps to set up your integration and send your first message in minutes.
1. Register Account
Create your sandbox or official production account to gain API credentials.
2. Configure Meta WhatsApp Business
Link your business phone number and complete verification directly from the dashboard panel.
3. Send Test Request
Copy your API key from Settings and execute a quick POST query:
curl -X POST "https://api.waalfa.com/api/v1/messages/send" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "1234567890",
"template_name": "hello_world"
}'
Authentication
All API calls are authenticated using secure Bearer tokens in the HTTP Authorization headers.
API Reference
Base URL
Common Endpoints
POST /messages/send
Send Template
Send approved template messages to users globally.
GET /templates
Get Templates
Fetch list of approved message templates.
POST /broadcasts
Create Broadcast
Launch mass broadcast campaign to contact segments.
Webhooks
Register an HTTPS endpoint to receive live status updates such as delivery, read receipts, and user replies.
message.delivered
Fires when WhatsApp delivers the message to the user device.
message.read
Fires when the user opens the WhatsApp conversation.
{
"event": "message.delivered",
"data": {
"message_id": "msg_8845239",
"to": "12025550199",
"status": "delivered"
}
}
Message Templates
All business-initiated conversations on WhatsApp require verified templates approved by Meta.
Required Template Parameters
Templates can contain variables like 1, which are replaced during dispatch. Meta categorizes templates under: UTILITY, MARKETING, and AUTHENTICATION (OTPs).
Best Practices
To keep your WhatsApp account quality rating in the green, follow these best practices:
- Always secure explicit opt-in confirmation before messaging users.
- Provide clear, immediate opt-out options (e.g. reply STOP to unsubscribe).
- Use exponential backoff retry algorithms when webhook deliveries time out.
Need More Help?
Our engineers and support specialist team are ready to assist you with API configurations.
Contact Developer Support