Skip to main content
POST
/
send-button-list
curl --request POST \
  --url https://zapi.hubmessage.io/channels/{channel_id}/token/{channel_token}/send-button-list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "5511999999999",
  "message": "Como você avalia nosso atendimento?",
  "buttonList": {
    "buttons": [
      {
        "id": "1",
        "label": "Ótimo"
      },
      {
        "id": "2",
        "label": "Bom"
      },
      {
        "id": "3",
        "label": "Regular"
      }
    ]
  }
}
'
{
  "zaapId": "3999984263738042930CD6ECDE9VDWSA",
  "messageId": "D241XXXX732339502B68",
  "id": "D241XXXX732339502B68"
}

​
Overview

Method for sending messages with quick selection buttons. The recipient can choose from the presented options, which work as a reply to the message. Optionally, you can include an image or video with the buttons by adding the image or video field inside buttonList.
Send only image or video, never both at the same time.
The response structure is identical to Z-API. Your existing code that processes these returns will continue working without changes.

Authorizations

​
Authorization
string
header
required

Secret Key gerada no painel de Segurança do Hub Message

Body

application/json
​
phone
string
required

Telefone do destinatário (DDI + DDD + número)

Example:

"5511999999999"

​
message
string
required

Texto da mensagem (obrigatório, não pode ser vazio)

​
buttonList
object
required

Configuração dos botões

​
delayMessage
integer

Delay em segundos antes do envio (1-15)

Required range: 1 <= x <= 15

Response

Mensagem enviada com sucesso

​
zaapId
string

Identificador interno

​
messageId
string

ID da mensagem no WhatsApp

​
id
string

Mesmo valor do messageId (compatibilidade)