Voor ontwikkelaars

Cyzyra binnen uw systemen. En uw systemen binnen Cyzyra.

REST API, ondertekende webhooks en verbinding met AI-assistenten. Om bedrijfsdata naar ERP, BI of uw eigen applicatie te brengen.

Lees de documentatie Open het API-platform

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

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

Illustratief voorbeeld van oproep en antwoord.

01 / Drie manieren om te integreren

Lees, ontvang en vraag.

Gebruik er één, twee of alle drie. Ze respecteren allemaal de machtigingen van de sleutel en de gegevens van het bedrijf dat de sleutel bezit.

REST-API
Leads, onderhandelingen, betalingen, objecten en statistieken in JSON, met OpenAPI-documentatie.
Webhaken
18 bedrijfsevenementen die direct naar uw systeem worden verzonden, met abonnement.
AI-assistenten (MCP)
Verbind Cyzyra met MCP-compatibele AI-assistenten en vraag naar verkoop, reclame en winst.

02 / REST-API

Eindpunten

Authenticatie door Machtiging: Aan toonder, JSON-antwoorden en cursorpaginering.

120 verzoeken per minuut per sleutel
Sleutel alleen opgeslagen als hash

GET/api/v1/leadsMaak een lijst van en zoek naar leads
POST/api/v1/leadsCreëer een lead (met duplicaatcontrole)
GET/api/v1/leads/{id}Een lead met de details
PATCH/api/v1/leads/{id}Een lead bijwerken
GET/api/v1/dealsOnderhandelingen en trechterfasen
POST/api/v1/dealsCreëer een handel
GET/api/v1/paymentsFacturen en betalingen
GET/api/v1/objectsUw objecttypen
GET/api/v1/objects/{type}/recordsRecords van een objecttype
POST/api/v1/objects/{type}/recordsMaak een record
POST/api/v1/queryStatistieken met filters en perioden
POST/api/v1/askVraag in het Portugees over de gegevens

03 / Webhooks

Het gebeurde bij het bedrijf, het kwam in jouw systeem terecht.

Kies de evenementen en het adres. Elke inzending wordt ondertekend en wat niet lukt, wordt maximaal vijf keer opnieuw verzonden.

HMAC-handtekening met tijd, tegen opnieuw verzenden
Geschiedenis van elke poging op het 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 beschikbare evenementen

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
Voorstel verzondenproposal.sent
Voorstel geaccepteerdproposal.accepted
Proposta recusadaproposal.rejected
Contract verzondencontract.sent
Contrato assinadocontract.signed
Charge aangemaaktpayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received

04 / AI-assistenten

Vraag het aan Cyzyra vanuit je assistent.

Voeg het MCP-adres van Cyzyra toe als een aangepaste connector in een compatibele AI-assistent, met uw API-sleutel. Hij begint winst, campagnes en verkopen te raadplegen en beantwoordt vragen in het Portugees over zijn gegevens.

URL: https://SEU-PAINEL/api/mcp Header: Autorisatie: Bearer cy_live_... Tools: summary_profit · campagnes · verkoopvraag · manage_campaigns (schrijven)

05 / Vragen

Technische vragen

Bekijk kant-en-klare integraties

Waar maak ik de API-sleutel aan?+

In het API Platform-dashboard (menu Systeem → API-platform → API-sleutels). De sleutel verschijnt slechts één keer; Cyzyra bewaart er alleen een gecodeerde versie van.

Welke rechten kan een sleutel hebben?+

Lezen, of lezen en schrijven. Voor acties zoals het aanmaken van leads of het wijzigen van campagnes via de MCP-verbinding is schrijftoestemming vereist.

Is er een gebruikslimiet?+

Ja: 120 aanvragen per minuut per sleutel. Bovendien antwoordt de API 429 en vertelt u hoeveel seconden u het opnieuw moet proberen.

Wat moet ik doen als mijn systeem uitvalt wanneer een webhook uitvalt?+

Cyzyra probeert het maximaal vijf keer opnieuw, met toenemende intervallen, en geeft elke poging weer op het dashboard.

Wiens gegevens ziet elke sleutel?+

Alleen van het bedrijf dat de sleutel heeft gemaakt. Gegevens van andere bedrijven verschijnen nooit.

Maak uw account aan en genereer vandaag nog uw eerste sleutel.

Eerste maand voor US$ 10,00, met volledige toegang. Vervolgens kiest u het plan.

Begin voor US$ 10,00

Liever met iemand praten? Praat met het team

Er zijn geen kosten verbonden aan het annuleren. · Garantie 30 dias

Illustratief voorbeeld