Webhooks
כשמשהו קורה בחברה, Cyzyra שולחת POST ב-JSON לכתובת שאתה רושם. הגדר ב פלטפורמת API → Webhooks, בחירת האירועים.
מה מגיע
X-Cyzyra-Event cabeçalho
סוג האירוע, למשל. תשלום.שולם
X-Cyzyra-Delivery cabeçalho
המזהה של משלוח זה. השתמש כדי להתעלם מחזרות.
X-Cyzyra-Signature cabeçalho
t=<unix time>,v1=<HMAC-SHA256>
גוּף
{
"id": "evt_3f9c…",
"type": "payment.paid",
"created_at": "2026-11-08T14:02:11Z",
"data": {
"entity_type": "payment",
"entity_id": "a93e…",
"title": "Pagamento confirmado",
"object": {
"id": "a93e…",
"amount": 1500,
"currency": "BRL",
"status": "paid"
}
}
}مثال گویا
אשר מנוי
חשב את HMAC-SHA256 מ <t>.<raw body> עם סוד נקודת הקצה ולהשוות עם v1. Recuse horários muito antigos para evitar reenvio por terceiros.
import { createHmac, timingSafeEqual } from "node:crypto";
function verify(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const expected = createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest("hex");
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
return fresh && timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}ניסיונות חדשים
השב עם סטטוס 2xx תוך 10 שניות. אם זה נכשל, Cyzyra מנסה שוב עד 5 פעמים, במרווחים הולכים וגדלים, ומציגה כל ניסיון בלוח המחוונים.
אירועים
Lead criado
lead.createdStatus do lead mudou
lead.status_changedCadastros unificados
lead.mergedNegociação criada
deal.createdNegociação mudou de etapa
deal.stage_changedVenda ganha
deal.wonVenda perdida
deal.lostההצעה נשלחה
proposal.sentההצעה התקבלה
proposal.acceptedProposta recusada
proposal.rejectedהחוזה נשלח
contract.sentContrato assinado
contract.signedנוצר מטען
payment.createdPagamento recebido
payment.paidPagamento falhou
payment.failedPagamento estornado
payment.refundedOrdem de serviço criada
work_order.createdMensagem recebida
message.received