message.poll_vote

EVENTOmessage.poll_votedesde M6envelope v1

Voto em enquete.

Quando é emitido

Alguém votou numa enquete. selected_options é o voto atual da pessoa (lista vazia = voto retirado), com as opções já decifradas pelo texto da enquete no log. Votos não ficam no log, só neste evento. Votos em enquetes criadas antes do pareamento não são decifrados (contam em unknown_options).

Campos de data

Campo	Tipo	Descrição
poll_id	string	Id LiteZap da enquete (opcional).
poll_wa_message_id	string	Id no WhatsApp da enquete.
chat	string	JID do chat.
voter	string	Quem votou.
push_name	string	Nome de perfil de quem votou (opcional).
from_me	boolean	Voto deste número.
selected_options	array	Opções escolhidas; vazia quando o voto foi retirado.
unknown_options	integer	Opções que não puderam ser decifradas (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_9e3b7d1a5c0f4628",
  "type": "message.poll_vote",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T11:02:15.880Z",
  "data": {
    "poll_id": "msg_5c8e1a3f7b2d4069",
    "poll_wa_message_id": "3EB0D2E4F6A8B0C1D3E5F7",
    "chat": "5511999999999@s.whatsapp.net",
    "voter": "5511999999999@s.whatsapp.net",
    "push_name": "Maria",
    "from_me": false,
    "selected_options": [
      "Terça às 14h"
    ],
    "timestamp": "2026-10-18T11:02:15Z"
  }
}

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.poll_vote"] no webhook, ou?types=message.poll_vote no SSE.

Relacionados: message.received

Equivalente na Z-API: Ao receber (voto de enquete).