API y MCP

Comienza

Crea una clave en la aplicación web › Ajustes › API. La clave tiene el formato zk_ seguido de 32 caracteres y se muestra solo una vez. Envíala en el encabezado Authorization:

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

Dirección base: https://zicelo.com.vtmx.ro/api/v1. Todas las respuestas están en JSON, con {"ok": true, ...} o {"ok": false, "error": {"cod", "mesaj"}}. Los datos están en UTF-8, las horas en hora de Rumanía.

Límites

Paquete	Solicitudes por día
Gratis	500
Pro	5.000
Business	20.000
Enterprise	50.000

Reuniones

GET/me

Tu cuenta, paquete y consumo del mes actual.

GET/sedinte

Lista de reuniones, las más recientes primero. Parámetros: pagina, pe_pagina (máx 100), q (en el título), de_la, pana_la (AAAA-MM-DD).

GET/sedinte/{id}

Una reunión completa: notas (resumen, puntos, decisiones, acciones, preguntas), análisis de la conversación, líneas de transcripción con orador y momento, tareas.

POST/sedinte

Añade una reunión desde tu propio sistema (por ejemplo, la transcripción de una llamada). Envías bien linii o text. Si falta notite, Zicelo crea el resumen.

{
  "titlu": "Llamada con cliente Popescu",
  "inceput": "2026-11-03 10:00:00",
  "limba": "ro",
  "participanti": ["ana@firma.ro"],
  "linii": [
    {"t0": 0, "t1": 6.5, "vorbitor": "Ana", "text": "Hola, te llamo por una oferta."}
  ]
}

DELETE/sedinte/{id}

Elimina la reunión (incluida la transcripción y el archivo de audio).

Tareas

GET/sarcini

Tus tareas. Filtros: gata=0|1, sedinta=ID.

POST/sarcini

Añade una tarea.

{ "text": "Envía la oferta revisada", "cine": "Mihai", "termen": "2026-11-07", "sedinta": 123 }

PATCH/sarcini/{id}

Modifica una tarea: gata, text, cine, termen.

{ "gata": true }

Buscar

GET/cautare?q=reducere

Busca en las transcripciones de todas tus reuniones y devuelve la frase encontrada, la reunión y el momento (en segundos).

Webhooks

Zicelo envía un JSON POST a tu dirección cada vez que las notas de una reunión están listas. Los configuras desde la app (Integraciones › Webhook) o vía API — útil para Zapier, Make o n8n.

GET/webhooks

Tus webhooks.

POST/webhooks

Suscribe una dirección https. ce: qué debe contener — rezumat, sarcini, transcript.

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

DELETE/webhooks/{id}

Darse de baja.

Headers enviados: X-Zicelo-Event (sedinta.gata, sarcina, test) y, si has configurado un secreto, X-Zicelo-Signature: sha256=<HMAC-SHA256 al corpului>. Cuerpo:

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

Verificación de firma, en PHP:

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

Errores

HTTP	Código	Qué significa
400	`json`, `text`, `url`	Datos ausentes o erróneos
401	`cheie`	Clave faltante, errónea o revocada
403	`pachet`, `plafon`	Función no incluida en el paquete o has alcanzado el límite
404	`negasit`, `ruta`	No existe
429	`plafon`	Has excedido las solicitudes diarias
500 / 503	`server`, `baza`	Problema nuestro – intenta de nuevo

MCP: tus reuniones en Claude y ChatGPT

Zicelo tiene un servidor MCP (Model Context Protocol). Tu asistente AI busca en reuniones, lee transcripciones y notas, ve las tareas y hace preguntas, con tu permiso.

En Claude: Ajustes › Conectores › Añadir conector personalizado. En ChatGPT: Ajustes › Conectores (modo desarrollador) › Crear.
Dirección del servidor: https://zicelo.com.vtmx.ro/mcp
Te conectas con la cuenta de Zicelo y apruebas el acceso. Puedes revocarlo en cualquier momento desde la app web.

Herramientas disponibles (solo lectura): cauta_sedinte, sedinta, transcriere, sarcini, intreaba (consume un crédito AI), dictionar.

SCIM 2.0 (Enterprise)

Okta, Microsoft Entra ID o Google Workspace pueden crear y desactivar automáticamente las cuentas del equipo. El admin genera el token SCIM en la app (Equipo › Seguridad). Dirección: https://zicelo.com.vtmx.ro/scim/v2, autenticación Bearer. Recursos: /Users (GET, POST, PUT, PATCH, DELETE, filtro userName eq), /ServiceProviderConfig, /ResourceTypes, /Schemas. Desactivar a una persona la saca del equipo y cierra sus sesiones.

API, webhooks y MCP