API e MCP

Comece

Crie uma chave no app web › Configurações › API. A chave tem formato zk_ seguido de 32 caracteres e é exibida só uma vez. Envie ela no cabeçalho Authorization:

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

Endereço base: https://www.zicelo.com.vtmx.ro/api/v1. Todas as respostas são JSON, com {"ok": true, ...} ou {"ok": false, "error": {"cod", "mesaj"}}. Dados em UTF-8, horários no fuso horário da Romênia.

Limites

Plano	Requisições por dia
Grátis	500
Pro	5.000
Business	20.000
Enterprise	50.000

Reuniões

GET/me

Conta, plano e uso do mês atual.

GET/sedinte

Lista de reuniões, mais recentes primeiro. Parâmetros: pagina, pe_pagina (máx 100), q (no título), de_la, pana_la (AAAA-MM-DD).

GET/sedinte/{id}

Uma reunião completa: notas (resumo, pontos, decisões, ações, perguntas), análise da conversa, linhas da transcrição com quem falou e tempo, tarefas.

POST/sedinte

Adicione uma reunião do seu sistema (exemplo: transcrição de uma chamada). Envie linii ou text. Se faltar notite, Zicelo faz o resumo.

{
  "titlu": "Chamada com cliente Popescu",
  "inceput": "2026-11-03 10:00:00",
  "limba": "ro",
  "participanti": ["ana@firma.ro"],
  "linii": [
    {"t0": 0, "t1": 6.5, "vorbitor": "Ana", "text": "Olá, estou ligando para uma proposta."}
  ]
}

DELETE/sedinte/{id}

Apague a reunião (incluindo transcrição e arquivo de áudio).

Tarefas

GET/sarcini

Suas tarefas. Filtros: gata=0|1, sedinta=ID.

POST/sarcini

Adicione uma tarefa.

{ "text": "Enviar proposta revisada", "cine": "Mihai", "termen": "2026-11-07", "sedinta": 123 }

PATCH/sarcini/{id}

Modifique uma tarefa: gata, text, cine, termen.

{ "gata": true }

Busca

GET/cautare?q=reducere

Busque nas transcrições de todas suas reuniões e retorne a frase encontrada, a reunião e o momento (em segundos).

Webhooks

Zicelo envia um JSON POST para seu endereço sempre que as notas de uma reunião ficam prontas. Você configura isso pelo app (Integrações › Webhook) ou via API – útil para Zapier, Make ou n8n.

GET/webhooks

Seus webhooks.

POST/webhooks

Assine um endereço https. ce: o que deve conter - rezumat, sarcini, transcript.

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

DELETE/webhooks/{id}

Cancele a assinatura.

Cabeçalhos enviados: X-Zicelo-Event (sedinta.gata, sarcina, test) e, se você definir um segredo, X-Zicelo-Signature: sha256=<HMAC-SHA256 al corpului>. O 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ção da assinatura, em PHP:

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

Erros

HTTP	Código	O que significa
400	`json`, `text`, `url`	Dados faltando ou incorretos
401	`cheie`	Chave faltando, incorreta ou revogada
403	`pachet`, `plafon`	Função não disponível no plano ou limite atingido
404	`negasit`, `ruta`	Não existe
429	`plafon`	Você ultrapassou o número de requisições por dia
500 / 503	`server`, `baza`	Problema do nosso lado - tente novamente

MCP: suas reuniões no Claude e ChatGPT

Zicelo tem um servidor MCP (Model Context Protocol). Seu assistente de IA busca nas reuniões, lê transcrições e notas, vê as tarefas e faz perguntas, com seu consentimento.

No Claude: Configurações › Conectores › Adicionar conector personalizado. No ChatGPT: Configurações › Conectores (modo desenvolvedor) › Criar.
Endereço do servidor: https://www.zicelo.com.vtmx.ro/mcp
Você conecta com sua conta Zicelo e aprova o acesso. Pode revogar a qualquer momento pelo app web.

Ferramentas disponíveis (somente leitura): cauta_sedinte, sedinta, transcriere, sarcini, intreaba (consome um crédito AI), dictionar.

SCIM 2.0 (Enterprise)

Okta, Microsoft Entra ID ou Google Workspace podem criar e desativar automaticamente contas da equipe. O admin gera o token SCIM no app (Equipe › Segurança). Endereço: https://www.zicelo.com.vtmx.ro/scim/v2, autenticação Bearer. Recursos: /Users (GET, POST, PUT, PATCH, DELETE, filtro userName eq), /ServiceProviderConfig, /ResourceTypes, /Schemas. Desativar um usuário o remove da equipe e encerra suas sessões.

API, webhooks e MCP