API și MCP

Începe

Creează o cheie în aplicația web › Setări › API. Cheia arată ca zk_ urmat de 32 de caractere și se vede o singură dată. Trimite-o în antetul Authorization:

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

Adresa de bază: https://zicelo.com.vtmx.ro/api/v1. Toate răspunsurile sunt JSON, cu {"ok": true, ...} sau {"ok": false, "error": {"cod", "mesaj"}}. Datele sunt în UTF-8, orele în ora României.

Limite

Pachet	Cereri pe zi
Gratuit	500
Pro	5.000
Business	20.000
Enterprise	50.000

Ședințe

GET/me

Contul, pachetul și consumul lunii curente.

GET/sedinte

Lista ședințelor, cele mai noi primele. Parametri: pagina, pe_pagina (max 100), q (în titlu), de_la, pana_la (YYYY-MM-DD).

GET/sedinte/{id}

O ședință completă: notițele (rezumat, puncte, decizii, acțiuni, întrebări), analiza conversației, liniile transcrierii cu vorbitorul și momentul, sarcinile.

POST/sedinte

Adaugă o ședință din propriul sistem (de exemplu transcrierea unui apel). Trimiți fie linii, fie text. Dacă lipsesc notite, Zicelo face rezumatul.

{
  "titlu": "Apel client Popescu",
  "inceput": "2026-11-03 10:00:00",
  "limba": "ro",
  "participanti": ["ana@firma.ro"],
  "linii": [
    {"t0": 0, "t1": 6.5, "vorbitor": "Ana", "text": "Bună ziua, vă sun pentru ofertă."}
  ]
}

DELETE/sedinte/{id}

Șterge ședința (inclusiv transcrierea și fișierul audio).

Sarcini

GET/sarcini

Sarcinile tale. Filtre: gata=0|1, sedinta=ID.

POST/sarcini

Adaugă o sarcină.

{ "text": "Trimite oferta revizuită", "cine": "Mihai", "termen": "2026-11-07", "sedinta": 123 }

PATCH/sarcini/{id}

Modifică o sarcină: gata, text, cine, termen.

{ "gata": true }

Căutare

GET/cautare?q=reducere

Caută în transcrierile tuturor ședințelor tale și întoarce fraza găsită, ședința și momentul (în secunde).

Webhook-uri

Zicelo trimite un POST JSON la adresa ta de fiecare dată când notițele unei ședințe sunt gata. Le configurezi din aplicație (Integrări › Webhook) sau prin API - util pentru Zapier, Make sau n8n.

GET/webhooks

Webhook-urile tale.

POST/webhooks

Abonează o adresă https. ce: ce să conțină - rezumat, sarcini, transcript.

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

DELETE/webhooks/{id}

Dezabonează.

Antete trimise: X-Zicelo-Event (sedinta.gata, sarcina, test) și, dacă ai setat un secret, X-Zicelo-Signature: sha256=<HMAC-SHA256 al corpului>. Corpul:

{
  "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"
  }
}

Verificarea semnăturii, în PHP:

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

Erori

HTTP	Cod	Ce înseamnă
400	`json`, `text`, `url`	Date lipsă sau greșite
401	`cheie`	Cheie lipsă, greșită sau revocată
403	`pachet`, `plafon`	Funcția nu e în pachet sau ai atins plafonul
404	`negasit`, `ruta`	Nu există
429	`plafon`	Ai depășit cererile pe zi
500 / 503	`server`, `baza`	Problemă la noi - reîncearcă

MCP: ședințele tale în Claude și ChatGPT

Zicelo are un server MCP (Model Context Protocol). Asistentul tău AI caută în ședințe, citește transcrieri și notițe, vede sarcinile și pune întrebări, cu acordul tău.

În Claude: Setări › Conectori › Adaugă conector personalizat. În ChatGPT: Setări › Conectori (mod dezvoltator) › Creează.
Adresa serverului: https://zicelo.com.vtmx.ro/mcp
Te conectezi cu contul Zicelo și aprobi accesul. Îl poți retrage oricând din aplicația web.

Instrumente disponibile (doar citire): cauta_sedinte, sedinta, transcriere, sarcini, intreaba (consumă un credit AI), dictionar.

SCIM 2.0 (Enterprise)

Okta, Microsoft Entra ID sau Google Workspace pot crea și dezactiva automat conturile echipei. Adminul generează tokenul SCIM în aplicație (Echipă › Securitate). Adresa: https://zicelo.com.vtmx.ro/scim/v2, autentificare Bearer. Resurse: /Users (GET, POST, PUT, PATCH, DELETE, filtru userName eq), /ServiceProviderConfig, /ResourceTypes, /Schemas. Dezactivarea unui om îl scoate din echipă și îi închide sesiunile.

API, webhook-uri și MCP