Encuestas

Las encuestas de WhatsApp son una buena alternativa a los botones y otros mensajes interactivos. Puedes hacer una pregunta y ofrecer opciones para que el usuario elija una o varias, según la configuración.

Enviar encuesta

http
POST /api/sendPoll
jsonBody
{
  "session": "S0001",
  "chatId": "5215551234567@c.us",
  "poll": {
    "name": "¿Cómo estás?",
    "options": ["¡Genial!", "¡Bien!", "No tan bien"],
    "multipleAnswers": false
  }
}
jsonResponse
{
  "id": "true_5215551234567@c.us_83ACBAAAAAAAAAAAAAAAAAAAA"
}

Guarda el campo id de la respuesta para identificar la encuesta al recibir votos.

Votar en encuesta

http
POST /api/sendPollVote
jsonBody
{
  "chatId": "5215551234567@c.us",
  "pollMessageId": "false_5215551234567@c.us_AAAAAAAAAAAAAAAAAAAA",
  "pollServerId": null,
  "votes": ["¡Genial!"],
  "session": "S0001"
}
  • chatId — chat donde está la encuesta.
  • pollMessageId — ID del mensaje de la encuesta.
  • votes — opciones por las que votas.

Eventos

Recibes los votos de las encuestas mediante los webhooks poll.vote y poll.vote.failed (identifica los tuyos con poll.fromMe). Consulta el detalle del payload en Eventos.