सामग्री पर जाएं

वेबहुक

जब कंपनी में कुछ होता है, तो 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 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
प्रस्ताव भेजा गयाproposal.sent
प्रस्ताव स्वीकार कर लिया गयाproposal.accepted
Proposta recusadaproposal.rejected
अनुबंध भेजा गयाcontract.sent
Contrato assinadocontract.signed
चार्ज बनाया गयाpayment.created
Pagamento recebidopayment.paid
Pagamento falhoupayment.failed
Pagamento estornadopayment.refunded
Ordem de serviço criadawork_order.created
Mensagem recebidamessage.received