> ## Documentation Index
> Fetch the complete documentation index at: https://docs.briq.tz/llms.txt
> Use this file to discover all available pages before exploring further.

# Send an interactive message

> Send reply buttons or a list via POST /v1/whatsapp/messages/interactive.

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

```http theme={null}
POST https://karibu.briq.tz/v1/whatsapp/messages/interactive
```

**Headers:** `X-API-Key` (required), `Content-Type: application/json`.

## Fields

| Field             | Type   | Required | Notes                                                                                                                 |
| ----------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------- |
| `interactive`     | object | yes      | A WhatsApp interactive object; its `type` is required.                                                                |
| `to` + `sender`   | —      | target   | Customer number (E.164) and which of your numbers to send from. `sender` is optional when you have one active number. |
| `conversation_id` | uuid   | alt      | Alternative to `to` + `sender`: an existing thread to reply in.                                                       |

## Example

```bash cURL theme={null}
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](/guides/whatsapp-track-messages) or a webhook. Returns **202** `{ message_id, status: "pending" }`. Build and send a live request from the [Send an interactive message](/Karibu-WhatsApp/messages/send-interactive) reference page.