API e MCP

Inizia

Crea una chiave nell’app web › Impostazioni › API. La chiave appare come zk_ seguita da 32 caratteri ed è visibile una sola volta. Inviarla nell’intestazione Authorization:

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

Indirizzo base: https://www.zicelo.com.vtmx.ro/api/v1. Tutte le risposte sono JSON, con {"ok": true, ...} o {"ok": false, "error": {"cod", "mesaj"}}. I dati sono in UTF-8, gli orari in ora della Romania.

Limiti

Pacchetto	Richieste al giorno
Gratis	500
Pro	5.000
Business	20.000
Enterprise	50.000

Riunioni

GET/me

Il tuo account, pacchetto e consumo del mese corrente.

GET/sedinte

Elenco delle riunioni, le più recenti prima. Parametri: pagina, pe_pagina (max 100), q (nel titolo), de_la, pana_la (YYYY-MM-DD).

GET/sedinte/{id}

Una riunione completa: appunti (sommario, punti, decisioni, azioni, domande), analisi della conversazione, linee della trascrizione con oratore e momento, compiti.

POST/sedinte

Aggiungi una riunione dal tuo sistema (es. trascrizione di una chiamata). Invia linii o text. Se mancano notite, Zicelo fa il sommario.

{
  "titlu": "Chiamata cliente Popescu",
  "inceput": "2026-11-03 10:00:00",
  "limba": "ro",
  "participanti": ["ana@firma.ro"],
  "linii": [
    {"t0": 0, "t1": 6.5, "vorbitor": "Ana", "text": "Buongiorno, sto chiamando per un’offerta."}
  ]
}*

DELETE/sedinte/{id}

Elimina la riunione (inclusa trascrizione e file audio).

Compiti

GET/sarcini

I tuoi compiti. Filtri: gata=0|1, sedinta=ID.

POST/sarcini

Aggiungi un compito.

{ "text": "Invia offerta revisionata", "cine": "Mihai", "termen": "2026-11-07", "sedinta": 123 }*

PATCH/sarcini/{id}

Modifica un compito: gata, text, cine, termen.

{ "gata": true }

Ricerca

GET/cautare?q=reducere

Cerca nelle trascrizioni di tutte le tue riunioni e restituisce la frase trovata, la riunione e il momento (in secondi).

Webhook

Zicelo invia un POST JSON al tuo indirizzo ogni volta che le note di una riunione sono pronte. Li configuri dall’app (Integrazioni › Webhook) o tramite API - utile per Zapier, Make o n8n.

GET/webhooks

I tuoi webhook.

POST/webhooks

Abilita un indirizzo https. ce: cosa deve contenere - rezumat, sarcini, transcript.

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

DELETE/webhooks/{id}

Disiscrivi.

Intestazioni inviate: X-Zicelo-Event (sedinta.gata, sarcina, test) e, se hai impostato un segreto, X-Zicelo-Signature: sha256=<HMAC-SHA256 al corpului>. Corpo:

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

Verifica della firma, in PHP:

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

Errori

HTTP	Codice	Cosa significa
400	`json`, `text`, `url`	Dati mancanti o errati
401	`cheie`	Chiave mancante, errata o revocata
403	`pachet`, `plafon`	Funzione non disponibile nel pacchetto o hai raggiunto il limite
404	`negasit`, `ruta`	Non esiste
429	`plafon`	Hai superato le richieste giornaliere
500 / 503	`server`, `baza`	Problema da parte nostra – riprova

MCP: le tue riunioni in Claude e ChatGPT

Zicelo ha un server MCP (Model Context Protocol). Il tuo assistente AI cerca nelle riunioni, legge trascrizioni e appunti, vede i compiti e fa domande, con il tuo consenso.

In Claude: Impostazioni › Connettori › Aggiungi connettore personalizzato. In ChatGPT: Impostazioni › Connettori (modalità sviluppatore) › Crea.
Indirizzo server: https://www.zicelo.com.vtmx.ro/mcp
Ti connetti con l’account Zicelo e approvi l’accesso. Puoi revocarlo in qualsiasi momento dall’app web.

Strumenti disponibili (sola lettura): cauta_sedinte, sedinta, transcriere, sarcini, intreaba (consuma un credito AI), dictionar.

SCIM 2.0 (Enterprise)

Okta, Microsoft Entra ID o Google Workspace possono creare e disattivare automaticamente gli account del team. L’admin genera il token SCIM nell’app (Team › Sicurezza). Indirizzo: https://www.zicelo.com.vtmx.ro/scim/v2, autenticazione Bearer. Risorse: /Users (GET, POST, PUT, PATCH, DELETE, filtro userName eq), /ServiceProviderConfig, /ResourceTypes, /Schemas. Disattivare una persona la rimuove dal team e chiude le sue sessioni.

API, webhook e MCP