Ir al contenido

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.