Tu primera llamada en cinco minutos

De cero a una sesión en vivo creada por API, sin salir de esta página.

Antes de empezar

  • Una cuenta con plan de pago: la API no está incluida en FREE (la referencia entera sí puedes explorarla sin pagar).
  • Una presentación en tu espacio: la sesión que vas a crear proyecta una presentación existente.

  1. Crea tu credencial

    En tu espacio, entra en Empresa → API y crea una credencial con el scope content:write. El secreto se muestra una sola vez: guárdalo.

    Obtén tu API key

    La credencial pertenece a la organización, no a tu usuario: cualquier administrador puede revocarla y cada uso queda en el registro de auditoría. Pide solo los scopes que necesites — results:read para leer, content:write para crear y conducir.

  2. Crea y abre una sesión

    Con tu clave en la cabecera X-API-Key, crea una sesión sobre una presentación existente y ábrela.

    curl -X POST https://api.votinova.prd.atbionapps.com/public/v1/sessions \
  -H "X-API-Key: vz_live_…" \
  -d '{ "presentation_id": "prs_8f3k2" }'

curl -X POST https://api.votinova.prd.atbionapps.com/public/v1/sessions/ses_71xw9/open \
  -H "X-API-Key: vz_live_…"

    La sesión nace en DRAFT; al abrirla recibe su join_code y la sala queda lista. Fíjate en las cabeceras X-RateLimit-* de la respuesta: viajan siempre y te dicen cuánto presupuesto de peticiones te queda en la ventana de 60 segundos.

  3. Recibe los resultados

    Registra un webhook para question.results.finalized y recibe los agregados firmados en tu backend.

    curl -X POST https://api.votinova.prd.atbionapps.com/public/v1/webhooks \
  -H "X-API-Key: vz_live_…" \
  -d '{ "url": "https://example.com/hooks/votinova",
        "event_types": ["question.results.finalized"] }'

    Guarda el signing_secret que devuelve el alta: se muestra una sola vez y es lo que te permite verificar cada entrega. La guía de webhooks trae la verificación lista para pegar en tres lenguajes.

Si algo no cuadra

  • 401 — falta la cabecera X-API-Key o el scope: el cuerpo te dice en required_scope exactamente cuál.
  • 402 — tu plan no incluye la API: el cuerpo trae upgrade_to con el plan que la desbloquea.
  • 429 — presupuesto agotado en esta ventana: espera retry_after_seconds y reintenta con backoff.

¿Y ahora qué?

Explora la referencia completa, prueba cada endpoint online y conecta Zapier o tu agente por MCP.

Referencia de API →