Per gli sviluppatori

Cyzyra nei vostri sistemi. E i tuoi sistemi all'interno di Cyzyra.

API REST, webhook firmati e connessione agli assistenti AI. Per portare i dati aziendali nell'ERP, nella BI o nella propria applicazione.

Leggi la documentazione Apri la piattaforma API

curl https://YOUR-PAINEL/api/v1/leads?limit=20 \ -H "Autorizzazione: Portatore cy_live_..."

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

Esempio illustrativo di chiamata e risposta.

01 / Tre modi per integrare

Leggi, ricevi e chiedi.

Usane uno, due o tutti e tre. Tutti rispettano i permessi della chiave e i dati dell'azienda che la possiede.

API REST
Lead, negoziazioni, pagamenti, oggetti e metriche in JSON, con documentazione OpenAPI.
Webhook
18 eventi aziendali inviati istantaneamente al tuo sistema, con abbonamento.
Assistenti AI (MCP)
Collega Cyzyra agli assistenti AI compatibili con MCP e chiedi informazioni su vendite, pubblicità e profitti.

02/API REST

Endpoint

Autenticazione tramite Autorizzazione: portatore, risposte JSON e impaginazione del cursore.

120 richieste al minuto per chiave
Chiave archiviata solo come hash

GET/api/v1/leadsElenca e cerca lead
POST/api/v1/leadsCreare un lead (con controllo duplicati)
GET/api/v1/leads/{id}Un vantaggio con i dettagli
PATCH/api/v1/leads/{id}Aggiorna un lead
GET/api/v1/dealsNegoziazioni e fasi del funnel
POST/api/v1/dealsCrea uno scambio
GET/api/v1/paymentsFatturazioni e pagamenti
GET/api/v1/objectsI tuoi tipi di oggetto
GET/api/v1/objects/{type}/recordsRecord di un tipo di oggetto
POST/api/v1/objects/{type}/recordsCrea un record
POST/api/v1/queryMetriche con filtri e periodi
POST/api/v1/askDomanda in portoghese sui dati

03 / Webhook

È successo in azienda, è arrivato nel tuo sistema.

Scegli gli eventi e l'indirizzo. Ogni invio viene firmato e ciò che fallisce viene inviato nuovamente fino a 5 volte.

Firma HMAC con ora, contro il nuovo invio
Cronologia di ogni tentativo sulla dashboard

// 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 eventi disponibili

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 inviataproposal.sent
Proposta accettataproposal.accepted
Proposta recusadaproposal.rejected
Contratto inviatocontract.sent
Contrato assinadocontract.signed
Addebito creatopayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received

04 / Assistenti AI

Chiedi a Cyzyra dall'interno del tuo assistente.

Aggiungi l'indirizzo MCP di Cyzyra come connettore personalizzato in un assistente AI compatibile, con la tua chiave API. Inizia a consultare profitti, campagne e vendite e risponde a domande in portoghese sui suoi dati.

URL: https://SEU-PAINEL/api/mcp Intestazione: Autorizzazione: Bearer cy_live_... Strumenti: summary_profit · campagne · vendite chiedi · Manage_campaigns (scrittura)

05 / Domande

Domande tecniche

Visualizza le integrazioni già pronte

Dove creo la chiave API?+

Nel dashboard della piattaforma API (menu Sistema → Piattaforma API → Chiavi API). La chiave appare una sola volta; Cyzyra ne conserva solo una versione crittografata.

Quali permessi può avere una chiave?+

Leggere, ovvero leggere e scrivere. Azioni come la creazione di lead o la modifica di campagne tramite la connessione MCP richiedono l'autorizzazione di scrittura.

C'è un limite di utilizzo?+

Sì: 120 richieste al minuto per chiave. Oltre a ciò, l'API risponde 429 e ti dice quanti secondi riprovare.

Cosa succede se il mio sistema non funziona quando si disattiva un webhook?+

Cyzyra riprova fino a 5 volte, con intervalli crescenti, e visualizza ogni tentativo sulla dashboard.

Quali dati vede ciascuna chiave?+

Solo dall'azienda che ha creato la chiave. I dati di altre società non vengono mai visualizzati.

Crea il tuo account e genera la tua prima chiave oggi stesso.

Primo mese per US$ 10,00, con pieno accesso. Quindi, scegli il piano.

Inizia per US$ 10,00

Preferisci parlare con una persona? Parla con la squadra

Non è prevista alcuna penalità per la cancellazione · Garanzia 30 dias

Esempio illustrativo