HelloBotz API overview

Authentication

Use a Bearer API token from your workspace settings. Never expose tokens in client-side code.

Authorization: Bearer YOUR_API_KEYCopy

WhatsApp Messages

Send session or template messages via REST endpoints scoped to your WABA.

POST /v1/messages
{ "to": "9198XXXXXXXX", "type": "text", "text": { "body": "Hello" } }Copy

Contacts

Create and update contacts, tags and custom fields for CRM alignment.

Templates

List approved templates and send utility/marketing messages within Meta policy.

Broadcasts

Create campaigns against segments; track delivery and replies in analytics.

Webhooks

Receive message status and inbound events on your HTTPS endpoint.

API Errors

Standard HTTP codes with JSON error body. Retry safely on 429/5xx with backoff.

Code examples

curl -X POST https://api.hellobotz.com/v1/messages \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"9198XXXXXXXX","type":"text","text":{"body":"Hello"}}'Copy

$ch = curl_init('https://api.hellobotz.com/v1/messages');
curl_setopt_array($ch, [CURLOPT_POST=>true, CURLOPT_HTTPHEADER=>['Authorization: Bearer '.$key,'Content-Type: application/json'], CURLOPT_POSTFIELDS=>json_encode($payload)]);Copy

await fetch('https://api.hellobotz.com/v1/messages', {
  method: 'POST',
  headers: { Authorization: 'Bearer '+key, 'Content-Type': 'application/json' },
  body: JSON.stringify({ to: '9198XXXXXXXX', type: 'text', text: { body: 'Hello' } })
});Copy

requests.post('https://api.hellobotz.com/v1/messages', headers={'Authorization': f'Bearer {key}'}, json=payload)Copy