API和MCP

开始

在网页版 › 设置 › API 中创建密钥。密钥格式为 zk_ 后跟 32 个字符，仅显示一次。将其放入 Authorization 请求头中：

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

基础地址：https://zicelo.com.vtmx.ro/api/v1。所有响应均为 JSON，格式为 {"ok": true, ...} 或 {"ok": false, "error": {"cod", "mesaj"}}。数据使用 UTF-8 编码，时间为罗马尼亚时区。

限制

套餐	每日请求额度
免费	500
专业版	5.000
商务版	20.000
企业版	50.000

会议

GET/me

你的账户、套餐和本月使用情况。

GET/sedinte

会议列表，最新会议优先。参数：pagina，pe_pagina（最多 100 条），q（标题中包含），de_la，pana_la（格式 YYYY-MM-DD）。

GET/sedinte/{id}

完整会议内容：笔记（摘要、要点、决策、行动、问题）、对话分析、包含讲话者和时间戳的转录行、任务。

POST/sedinte

从你的系统中添加会议（例如电话转录）。你需提交 linii 或 text。若缺少 notite，Zicelo 会自动生成摘要。

{
  "titlu": "Popescu客户通话",
  "inceput": "2026-11-03 10:00:00",
  "limba": "ro",
  "participanti": ["ana@firma.ro"],
  "linii": [
    {"t0": 0, "t1": 6.5, "vorbitor": "Ana", "text": "您好，我打电话是关于报价的。"}
  ]
}

DELETE/sedinte/{id}

删除会议（包括转录及音频文件）。

任务

GET/sarcini

你的任务。筛选器：gata=0|1，sedinta=ID。

POST/sarcini

添加任务。

{ "text": "发送修订后的报价", "cine": "Mihai", "termen": "2026-11-07", "sedinta": 123 }

PATCH/sarcini/{id}

修改任务：gata，text，cine，termen。

{ "gata": true }

搜索

GET/cautare?q=reducere

在所有会议转录中搜索，返回匹配短语、会议及时间点（秒）。

Webhook

Zicelo每当会议笔记准备好时，会向你的地址发送POST JSON。你可以在应用中配置它（集成 › Webhook）或者通过API—对Zapier、Make或n8n非常有用。

GET/webhooks

你的 Webhook 列表。

POST/webhooks

订阅一个https地址。ce：应包含内容——rezumat，sarcini，transcript。

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

DELETE/webhooks/{id}

取消订阅。

发送的请求头：X-Zicelo-Event（sedinta.gata，sarcina，test），如果设置了secret，还会有X-Zicelo-Signature: sha256=<HMAC-SHA256 al corpului>。主体：

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

PHP 签名验证示例：

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

错误

HTTP	代码	含义
400	`json`, `text`, `url`	缺失或错误的数据
401	`cheie`	缺少、错误或已撤销密钥
403	`pachet`, `plafon`	功能不包含在套餐中，或已达到上限
404	`negasit`, `ruta`	不存在
429	`plafon`	超过每日请求额度
500 / 503	`server`, `baza`	服务器问题，请重试

MCP：你的会议内容在 Claude 和 ChatGPT 中

Zicelo 提供 MCP（模型上下文协议）服务器。你的 AI 助手可在会议中搜索，读取转录和笔记，查看任务并提出问题，均需你的同意。

在 Claude 中：设置 › 连接器 › 添加自定义连接器。在 ChatGPT 中：设置 › 连接器（开发者模式）› 创建。
服务器地址：https://zicelo.com.vtmx.ro/mcp
使用 Zicelo 账户登录并授权访问。你可随时在网页版撤销授权。

可用工具（只读）：cauta_sedinte，sedinta，transcriere，sarcini，intreaba（消耗一个AI信用），dictionar。

SCIM 2.0（企业版）

Okta、Microsoft Entra ID或Google Workspace可自动创建和禁用团队账户。管理员在应用中生成SCIM令牌（团队 › 安全）。地址：https://zicelo.com.vtmx.ro/scim/v2，认证为Bearer。资源：/Users（GET、POST、PUT、PATCH、DELETE，过滤userName eq），/ServiceProviderConfig，/ResourceTypes，/Schemas。禁用成员会将其移出团队并关闭其会话。

API，webhook 和 MCP

开始

限制

会议

任务

搜索

Webhook

错误

MCP：你的会议内容在 Claude 和 ChatGPT 中

SCIM 2.0（企业版）