Skip to main content
POST
/
instances
/
{INSTANCE_ID}
/
token
/
{INSTANCE_TOKEN}
/
send-button-actions
Enviar Botões de Ação
curl --request POST \
  --url https://api.example.com/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-button-actions

​
Descrição

Envia uma mensagem interativa com até 3 botões de resposta rápida. Quando o destinatário clica em um botão, a resposta é recebida como uma mensagem com o texto do botão selecionado.

​
Request

​
Headers

Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json

​
Body

{
  "phone": "5511999999999",
  "message": "Como posso ajudar?",
  "title": "Suporte",
  "footer": "Bliper API",
  "buttons": [
    {"id": "1", "text": "Ver planos"},
    {"id": "2", "text": "Falar com vendas"},
    {"id": "3", "text": "Suporte técnico"}
  ]
}
CampoTipoObrigatórioDescrição
phonestringSimNúmero do destinatário no formato DDI+DDD+número
messagestringSimTexto principal da mensagem
titlestringNãoTítulo exibido acima da mensagem
footerstringNãoRodapé exibido abaixo dos botões
buttonsarraySimLista de botões, cada um com id e text (máximo 3)

​
Response

​
Sucesso (202)

{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}

​
Exemplo cURL

curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-button-actions' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Como posso ajudar?",
    "title": "Suporte",
    "footer": "Bliper API",
    "buttons": [
      {"id": "1", "text": "Ver planos"},
      {"id": "2", "text": "Falar com vendas"},
      {"id": "3", "text": "Suporte técnico"}
    ]
  }'
Limitado a 3 botões por mensagem conforme as regras do WhatsApp. Para listas com mais opções, use o endpoint /send-button-list.