Documentation Index
Fetch the complete documentation index at: https://docs.wazzapi.com/llms.txt
Use this file to discover all available pages before exploring further.
Sending Messages
The WazzAPI API supports direct sends, scheduled sends, retries, media messages, and interactive message types.
Text Messages
Use the /api/v1/messages/send endpoint for standard text messages.
curl -X POST https://api.wazzapi.com/api/v1/messages/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "6281234567890",
"content": "Hello, world!",
"message_type": "text",
"whatsapp_account_id": "00000000-0000-0000-0000-000000000000"
}'
You can also send images, videos, documents, and voice messages using public media URLs.
curl -X POST https://api.wazzapi.com/api/v1/messages/send/image \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "6281234567890",
"media_url": "https://example.com/image.png",
"caption": "Product preview",
"whatsapp_account_id": "00000000-0000-0000-0000-000000000000"
}'
Location Messages
Use location messages to share a pin with latitude and longitude.
curl -X POST https://api.wazzapi.com/api/v1/messages/send/location \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "6281234567890",
"message_type": "location",
"latitude": -6.208763,
"longitude": 106.845599,
"location_title": "Jakarta HQ",
"location_address": "Central Jakarta",
"whatsapp_account_id": "00000000-0000-0000-0000-000000000000"
}'
WhatsApp Group Messages
Send messages directly to WhatsApp groups using the groups API. The API automatically looks up the group name from the backend and stores it with the message record.
curl -X POST https://api.wazzapi.com/api/v1/groups/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"session_name": "my-session",
"group_jid": "[email protected]",
"text": "Hello everyone!"
}'
curl -X POST https://api.wazzapi.com/api/v1/groups/send/media \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"session_name": "my-session",
"group_jid": "[email protected]",
"media_url": "https://example.com/photo.jpg",
"media_type": "image",
"caption": "Check this out!"
}'
Supported types for groups: text, image, video, voice, document. Templates and interactive messages are not supported for groups.
Other supported message types
The API also supports:
- voice messages
- video messages
- contact-card messages
- interactive button messages
- interactive list messages
Scheduling, retries, and status
In addition, the API supports:
scheduled_for on send requests for future delivery
- retrying failed messages
- cancelling scheduled messages
- lookup by provider ID and message statistics