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
jsonCuerpo
{
  "session": "S0001",
  "chatId": "[email protected]",
  "poll": {
    "name": "¿Cómo estás?",
    "options": ["¡Genial!", "¡Bien!", "No tan bien"],
    "multipleAnswers": false
  }
}
jsonRespuesta
{
  "id": "[email protected]_83ACBAAAAAAAAAAAAAAAAAAAA"
}

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

Votar en encuesta

http
POST /api/sendPollVote
jsonCuerpo
{
  "chatId": "[email protected]",
  "pollMessageId": "[email protected]_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.