API और MCP

शुरू करें

वेब ऐप में एक कुंजी बनाएं › सेटिंग्स › API. कुंजी कुछ ऐसी दिखती है zk_ जिसके बाद 32 कैरेक्टर्स होते हैं और इसे केवल एक बार देखा जा सकता है। इसे Authorization हेडर में भेजें:

curl https://www.zicelo.com.vtmx.ro/api/v1/me \
  -H "Authorization: Bearer zk_..."

बेस एड्रेस: https://www.zicelo.com.vtmx.ro/api/v1. सभी रिस्पांस JSON होते हैं, {"ok": true, ...} या {"ok": false, "error": {"cod", "mesaj"}} के साथ। डेटा UTF-8 में है, समय Rumänien के टाइमज़ोन में है।

सीमाएँ

प्लान	दैनिक रिक्वेस्ट
मुफ्त	500
Pro	5.000
Business	20.000
Enterprise	50.000

बैठकें

GET/me

एकाउंट, प्लान और वर्तमान महीने की खपत।

GET/sedinte

मीटिंग्स की लिस्ट, सबसे नई पहले। पैरामीटर्स: pagina, pe_pagina (मैक्स 100), q (टाइटल में), de_la, pana_la (YYYY-MM-DD)।

GET/sedinte/{id}

एक पूरी मीटिंग: नोट्स (सारांश, पॉइंट्स, निर्णय, क्रियाएँ, सवाल), बातचीत का विश्लेषण, ट्रांसक्रिप्शन की लाइनें वक्ता और समय के साथ, टास्क।

POST/sedinte

अपने सिस्टम से एक मीटिंग जोड़ो (जैसे कॉल ट्रांसक्रिप्शन)। तुम linii या text भेजते हो। अगर notite गायब है, तो Zicelo सारांश बनाता है।

{
  "titlu": "क्लाइंट कॉल Popescu",
  "inceput": "2026-11-03 10:00:00",
  "limba": "ro",
  "participanti": ["ana@firma.ro"],
  "linii": [
    {"t0": 0, "t1": 6.5, "vorbitor": "Ana", "text": "नमस्ते, मैं ऑफ़र के लिए कॉल कर रही हूँ।"}
  ]
}

DELETE/sedinte/{id}

मीटिंग डिलीट करो (ट्रांसक्रिप्शन और ऑडियो फाइल समेत)।

टास्क्स

GET/sarcini

तुम्हारे कार्य। फ़िल्टर: gata=0|1, sedinta=ID.

POST/sarcini

एक टास्क जोड़ो।

{ "text": "संशोधित ऑफ़र भेजें", "cine": "Mihai", "termen": "2026-11-07", "sedinta": 123 }

PATCH/sarcini/{id}

एक कार्य बदलो: gata, text, cine, termen.

{ "gata": true }

सर्च

GET/cautare?q=reducere

सभी मीटिंग्स के ट्रांसक्रिप्शन में खोजो और मिली हुई वाक्यांश, मीटिंग, और वक्त (सेकंड में) दिखाओ।

वेबहुक्स

Zicelo हर बार जब किसी मीटिंग के नोट तैयार हो जाते हैं तो आपकी ओर एक POST JSON भेजता है। आप इन्हें ऐप (इंटीग्रेशन › वेबहुक) या API के ज़रिए सेट कर सकते हो - Zapier, Make या n8n के लिए उपयोगी।

GET/webhooks

तुम्हारे वेबहुक्स।

POST/webhooks

एक https पता सब्सक्राइब करें। ce: क्या होना चाहिए - rezumat, sarcini, transcript।

{ "url": "https://hooks.zapier.com/...", "secret": "un-secret", "ce": ["rezumat", "sarcini"] }

DELETE/webhooks/{id}

अनसब्स्क्राइब।

भेजे गए हेडर: X-Zicelo-Event (sedinta.gata, sarcina, test) और अगर आपने कोई सीक्रेट सेट किया है तो X-Zicelo-Signature: sha256=<HMAC-SHA256 al corpului>। बॉडी:

{
  "eveniment": "sedinta.gata",
  "trimis": "2026-11-03T10:42:00+02:00",
  "sedinta": {
    "id": 123, "titlu": "...", "inceput": "...", "durata": 1840,
    "participanti": ["..."],
    "notite": { "rezumat": "...", "puncte": [...], "decizii": [...], "actiuni": [...], "intrebari": [...] },
    "sarcini": [{ "id": 1, "text": "...", "cine": "...", "termen": "..." }],
    "url": "https://zicelo.ro/app/#/sedinta/123"
  }
}

PHP में सिग्नेचर वेरिफिकेशन:

$ok = hash_equals('sha256=' . hash_hmac('sha256', file_get_contents('php://input'), $secret),
                  $_SERVER['HTTP_X_ZICELO_SIGNATURE'] ?? '');

एरर

HTTP	कोड	इसका मतलब
400	`json`, `text`, `url`	डेटा ग़ायब या गलत
401	`cheie`	कुंजी ग़ायब, गलत या रद्द हो चुकी है
403	`pachet`, `plafon`	यह फीचर इस प्लान में नहीं है या आप लिमिट पार कर चुके हो
404	`negasit`, `ruta`	मौजूद नहीं है
429	`plafon`	आपने दैनिक रिक्वेस्ट की सीमा पार कर ली है
500 / 503	`server`, `baza`	हमारी तरफ समस्या - कृपया पुनः प्रयास करें

MCP: तुम्हारी मीटिंग्स Claude और ChatGPT में

Zicelo के पास MCP (Model Context Protocol) सर्वर है। तुम्हारा AI सहायक मीटिंग्स खोजता है, ट्रांसक्रिप्शन और नोट्स पढ़ता है, टास्क देखता है और तुम्हारी अनुमति से सवाल करता है।

Claude में: सेटिंग्स › कनेक्टर्स › कस्टम कनेक्टर जोड़ें। ChatGPT में: सेटिंग्स › कनेक्टर्स (डेवलपर मोड) › बनाएं।
सर्वर का पता: https://www.zicelo.com.vtmx.ro/mcp
Zicelo अकाउंट से लॉगिन करो और एक्सेस अप्रूव करो। इसे वेब ऐप से कभी भी रिवोक कर सकते हो।

उपलब्ध टूल्स (केवल पढ़ें): cauta_sedinte, sedinta, transcriere, sarcini, intreaba (AI क्रेडिट का उपयोग होता है), dictionar।

SCIM 2.0 (Enterprise)

Okta, Microsoft Entra ID या Google Workspace टीम के अकाउंट्स को ऑटोमैटिक बना और डिसेबल कर सकते हैं। एडमिन ऐप (टीम › सुरक्षा) में SCIM टोकन जनरेट करता है। पता: https://www.zicelo.com.vtmx.ro/scim/v2, ऑटेंटिकेशन Bearer। रिसोर्सेज़: /Users (GET, POST, PUT, PATCH, DELETE, फ़िल्टर userName eq), /ServiceProviderConfig, /ResourceTypes, /Schemas। किसी यूज़र को डिसेबल करने पर वह टीम से हट जाता है और उसकी सेशंस बंद हो जाती हैं।

API, वेबहुक्स और MCP