API und MCP

Loslegen

Lege einen Schlüssel in der Web-App an › Einstellungen › API. Der Schlüssel sieht aus wie zk_ gefolgt von 32 Zeichen und wird nur einmal angezeigt. Sende ihn im Header Authorization:

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

Basis-Adresse: https://www.zicelo.com.vtmx.ro/api/v1. Alle Antworten sind JSON mit {"ok": true, ...} oder {"ok": false, "error": {"cod", "mesaj"}}. Die Daten sind in UTF-8, Zeiten in rumänischer Zeitzone.

Limits

Paket	Anfragen pro Tag
Kostenlos	500
Pro	5.000
Business	20.000
Enterprise	50.000

Meetings

GET/me

Dein Konto, Paket und Verbrauch im aktuellen Monat.

GET/sedinte

Liste der Meetings, die neuesten zuerst. Parameter: pagina, pe_pagina (max. 100), q (im Titel), de_la, pana_la (JJJJ-MM-TT).

GET/sedinte/{id}

Ein komplettes Meeting: Notizen (Zusammenfassung, Punkte, Entscheidungen, Aktionen, Fragen), Gesprächsanalyse, Transkriptzeilen mit Sprecher und Zeitpunkt, Aufgaben.

POST/sedinte

Füge ein Meeting aus deinem System hinzu (z. B. Transkript eines Anrufs). Du sendest entweder linii oder text. Fehlt notite, erstellt Zicelo die Zusammenfassung.

{
  "titlu": "Kundenanruf Popescu",
  "inceput": "2026-11-03 10:00:00",
  "limba": "ro",
  "participanti": ["ana@firma.ro"],
  "linii": [
    {"t0": 0, "t1": 6.5, "vorbitor": "Ana", "text": "Guten Tag, ich rufe wegen eines Angebots an."}
  ]
}

DELETE/sedinte/{id}

Lösche ein Meeting (inklusive Transkript und Audiodatei).

Aufgaben

GET/sarcini

Deine Aufgaben. Filter: gata=0|1, sedinta=ID.

POST/sarcini

Füge eine Aufgabe hinzu.

{ "text": "Sende das überarbeitete Angebot", "cine": "Mihai", "termen": "2026-11-07", "sedinta": 123 }

PATCH/sarcini/{id}

Aufgabe bearbeiten: gata, text, cine, termen.

{ "gata": true }

Suche

GET/cautare?q=reducere

Suche in den Transkripten all deiner Meetings und gib den gefundenen Satz, das Meeting und den Zeitpunkt (in Sekunden) zurück.

Webhooks

Zicelo sendet jedes Mal ein POST JSON an deine Adresse, sobald die Meetingnotizen fertig sind. Du richtest das in der App ein (Integrationen › Webhook) oder per API – praktisch für Zapier, Make oder n8n.

GET/webhooks

Deine Webhooks.

POST/webhooks

Abonniere eine https-Adresse. ce: was sie enthalten soll - rezumat, sarcini, transcript.

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

DELETE/webhooks/{id}

Deabonniere.

Gesendete Header: X-Zicelo-Event (sedinta.gata, sarcina, test) und, falls du ein Secret gesetzt hast, X-Zicelo-Signature: sha256=<HMAC-SHA256 al corpului>. Body:

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

Signaturprüfung in PHP:

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

Fehler

HTTP	Code	Bedeutung
400	`json`, `text`, `url`	Fehlende oder falsche Daten
401	`cheie`	Fehlender, falscher oder widerrufener Schlüssel
403	`pachet`, `plafon`	Funktion ist nicht im Paket oder Tageslimit erreicht
404	`negasit`, `ruta`	Nicht vorhanden
429	`plafon`	Du hast dein Tageslimit überschritten
500 / 503	`server`, `baza`	Problem bei uns – bitte versuche es erneut

MCP: Deine Meetings in Claude und ChatGPT

Zicelo hat einen MCP-Server (Model Context Protocol). Dein AI-Assistent durchsucht Meetings, liest Transkripte und Notizen, sieht Aufgaben und stellt Fragen – mit deiner Zustimmung.

In Claude: Einstellungen › Connectoren › Benutzerdefinierten Connector hinzufügen. In ChatGPT: Einstellungen › Connectoren (Entwicklermodus) › Erstellen.
Serveradresse: https://www.zicelo.com.vtmx.ro/mcp
Du verbindest dich mit deinem Zicelo-Konto und erlaubst den Zugriff. Du kannst ihn jederzeit in der Web-App widerrufen.

Verfügbare Tools (nur Leserechte): cauta_sedinte, sedinta, transcriere, sarcini, intreaba (verbraucht ein AI-Credit), dictionar.

SCIM 2.0 (Enterprise)

Okta, Microsoft Entra ID oder Google Workspace können Teamkonten automatisch erstellen und deaktivieren. Der Admin erstellt den SCIM Token in der App (Team › Sicherheit). Adresse: https://www.zicelo.com.vtmx.ro/scim/v2, Authentifizierung Bearer. Ressourcen: /Users (GET, POST, PUT, PATCH, DELETE, Filter userName eq), /ServiceProviderConfig, /ResourceTypes, /Schemas. Das Deaktivieren einer Person entfernt sie aus dem Team und schließt ihre Sessions.

API, Webhooks und MCP