مواد پر جائیں۔

ویب ہکس

جب کمپنی میں کچھ ہوتا ہے، Cyzyra JSON میں ایک POST اس ایڈریس پر بھیجتی ہے جس پر آپ رجسٹر کرتے ہیں۔ میں ترتیب دیں۔ API پلیٹ فارم → ویب ہکس, ، واقعات کا انتخاب کرنا۔

جو آتا ہے

X-Cyzyra-Event cabeçalho

واقعہ کی قسم، جیسے pay.paid

X-Cyzyra-Delivery cabeçalho

اس ڈیلیوری کی آئی ڈی۔ تکرار کو نظر انداز کرنے کے لیے استعمال کریں۔

X-Cyzyra- دستخط 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>۔< خام جسم> اختتامی نقطہ راز کے ساتھ اور اس کے ساتھ موازنہ کریں۔ 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