Skip to main content
POST
/
instances
/
{instanceId}
/
token
/
{instanceToken}
/
send-button-list
curl --request POST \
  --url https://api.ezapi.com.br/instances/{instanceId}/token/{instanceToken}/send-button-list \
  --header 'Client-Token: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "{{PHONE}}",
  "message": "O WA Gateway é bom?",
  "buttonList": {
    "buttons": [
      {
        "id": "1",
        "label": "Botão 1"
      },
      {
        "id": "2",
        "label": "Botão 2"
      }
    ]
  }
}
'
{
  "messageId": "3EB047ED70306656281B34",
  "id": "3EB047ED70306656281B34"
}
{
  "error": "Unauthorized",
  "message": "Invalid instanceToken"
}
{
  "error": "Instance not found"
}
{
  "error": "Worker command timeout"
}
{
  "error": "Unable to process request"
}
Envia botões rápidos com cabeçalho de texto, imagem ou vídeo.
Aliases consolidados da collection: Enviar texto com botões, Enviar botões com imagem, Enviar botões com vídeo.
As variações com cabeçalho de texto, imagem e vídeo da collection foram consolidadas nesta página usando exemplos separados.

Authorizations

​
Client-Token
string
header
required

Path Parameters

​
instanceId
string
required

Identificador único da instância.

Example:

"abc1234567890"

​
instanceToken
string
required

Token privado da instância retornado na criação.

Example:

"tok_a1b2c3d4e5f6"

Body

application/json
​
phone
string
required

Número com código do país (ex: 554499999999) ou JID de grupo (ex: 120363123456789@g.us)

Example:

"{{PHONE}}"

​
message
string
required
Example:

"O WA Gateway é bom?"

​
buttonList
object
required
Example:
{
  "buttons": [
    { "id": "1", "label": "Botão 1" },
    { "id": "2", "label": "Botão 2" }
  ]
}
​
mentioned
string[]

Lista de números para mencionar em grupos

Example:
["554499999999"]
​
mentionsEveryOne
boolean
default:false

Mencionar todos os participantes do grupo

Response

Resposta de sucesso.

​
messageId
string
required
Example:

"3EB047ED70306656281B34"

​
id
string
required
Example:

"3EB047ED70306656281B34"