Pour les développeurs

Cyzyra dans vos systèmes. Et vos systèmes au sein de Cyzyra.

API REST, webhooks signés et connexion aux assistants IA. Pour transférer les données de l'entreprise vers un ERP, une BI ou votre propre application.

Lire la documentation Ouvrez la plateforme API

curl https://VOTRE-PAINEL/api/v1/leads?limit=20\ -H "Autorisation : Porteur cy_live_..."

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

Exemple illustratif d’appel et de réponse.

01 / Trois façons de s'intégrer

Lisez, recevez et demandez.

Utilisez-en un, deux ou les trois. Ils respectent tous les autorisations de la clé et les données de l'entreprise qui la possède.

API REST
Leads, négociations, paiements, objets et métriques en JSON, avec documentation OpenAPI.
Webhooks
18 événements d'entreprise envoyés instantanément à votre système, avec abonnement.
Assistants IA (MCP)
Connectez Cyzyra aux assistants IA compatibles MCP et renseignez-vous sur les ventes, la publicité et les bénéfices.

02/API REST

Points de terminaison

Authentification par Autorisation : Porteur, réponses JSON et pagination du curseur.

120 requêtes par minute par clé
Clé stockée uniquement sous forme de hachage

GET/api/v1/leadsRépertorier et rechercher des leads
POST/api/v1/leadsCréer un prospect (avec vérification des doublons)
GET/api/v1/leads/{id}Une piste avec les détails
PATCH/api/v1/leads/{id}Mettre à jour un prospect
GET/api/v1/dealsNégociations et étapes de l'entonnoir
POST/api/v1/dealsCréer un échange
GET/api/v1/paymentsFacturations et paiements
GET/api/v1/objectsVos types d'objets
GET/api/v1/objects/{type}/recordsEnregistrements d'un type d'objet
POST/api/v1/objects/{type}/recordsCréer un enregistrement
POST/api/v1/queryMétriques avec filtres et périodes
POST/api/v1/askQuestion en portugais sur les données

03 / Webhooks

C'est arrivé dans l'entreprise, c'est arrivé dans votre système.

Choisissez les événements et l'adresse. Chaque soumission est signée et ce qui échoue est renvoyé jusqu'à 5 fois.

Signature HMAC avec délai, contre renvoi
Historique de chaque tentative sur le tableau 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 événements disponibles

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
Proposition envoyéeproposal.sent
Proposition acceptéeproposal.accepted
Proposta recusadaproposal.rejected
Contrat envoyécontract.sent
Contrato assinadocontract.signed
Frais crééspayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received

04 / Assistants IA

Demandez à Cyzyra depuis votre assistant.

Ajoutez l'adresse MCP de Cyzyra en tant que connecteur personnalisé dans un assistant IA compatible, avec votre clé API. Il commence à consulter les bénéfices, les campagnes et les ventes, et répond aux questions en portugais sur ses données.

URL : https://SEU-PAINEL/api/mcp En-tête : Autorisation : Bearer cy_live_... Outils : summary_profit · campagnes · demandes de vente · manage_campaigns (écriture)

05 /Questions

Questions techniques

Afficher les intégrations prêtes à l'emploi

Où puis-je créer la clé API ?+

Dans le tableau de bord API Platform (menu Système → API Platform → Clés API). La clé n'apparaît qu'une seule fois ; Cyzyra n’en conserve qu’une version cryptée.

Quelles autorisations une clé peut-elle avoir ?+

Lire, ou lire et écrire. Les actions telles que la création de prospects ou la modification de campagnes via la connexion MCP nécessitent une autorisation en écriture.

Y a-t-il une limite d'utilisation ?+

Oui : 120 requêtes par minute et par clé. Au-dessus de cela, l'API répond 429 et vous indique combien de secondes vous devez réessayer.

Que se passe-t-il si mon système tombe en panne lorsqu'un webhook s'éteint ?+

Cyzyra réessaye jusqu'à 5 fois, avec des intervalles croissants, et affiche chaque tentative sur le tableau de bord.

De quelles données chaque clé voit-elle ?+

Uniquement de la société qui a créé la clé. Les données d'autres sociétés n'apparaissent jamais.

Créez votre compte et générez votre première clé dès aujourd'hui.

Premier mois pour US$ 10,00, avec un accès complet. Ensuite, vous choisissez le plan.

Commencez pour US$ 10,00

Vous préférez parler à une personne? Parlez à l'équipe

Il n'y a aucune pénalité en cas d'annulation · Garantie 30 dias

Exemple illustratif