Integra encuestas en vivo en tu producto con la API de PollsLive

Si tu producto tiene audiencia —una herramienta de webinars, un LMS, una plataforma de comunidad, una app de eventos— tarde o temprano querrás encuestas dentro de él. Construir votación en tiempo real, antifraude y una interfaz de resultados desde cero son meses de trabajo. Integrar PollsLive es una tarde. Este es el camino para desarrolladores: crea una encuesta, inserta el embed, lee resultados y recibe webhooks, con llamadas reales a /api/v1.

Autenticación: un único token Bearer

Genera una clave de API de workspace en Studio → Developers (se ven como `plv_live_…`) y envíala como token Bearer. Sin baile de OAuth para uso servidor-a-servidor; OAuth client-credentials está disponible cuando necesitas alcance por inquilino.

export POLLSLIVE_API=https://pollslive.com/api/v1
export POLLSLIVE_KEY=plv_live_xxxxxxxxxxxxxxxxxxxx

# Every request carries the key as a Bearer token:
#   Authorization: Bearer $POLLSLIVE_KEY
# Rate limit: 120 requests/min per key (HTTP 429 if exceeded).

Paso 1 — Crea una encuesta desde tu código

Una encuesta es un deck tipado: content.questions es un array de diapositivas, cada una con un discriminador kind. POST /polls devuelve la nueva encuesta, incluido su slug, que es todo lo que necesitas para insertarla.

curl -sS -X POST "$POLLSLIVE_API/polls" \
  -H "Authorization: Bearer $POLLSLIVE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Which feature should we build next?",
    "renderingMode": "ASYNC",
    "content": {
      "questions": [{
        "id": "next",
        "kind": "multiple_choice",
        "text": "Which feature should we build next?",
        "options": [
          { "id": "a", "label": "Dark mode" },
          { "id": "b", "label": "Mobile app" },
          { "id": "c", "label": "Public API" }
        ]
      }]
    }
  }'
# → { "poll": { "slug": "which-feature-x7f2", ... } }

Paso 2 — Insértala en tu interfaz

Coloca la encuesta en cualquier página con un iframe de una línea: sin SDK, sin librería cliente y sin rastreadores de terceros viajando con ella. Se adapta a su contenedor y funciona dentro de React, WordPress, Webflow o HTML plano.

<iframe
  src="https://pollslive.com/embed/which-feature-x7f2"
  width="100%" height="520"
  style="border:0;border-radius:12px"
  loading="lazy" title="PollsLive poll"></iframe>

Paso 3 — Lee los resultados cuando los necesites

Obtén los conteos bajo demanda para tus propios paneles, o exporta un CSV para informes. Los resultados vuelven por diapositiva con conteos y (para escalas) promedios.

curl -sS "$POLLSLIVE_API/polls/POLL_ID/results" \
  -H "Authorization: Bearer $POLLSLIVE_KEY"
# → { "questions": [ { "id": "next", "options": [
#       { "id": "a", "label": "Dark mode",  "count": 64 },
#       { "id": "b", "label": "Mobile app", "count": 41 },
#       { "id": "c", "label": "Public API", "count": 95 } ] } ] }

Paso 4 — Recibe actualizaciones con webhooks

Sondear la API funciona, pero los webhooks son mejores. Registra un endpoint y PollsLive envía eventos firmados con HMAC —vote.created, poll.published, session.started/ended— para que tu app reaccione en tiempo real. Verifica la firma y luego actualiza tu interfaz o reenvía el evento.

import crypto from "node:crypto";

export function verify(rawBody, signature, secret) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Ese es todo el ciclo: crear, insertar, leer, reaccionar. Para la referencia completa —cada endpoint, scope y tipo de evento— consulta la documentación para desarrolladores, y para un ejemplo práctico, llevar resultados en vivo a un panel interno con webhooks.