Skip to main content
Use POST /v1/whatsapp/messages/interactive to send reply buttons or a list. You pass a WhatsApp interactive object through as-is; its type (e.g. button, list) is required. Needs an open 24-hour window.

​
Endpoint

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

​
Fields

FieldTypeRequiredNotes
interactiveobjectyesA WhatsApp interactive object; its type is required.
to + sender—targetCustomer number (E.164) and which of your numbers to send from. sender is optional when you have one active number.
conversation_iduuidaltAlternative to to + sender: an existing thread to reply in.

​
Example

cURL
curl -X POST "https://karibu.briq.tz/v1/whatsapp/messages/interactive" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "to": "255712345678",
    "interactive": {
      "type": "button",
      "body": { "text": "Did this resolve your issue?" },
      "action": { "buttons": [
        { "type": "reply", "reply": { "id": "yes", "title": "Yes" } },
        { "type": "reply", "reply": { "id": "no", "title": "No" } }
      ] }
    }
  }'
The customer’s button or list choice arrives as an inbound message — read it via tracking or a webhook. Returns 202 { message_id, status: "pending" }. Build and send a live request from the Send an interactive message reference page.