Quickstart

Create a key and send your first message.

1. Connect a WhatsApp number. In the dashboard open Numbers and connect your WhatsApp Business number through Meta. The number must be active.
2. Create an API key. Open API Keys, choose a name and the scopes you need (for this guide: messages:send and messages:read). Copy the key — it starts with wk_ and is shown only once.
3. Check the key works.
   Copy

   curl https://waba.clouddns.co.in/api/v1/me \
     -H "Authorization: Bearer wk_your_key"

4. Send a template message. To start a conversation with a customer you must use an approved template. Free-form text is only allowed within 24 hours of their last message.
   Copy

   curl -X POST https://waba.clouddns.co.in/api/v1/messages \
     -H "Authorization: Bearer wk_your_key" \
     -H "Content-Type: application/json" \
     -d '{
       "to": "14155550100",
       "type": "template",
       "template": { "name": "hello_world", "language": "en_US" }
     }'

   Copy

   HTTP/1.1 202 Accepted
   
   { "id": 4812, "status": "queued", "to": "14155550100", "conversation_id": 377 }

5. Track delivery. Poll GET /messages/4812 or, better, subscribe to webhooks to be notified of message.delivered and message.read.

Related features