Skip to main content
Use POST /v1/whatsapp/messages/template to send an approved template. Templates are always allowed (no open window required) and reopen the 24-hour window, so they are how you start a conversation or re-engage after the window closes.

​
Endpoint

POST https://karibu.briq.tz/v1/whatsapp/messages/template
Headers: X-API-Key (required), Content-Type: application/json.

​
Fields

FieldTypeRequiredNotes
template_namestringyesName of an APPROVED template. See Senders & templates.
variablesobjectnoVariable values, e.g. { "1": "A1234" }. Keys match the template’s parameters.
tostringtargetThe customer number in E.164. The number you are messaging.
senderstringnoWhich of your numbers to send from. Optional when your workspace has one active sender.
conversation_iduuidaltAlternative to to + sender: an existing thread to send into.

​
Example

cURL
curl -X POST "https://karibu.briq.tz/v1/whatsapp/messages/template" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "to": "255712345678", "template_name": "order_update", "variables": { "1": "A1234" } }'
Templates with a media header (image/video/document) carry the header media on the template itself; the backend resolves it at send time. You do not pass header media in this body. See Senders & templates.
Returns 202 { message_id, status: "pending" }. Then track delivery. Build and send a live request from the Send a template message reference page.