Pentru dezvoltatori

Cyzyra în sistemele dumneavoastră. Și sistemele tale din Cyzyra.

API REST, webhook-uri semnate și conexiune la asistenți AI. Pentru a prelua datele companiei către ERP, BI sau propria aplicație.

Citiți documentația Deschideți platforma API

curl https://YOUR-PAINEL/api/v1/leads?limit=20 \ -H „Authorization: Bearer cy_live_...”

{ „date”: [{ „id”: „…”, „nume”: „…”, „status”: „nou” }], „următorul_cursor”: null }

Exemplu ilustrativ de apel și răspuns.

01 / Trei moduri de integrare

Citiți, primiți și cereți.

Folosiți unul, doi sau toate trei. Toți respectă permisiunile cheii și datele companiei care o deține.

API-ul REST
Leads, negocieri, plăți, obiecte și valori în JSON, cu documentație OpenAPI.
Webhook-uri
18 evenimente companiei trimise la sistemul dvs. instantaneu, cu abonament.
Asistenți AI (MCP)
Conectați Cyzyra la asistenți AI compatibili cu MCP și întrebați despre vânzări, publicitate și profit.

02 / REST API

Puncte finale

Autentificare prin Autorizație: Purtător, răspunsuri JSON și paginarea cursorului.

120 de cereri pe minut per cheie
Cheia stocată doar ca hash

GET/api/v1/leadsListați și căutați clienți potențiali
POST/api/v1/leadsCreați un client potențial (cu verificare în duplicat)
GET/api/v1/leads/{id}Un lead cu detalii
PATCH/api/v1/leads/{id}Actualizați un client potențial
GET/api/v1/dealsNegocieri și etapele pâlnie
POST/api/v1/dealsCreați o tranzacție
GET/api/v1/paymentsFacturari si plati
GET/api/v1/objectsTipurile dvs. de obiecte
GET/api/v1/objects/{type}/recordsÎnregistrări ale unui tip de obiect
POST/api/v1/objects/{type}/recordsCreați o înregistrare
POST/api/v1/queryValori cu filtre și perioade
POST/api/v1/askÎntrebare în portugheză despre date

03 / Webhooks

S-a întâmplat la companie, a ajuns în sistemul dumneavoastră.

Alegeți evenimentele și adresa. Fiecare trimitere este semnată, iar ceea ce eșuează este retrimis de până la 5 ori.

Semnătura HMAC cu timp, împotriva retrimiterii
Istoricul fiecărei încercări pe tabloul de bord

// 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 evenimente disponibile

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
Propunerea trimisăproposal.sent
Propunere acceptatăproposal.accepted
Proposta recusadaproposal.rejected
Contract trimiscontract.sent
Contrato assinadocontract.signed
Taxa creatăpayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received

04 / Asistenți AI

Întrebați-o pe Cyzyra din interiorul asistentului dvs.

Adăugați adresa MCP a Cyzyra ca conector personalizat într-un asistent AI compatibil, cu cheia dvs. API. Începe să consulte profit, campanii și vânzări și răspunde la întrebări în portugheză despre datele sale.

URL: https://SEU-PAINEL/api/mcp Antet: Autorizare: Bearer cy_live_... Instrumente: summary_profit · campanii · vânzări ask · manage_campaigns (scriere)

05 / Întrebări

Întrebări tehnice

Vizualizați integrări gata făcute

Unde creez cheia API?+

În tabloul de bord API Platform (meniul System → API Platform → API Keys). Tasta apare o singură dată; Cyzyra păstrează doar o versiune criptată a acestuia.

Ce permisiuni poate avea o cheie?+

Citirea, sau citirea și scrisul. Acțiuni precum crearea de clienți potențiali sau modificarea campaniilor prin conexiunea MCP necesită permisiunea de scriere.

Există o limită de utilizare?+

Da: 120 de solicitări pe minut per cheie. Mai sus, API-ul răspunde 429 și vă spune câte secunde să încercați din nou.

Ce se întâmplă dacă sistemul meu este oprit când un webhook se închide?+

Cyzyra reîncearcă de până la 5 ori, cu intervale crescânde, și afișează fiecare încercare pe tabloul de bord.

Ale cui date vede fiecare cheie?+

Doar de la compania care a creat cheia. Datele de la alte companii nu apar niciodată.

Creați-vă contul și generați prima cheie astăzi.

Prima luna pt US$ 10,00, cu acces complet. Apoi, alegi planul.

Începe pentru US$ 10,00

Preferi să vorbești cu o persoană? Vorbește cu echipa

Nu există nicio penalizare pentru anulare · Garanție 30 dias

Exemplu ilustrativ