ویب ہکس
جب کمپنی میں کچھ ہوتا ہے، 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 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