message.button_reply

EVENTOmessage.button_replydesde M7envelope v1

Resposta de botão ou lista.

Quando é emitido

Um contato respondeu a uma mensagem de botões, lista, template ou interativa (enviada por outra ferramenta: o LiteZap só recebe). A resposta fica no log com type: button_reply. text é o texto escolhido e reply_to a mensagem dos botões, quando o WhatsApp informa.

Campos de data

Campo	Tipo	Descrição
button_reply.kind	string	button, list, template ou interactive.
button_reply.id	string	Id do botão ou da linha escolhida (interactive: nome do fluxo).
button_reply.title	string	Texto mostrado na escolha.
button_reply.description	string	Descrição da linha (lista) ou parâmetros JSON (interactive) (opcional).

O envelope (id, type, version, instance_id, timestamp,data) está em Visão geral. Campos novos podem ser adicionados emdata sem mudar a versão: ignore os que não conhecer.

Exemplos

Corpo do POST

{
  "id": "evt_3d9a1f7c5e2b8046",
  "type": "message.button_reply",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T10:05:00.000Z",
  "data": {
    "id": "msg_4b8e2d0a6c1f3957",
    "wa_message_id": "3A9C2E5B1D4F7A0C3E6B",
    "chat": "5511999999999@s.whatsapp.net",
    "sender": "5511999999999@s.whatsapp.net",
    "from_me": false,
    "source": "contact",
    "type": "button_reply",
    "text": "Plano mensal",
    "reply_to": "3EB0C4D5E6F7A8B9C0D1E2",
    "button_reply": {
      "kind": "list",
      "id": "plano_mensal",
      "title": "Plano mensal"
    },
    "timestamp": "2026-10-18T10:05:00Z"
  }
}

Entrega e ordem

• Por webhook: pelo menos uma vez, com retry por até 24 horas. O mesmo evento pode chegar duas vezes: deduplique porX-LiteZap-Event-Id. Veja Entrega e retentativas.
• A ordem entre eventos não é garantida (retentativas reordenam): use timestamp.
• Por SSE: ao vivo, sem replay. Veja Tempo real com SSE.
• Para assinar só este tipo: "events": ["message.button_reply"] no webhook, ou?types=message.button_reply no SSE.

Relacionados: message.received

Equivalente na Z-API: Responder botão / lista (recebimento).