वेबहुक
जब कंपनी में कुछ होता है, तो Cyzyra आपके पंजीकृत पते पर JSON में एक POST भेजता है। में कॉन्फ़िगर करें एपीआई प्लेटफ़ॉर्म → वेबहुक, घटनाओं का चयन करना।
क्या आता है
X-Cyzyra-Event cabeçalho
ईवेंट प्रकार, उदा. भुगतान.भुगतान
X-Cyzyra-Delivery cabeçalho
इस डिलीवरी की आईडी. दोहराव को अनदेखा करने के लिए उपयोग करें.
एक्स-साइज़ीरा-हस्ताक्षर cabeçalho
t=<यूनिक्स समय>,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>.<कच्चा शरीर> समापन बिंदु रहस्य के साथ और तुलना करें 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));
}नये प्रयास
10 सेकंड के भीतर 2xx स्थिति के साथ उत्तर दें। यदि यह विफल हो जाता है, तो 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