Send Interactive Buttons Message

post

https://live-mt-server.wati.io/{tenantId}/api/v1/sendInteractiveButtonsMessage

Status code 200 means the message was accepted by WATI, not delivered yet.
To know if a message is failed, listen to the Session Message Failed webhook.
To know if a message is sent successfully, listen to Delivered/Read/Reply webhooks.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

tenantId

string

required

Your WATI workspace (tenant) ID. This required path segment identifies the WATI account for legacy v1 and v2 API requests.

Query Params

whatsappNumber

string

WhatsApp Number with country code. Example, 85264318721. Optional when target is provided.

target

string

Polymorphic recipient identifier. Accepts a phone number, ContactId, or BSUID. When provided, takes precedence over whatsappNumber. BSUID resolution requires the wati_contact_bsuid_support Statsig gate to be enabled for the tenant.

channelPhoneNumber

string

Channel phone number with country code. Example, 85264318722

Body Params

InteractiveButtonsMessage

Header:
{
"type": "Text or Video or Image or Document",
"text": "header text for type Text",
"media": {
"url": "https://...", // (media obj should be not empty for non Text types)
"fileName": "MyDoc.pdf" } // (this field is only Document type)
}

Buttons:

allowed count: 1–3
Allowed characters length after mapping:
- header text: 60
- body text: 1024
- footer text: 60
- button's text: 20

body

string | null

footer

string | null

header

object

buttons

array of objects | null

buttons

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/json-patch+json

Generated from available request content types

Allowed:

Response

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain

application/json

text/json

200OK