خطافات الويب
عندما يحدث شيء ما في الشركة، ترسل Cyzyra منشورًا بتنسيق JSON إلى العنوان الذي قمت بالتسجيل فيه. تكوين في منصة API → خطافات الويب, ، اختيار الأحداث.
ما يصل
X-Cyzyra-Event cabeçalho
نوع الحدث، على سبيل المثال. الدفع.المدفوعة
X-Cyzyra-Delivery cabeçalho
معرف هذا التسليم. استخدم لتجاهل التكرارات.
توقيع X-Cyzyra 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));
}محاولات جديدة
قم بالرد بحالة 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