Skip to main content
POST
/
instances
/
{instanceId}
/
token
/
{instanceToken}
/
send-button-actions
curl --request POST \
  --url https://api.ezapi.com.br/instances/{instanceId}/token/{instanceToken}/send-button-actions \
  --header 'Client-Token: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "{{PHONE}}",
  "message": "mensagem",
  "title": "se quiser vincular um título",
  "footer": "se quiser vincular um rodapé",
  "buttonActions": [
    {
      "id": "1",
      "type": "CALL",
      "phone": "{{PHONE}}",
      "label": "Fale conosco"
    },
    {
      "id": "2",
      "type": "URL",
      "url": "https://www.wikipedia.org",
      "label": "Visite nosso site"
    }
  ]
}
'
{
  "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 com ações do tipo resposta, chamada ou URL.
Aliases consolidados da collection: Enviar texto com botões de ação.
Os botões de resposta rápida aceitam no máximo 3 opções. Ações de chamada e URL podem ser combinadas conforme o payload enviado.

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:

"mensagem"

​
title
string
required
Example:

"se quiser vincular um título"

​
footer
string
required
Example:

"se quiser vincular um rodapé"

​
buttonActions
object[]
required
Example:
[
  {
    "id": "1",
    "type": "CALL",
    "phone": "{{PHONE}}",
    "label": "Fale conosco"
  },
  {
    "id": "2",
    "type": "URL",
    "url": "https://www.wikipedia.org",
    "label": "Visite nosso site"
  }
]
​
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"