API et MCP

Commencer

Crée une clé dans l’application web › Paramètres › API. La clé ressemble à zk_ suivi de 32 caractères et est visible une seule fois. Envoie-la dans l’en-tête Authorization :

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

URL de base : https://zicelo.com.vtmx.ro/api/v1. Toutes les réponses sont en JSON, avec {"ok": true, ...} ou {"ok": false, "error": {"cod", "mesaj"}}. Les données sont en UTF-8, heures en heure de Roumanie.

Limites

Forfait	Requêtes par jour
Gratuit	500
Pro	5.000
Business	20.000
Enterprise	50.000

Réunions

GET/me

Ton compte, ton forfait et ta consommation du mois en cours.

GET/sedinte

Liste des réunions, les plus récentes en premier. Paramètres : pagina, pe_pagina (max 100), q (dans le titre), de_la, pana_la (AAAA-MM-JJ).

GET/sedinte/{id}

Une réunion complète : notes (résumé, points, décisions, actions, questions), analyse de la conversation, lignes de transcription avec intervenant et timestamp, tâches.

POST/sedinte

Ajoute une réunion depuis ton propre système (par exemple la transcription d’un appel). Envoie soit linii, soit text. S’il manque notite, Zicelo fait le résumé.

{
  "titre": "Appel client Popescu",
  "début": "2026-11-03 10:00:00",
  "langue": "ro",
  "participants": ["ana@firma.ro"],
  "lignes": [
    {"t0": 0, "t1": 6.5, "intervenant": "Ana", "texte": "Bonjour, je vous appelle pour une offre."}
  ]
}

DELETE/sedinte/{id}

Supprimer la réunion (y compris transcription et fichier audio).

Tâches

GET/sarcini

Tes tâches. Filtres : gata=0|1, sedinta=ID.

POST/sarcini

Ajouter une tâche.

{ "texte": "Envoie l'offre révisée", "qui": "Mihai", "date limite": "2026-11-07", "réunion": 123 }

PATCH/sarcini/{id}

Modifier une tâche : gata, text, cine, termen.

{ "gata": true }

Recherche

GET/cautare?q=reducere

Cherche dans toutes les transcriptions de tes réunions et retourne la phrase trouvée, la réunion et l’instant (en secondes).

Webhooks

Zicelo envoie un JSON POST à ton adresse à chaque fois que les notes d’une réunion sont prêtes. Tu les configures depuis l’app (Intégrations › Webhook) ou via API – pratique pour Zapier, Make ou n8n.

GET/webhooks

Tes webhooks.

POST/webhooks

Abonne une adresse https. ce : ce qu’elle doit contenir – rezumat, sarcini, transcript.

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

DELETE/webhooks/{id}

Désabonner.

En-têtes envoyés : X-Zicelo-Event (sedinta.gata, sarcina, test) et si tu as défini un secret, X-Zicelo-Signature: sha256=<HMAC-SHA256 al corpului>. Corps :

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

Vérification de la signature, en PHP :

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

Erreurs

HTTP	Code	Que signifie
400	`json`, `text`, `url`	Données manquantes ou incorrectes
401	`cheie`	Clé manquante, incorrecte ou révoquée
403	`pachet`, `plafon`	Fonction non incluse dans le forfait ou plafond atteint
404	`negasit`, `ruta`	N’existe pas
429	`plafon`	Tu as dépassé les requêtes par jour
500 / 503	`server`, `baza`	Problème de notre côté - réessaie

MCP : tes réunions dans Claude et ChatGPT

Zicelo dispose d’un serveur MCP (Model Context Protocol). Ton assistant IA cherche dans tes réunions, lit transcriptions et notes, voit les tâches et pose des questions, avec ton accord.

Dans Claude : Paramètres › Connecteurs › Ajouter un connecteur personnalisé. Dans ChatGPT : Paramètres › Connecteurs (mode développeur) › Créer.
Adresse du serveur : https://zicelo.com.vtmx.ro/mcp
Tu te connectes avec ton compte Zicelo et approuves l’accès. Tu peux le retirer à tout moment dans l’application web.

Outils disponibles (lecture seule) : cauta_sedinte, sedinta, transcriere, sarcini, intreaba (consomme un crédit IA), dictionar.

SCIM 2.0 (Enterprise)

Okta, Microsoft Entra ID ou Google Workspace peuvent créer et désactiver automatiquement les comptes de l’équipe. L’admin génère le token SCIM dans l’app (Équipe › Sécurité). Adresse : https://zicelo.com.vtmx.ro/scim/v2, authentification Bearer. Ressources : /Users (GET, POST, PUT, PATCH, DELETE, filtre userName eq), /ServiceProviderConfig, /ResourceTypes, /Schemas. Désactiver une personne la retire de l’équipe et ferme ses sessions.

API, webhooks et MCP