Para desenvolvedores

A Cyzyra dentro dos seus sistemas. E os seus sistemas dentro da Cyzyra.

API REST, webhooks assinados e conexão com assistentes de IA. Para levar os dados da empresa para o ERP, o BI ou o seu próprio aplicativo.

Ler a documentação Abrir a plataforma de API

curl https://SEU-PAINEL/api/v1/leads?limit=20 \
  -H "Authorization: Bearer cy_live_..."

{
  "data": [{ "id": "…", "name": "…", "status": "new" }],
  "next_cursor": null
}

Exemplo ilustrativo de chamada e resposta.

01 / Três formas de integrar

Leia, receba e pergunte.

Use uma, duas ou as três. Todas respeitam as permissões da chave e os dados da empresa dona dela.

API REST
Leads, negociações, pagamentos, objetos e métricas em JSON, com documentação OpenAPI.
Webhooks
18 eventos da empresa enviados para o seu sistema na hora, com assinatura.
Assistentes de IA (MCP)
Conecte a Cyzyra a assistentes de IA compatíveis com MCP e pergunte sobre vendas, anúncios e lucro.

02 / API REST

Endpoints

Autenticação por Authorization: Bearer, respostas em JSON e paginação por cursor.

120 requisições por minuto por chave
Chave guardada só como hash

GET/api/v1/leadsLista e busca leads
POST/api/v1/leadsCria um lead (com checagem de duplicados)
GET/api/v1/leads/{id}Um lead com os detalhes
PATCH/api/v1/leads/{id}Atualiza um lead
GET/api/v1/dealsNegociações e etapas do funil
POST/api/v1/dealsCria uma negociação
GET/api/v1/paymentsCobranças e pagamentos
GET/api/v1/objectsSeus tipos de objeto
GET/api/v1/objects/{type}/recordsRegistros de um tipo de objeto
POST/api/v1/objects/{type}/recordsCria um registro
POST/api/v1/queryMétricas com filtros e períodos
POST/api/v1/askPergunta em português sobre os dados

03 / Webhooks

Aconteceu na empresa, chegou no seu sistema.

Escolha os eventos e o endereço. Cada envio vai assinado, e o que falhar é reenviado até 5 vezes.

Assinatura HMAC com horário, contra reenvio
Histórico de cada tentativa no painel

// Cabeçalho: X-Cyzyra-Signature: t=1731000000,v1=<hmac>
const [t, v1] = header.split(",").map((p) => p.split("=")[1]);
const esperado = hmacSha256(segredo, `${t}.${corpoBruto}`);
if (esperado !== v1) throw new Error("assinatura inválida");

18 eventos disponíveis

Lead criadolead.created
Status do lead mudoulead.status_changed
Cadastros unificadoslead.merged
Negociação criadadeal.created
Negociação mudou de etapadeal.stage_changed
Venda ganhadeal.won
Venda perdidadeal.lost
Proposta enviadaproposal.sent
Proposta aceitaproposal.accepted
Proposta recusadaproposal.rejected
Contrato enviadocontract.sent
Contrato assinadocontract.signed
Cobrança criadapayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received

04 / Assistentes de IA

Pergunte à Cyzyra de dentro do seu assistente.

Adicione o endereço MCP da Cyzyra como conector personalizado num assistente de IA compatível, com a sua chave de API. Ele passa a consultar lucro, campanhas e vendas, e responde perguntas em português sobre os seus dados.

URL:        https://SEU-PAINEL/api/mcp
Cabeçalho:  Authorization: Bearer cy_live_...

Ferramentas: resumo_lucro · campanhas · vendas
             perguntar · gerenciar_campanhas (escrita)

05 / Dúvidas

Perguntas técnicas

Ver as integrações prontas

Onde crio a chave de API?+

Na Plataforma de API do painel (menu Sistema → Plataforma de API → Chaves de API). A chave aparece uma vez só; a Cyzyra guarda apenas uma versão cifrada dela.

Quais permissões uma chave pode ter?+

Leitura, ou leitura e escrita. Ações como criar leads ou mudar campanhas pela conexão MCP exigem a permissão de escrita.

Existe limite de uso?+

Sim: 120 requisições por minuto por chave. Acima disso a API responde 429 e diz em quantos segundos tentar de novo.

E se o meu sistema estiver fora do ar quando um webhook sair?+

A Cyzyra tenta de novo até 5 vezes, com intervalos crescentes, e mostra cada tentativa no painel.

Cada chave vê os dados de quem?+

Só da empresa que criou a chave. Os dados de outras empresas nunca aparecem.

Crie sua conta e gere a primeira chave hoje.

Primeiro mês por US$ 10,00, com acesso total. Depois, você escolhe o plano.

Começar por US$ 10,00

Prefere falar com uma pessoa? Fale com a equipe

Cancelar não tem multa · Garantia de 30 dias

Exemplo ilustrativo