Per a desenvolupadors

Construeix amb Votinova

API REST, webhooks, connectors i un servidor MCP. Tot el que fa l'aplicació web també és a l'API: crea una sessió, obre-la i porta't els resultats al teu sistema en menys de cinc minuts.

  1. Crea una credencial al teu espai de treball: dos àmbits, per a tota l'organització.
  2. Fes la teva primera crida: crea i obre una sessió des de curl.
  3. Subscriu-te a un webhook i rep els resultats a mesura que es tanca cada pregunta.
curl -X POST https://api.votinova.prd.atbionapps.com/public/v1/sessions \  -H "X-API-Key: vz_live_…" \  -d '{ "presentation_id": "prs_8f3k2" }' 200 OK   · X-RateLimit-Remaining: 119{  "id": "ses_71xw9",  "join_code": "482913",  "state": "LIVE"}

Totes les superfícies, un sol contracte

Totes les integracions surten del mateix document OpenAPI. Un extrem nou apareix a tot arreu alhora.

API REST

Extrems públics amb àmbits, quotes per pla i paginació per cursor.

Referència de l'API

Webhooks

Esdeveniments signats amb HMAC, amb reintents amb espera creixent i reenviament manual.

Guia de webhooks

Zapier

Activadors i accions per automatitzar sense escriure codi.

Veure la integració

Power Automate

Connector amb activador de webhook per a l'ecosistema de Microsoft.

Veure la integració

Servidor MCP

Eines derivades del document OpenAPI per als teus agents. Remot i sense instal·lar res.

Configura l'MCP

Complements

PowerPoint, Google Slides, Teams, Zoom i Webex.

Veure els complements

Què hi construeix la gent

Els resultats al teu CRM
Sincronitza respostes i assistència amb el teu CRM o el teu magatzem de dades just quan es tanca cada pregunta: t'ho diu un webhook, sense sondeigs.
El teu propi informe
KPI, participants i resultats per l'API amb paginació per cursor: fes l'informe exactament com el vol la teva organització.
Sessions des del teu programari
Crea, obre i condueix sessions des del teu backend, des de les teves eines internes o des del teu agent: la mateixa API que fa servir aquesta aplicació web.
Pensat per a agents

El teu agent ja coneix Votinova

Un servidor MCP remot amb eines derivades del document OpenAPI, filtrades pels àmbits de la teva credencial. A més d'un llms.txt perquè qualsevol model trobi la documentació.

Configura el servidor MCP
{  "mcpServers": {    "votinova": {      "url": "https://mcp.votinova.com/mcp",      "headers": { "Authorization": "Bearer vz_live_…" }    }  }}

Últims canvis de l'API

Historial de canvis
  • ADDITIVE

    The plan codes gain STARTER, the tier between FREE and PRO introduced with the 2026-08 pricing. upgrade_to, on a 402 and on a question the caller's plan does not cover, can name it, and so can quota_tiers[].plan_code on GET /public/v1/limits. A client that switches over plan codes needs a branch for STARTER; the other codes keep their meaning and their order.

  • ADDITIVE

    An event stranded by an auto-disable is now dead-lettered, so it can be replayed once the endpoint is back. Recovering from a bad afternoon is supposed to be: the platform pauses the endpoint, you fix it, you re-enable it, you redeliver what never arrived. Redelivery only accepts a dead-lettered delivery, and the queue of an auto-disabled endpoint was being terminated as merely failed — so there was nothing to replay and nothing said so. The arithmetic hid it: a delivery gets 8 attempts and an endpoint is paused after 10 consecutive failures, so a single event in flight always dead-letters first. The counter is per endpoint, and one ordinary session emits three events. Deliveries for an endpoint its owner REMOVED are still terminated without a dead letter: nobody is coming back for those.

  • ADDITIVE

    Three corrections found by driving this API the way an integration does. A bad request body now answers the envelope this surface documents ({ error, code: INVALID_REQUEST_BODY, invalid_fields }) naming the PUBLISHED field: it used to fall through to a shape the API emits nowhere else, which named the internal property (TargetUrl for target_url) and carried no error member for a generated client to read. session.ended is delivered ONCE per close; closing a live session through this API delivered it twice, so anything that posts a summary or books a room did it twice, and the event now always names presentation_id whichever surface closed the session. And enabling an endpoint only revives one the platform paused after failures: it used to undo a DELETE too, so a connector's unsubscribe could be reversed by one call while the connector itself could no longer remove it. Enabling an endpoint that was removed now answers 400 WEBHOOK_NOT_AUTO_DISABLED; register it again instead.

Quota per pla

  • STARTER120 sol·licituds cada 60 s
  • PRO120 sol·licituds cada 60 s
  • TEAM600 sol·licituds cada 60 s
  • ENTERPRISE3.000 sol·licituds cada 60 s

La teva quota viatja a cada resposta (capçaleres X-RateLimit-*).