Enviar botões

Envia uma mensagem interativa com botões de resposta rápida (máximo 3 botões).

Endpoint

POST /chat/send/buttons

Parâmetros

Nome	Tipo	Obrigatório	Descrição
to	string	Sim	JID do destinatário
body	string	Sim	Texto principal da mensagem
footer	string	Não	Texto do rodapé
buttons	object[]	Sim	Lista de botões (máx 3)
buttons[].id	string	Sim	Identificador único do botão
buttons[].text	string	Sim	Texto exibido no botão

Request

cURL

curl -X POST https://endpoint.wi.api.br/chat/send/buttons \
  -H "x-api-key: $WIAPI_KEY" \
  -H "x-instance: session_01" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511998765432@s.whatsapp.net",
    "body": "Seu pedido #4521 está pronto. O que deseja fazer?",
    "footer": "Responda em até 24h",
    "buttons": [
      { "id": "confirmar", "text": "Confirmar entrega" },
      { "id": "reagendar", "text": "Reagendar" },
      { "id": "cancelar", "text": "Cancelar pedido" }
    ]
  }'

JavaScript

const response = await fetch("https://endpoint.wi.api.br/chat/send/buttons", {
  method: "POST",
  headers: {
    "x-api-key": process.env.WIAPI_KEY,
    "x-instance": "session_01",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "5511998765432@s.whatsapp.net",
    body: "Seu pedido #4521 está pronto. O que deseja fazer?",
    footer: "Responda em até 24h",
    buttons: [
      { id: "confirmar", text: "Confirmar entrega" },
      { id: "reagendar", text: "Reagendar" },
      { id: "cancelar", text: "Cancelar pedido" },
    ],
  }),
});

const data = await response.json();

Python

import requests

response = requests.post(
    "https://endpoint.wi.api.br/chat/send/buttons",
    headers={
        "x-api-key": WIAPI_KEY,
        "x-instance": "session_01",
    },
    json={
        "to": "5511998765432@s.whatsapp.net",
        "body": "Seu pedido #4521 está pronto. O que deseja fazer?",
        "footer": "Responda em até 24h",
        "buttons": [
            {"id": "confirmar", "text": "Confirmar entrega"},
            {"id": "reagendar", "text": "Reagendar"},
            {"id": "cancelar", "text": "Cancelar pedido"},
        ],
    },
)

data = response.json()

Response

{
  "messageId": "3EB0E9F0A1B2C3D40F5A27",
  "messageid": "3EB0E9F0A1B2C3D40F5A27"
}