Építsen a Votinova platformra
REST API, webhookok, összekötők és MCP-kiszolgáló. Amit a webalkalmazás tud, azt az API is tudja: hozzon létre munkamenetet, nyissa meg, és öt percen belül a saját rendszerében lesznek az eredmények.
- Hozzon létre egy hitelesítő adatot a munkaterületén – két jogosultság, a teljes szervezetre.
- Indítsa el az első hívását: hozzon létre és nyisson meg egy munkamenetet curl-lel.
- Iratkozzon fel egy webhookra, és minden kérdés lezárásakor megkapja az eredményeket.
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"}Minden felület, egyetlen szerződés
Minden integráció ugyanabból az OpenAPI-leírásból származik. Egy új végpont egyszerre jelenik meg mindenhol.
REST API
Nyilvános végpontok jogosultságokkal, csomagonkénti kvótával és kurzoros lapozással.
API-referenciaWebhookok
HMAC-kel aláírt események, egyre ritkuló újrapróbálkozással és kézi újraküldéssel.
Webhookok útmutatójaMCP-kiszolgáló
Az OpenAPI-leírásból származó eszközök az ügynökeinek. Távoli, nincs mit telepíteni.
MCP beállításaMit építenek ezzel mások
- Eredmények a CRM-ben
- Szinkronizálja a válaszokat és a jelenlétet a CRM-jébe vagy az adattárházába abban a pillanatban, amikor egy kérdés lezárul – szól érte a webhook, nem kell lekérdezgetni.
- Saját riportálás
- Mutatók, résztvevők és eredmények API-ból, kurzoros lapozással: pontosan úgy építse fel a jelentést, ahogy a szervezete szeretné.
- Munkamenetek a saját szoftveréből
- Hozzon létre, nyisson meg és vezéreljen munkameneteket a háttérrendszeréből, a belső eszközeiből vagy az ügynökéből – ugyanazzal az API-val, amelyet ez a webalkalmazás is használ.
Az első hívása, az Ön nyelvén
Teljes gyorsindításAz ügynöke már ismeri a Votinova platformot
Távoli MCP-kiszolgáló, amelynek eszközei az OpenAPI-leírásból származnak, és a hitelesítő adata jogosultságai szerint szűrődnek. Mellette llms.txt, hogy bármelyik modell megtalálja a dokumentációt.
MCP-kiszolgáló beállítása{ "mcpServers": { "votinova": { "url": "https://mcp.votinova.com/mcp", "headers": { "Authorization": "Bearer vz_live_…" } } }}Az API legutóbbi változásai
Változásnapló- 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.
Kvóta csomagonként
- STARTER120 kérés 60 másodpercenként
- PRO120 kérés 60 másodpercenként
- TEAM600 kérés 60 másodpercenként
- ENTERPRISE3000 kérés 60 másodpercenként
A kvótája minden válaszban utazik (X-RateLimit-* fejlécek).