Apariencia
message.poll_vote
Se envía cuando: alguien votó en una encuesta, cambió su voto o lo quitó: el contacto, un participante del grupo o tu número desde su teléfono.
Qué trae data: El objeto message (con poll ya actualizado: cuántos votos tiene cada opción y el voto de cada persona) y vote: from (el teléfono de quien votó; null si fue tu número), from_me, options (las opciones que eligió, por su nombre; vacía si quitó su voto) y voted_at.
Para qué sirve: Confirmar citas, levantar pedidos o medir respuestas sin leer el chat. WhatsApp manda la elección completa cada vez: el último message.poll_vote de una persona es su voto actual.
Ejemplo
El cuerpo que recibe tu servidor (datos ficticios):
json
{
"id": "evt_01EXAMPLE00000000000000016",
"type": "message.poll_vote",
"created_at": "2026-01-01T12:05:30.000000Z",
"workspace_id": "ten_01EXAMPLE00000000000000000",
"data": {
"message": {
"id": "msg_01EXAMPLE00000000000000016",
"instance_id": "ins_01EXAMPLE00000000000000000",
"direction": "inbound",
"from_me": false,
"source": null,
"api_key_id": null,
"type": "poll",
"status": "received",
"to": null,
"from": "5255000000002",
"from_name": "Ana López",
"group_id": null,
"text": null,
"caption": null,
"media": null,
"location": null,
"contacts": null,
"poll": {
"question": "Which day works for delivery?",
"multiple": false,
"options": [
{
"name": "Monday",
"votes": 0
},
{
"name": "Tuesday",
"votes": 1
}
],
"voters": 1,
"votes": [
{
"from": "5255000000002",
"from_me": false,
"options": [
"Tuesday"
],
"voted_at": "2026-01-01T12:05:30+00:00"
}
],
"votes_available": true
},
"reply_to": null,
"forwarded": false,
"reactions": [],
"error": null,
"created_at": "2026-01-01T11:59:59+00:00",
"queued_at": null,
"sent_at": null,
"delivered_at": null,
"read_at": null,
"failed_at": null,
"received_at": "2026-01-01T11:59:59+00:00",
"edited_at": null,
"deleted_at": null
},
"vote": {
"from": "5255000000002",
"from_me": false,
"options": [
"Tuesday"
],
"voted_at": "2026-01-01T12:05:30+00:00"
}
}
}Todos los eventos comparten el mismo sobre (id, type, created_at, workspace_id, data) y los mismos headers de firma. Cómo verificarla, qué responder y cómo se reintenta: Webhooks.