Send Interactive Buttons

POST

/v1/whatsapp/sendInteractiveButtons

Sends a WhatsApp interactive message with up to three reply buttons.

Requires a Hatif user access token and access to send conversations on the selected channel. This is not a service-account/client-credentials endpoint.

The channel must use the Official WhatsApp API provider. Each button ID must be 1–256 characters and each displayed title must be 1–20 characters.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v1/whatsapp/sendInteractiveButtons' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "channelId": "3a1da000-0000-0000-0000-000000000000",
  "contactId": "3a1e1500-0000-0000-0000-000000000000",
  "bodyText": "كيف يمكننا مساعدتك؟",
  "buttons": [
    {
      "id": "appointments",
      "title": "المواعيد"
    },
    {
      "id": "results",
      "title": "نتائج التحاليل"
    }
  ]
}'

Response Example

{
    "contactId": "3a1e1500-0000-0000-0000-000000000000",
    "status": "Sent",
    "message": "Message sent",
    "conversationEventId": "3a21fd00-0000-0000-0000-000000000000",
    "messageId": "wamid.HBgM00000000000000000000000000000000"
}

Modified at 2026-09-06 22:10:48

Send File

List Templates (Service Account)