انتقل إلى المحتوى

خطافات الويب

عندما يحدث شيء ما في الشركة، ترسل 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 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