مرجع الويب هوكس

ترسل صلة الويب هوكس من الخادم إلى الخادم مع تواقيع HMAC وترويسة زمنية وإعادة محاولات تلقائية.

الترويسات

text
X-Sela-Event: conversation.created
X-Sela-Delivery: whd_...
X-Sela-Timestamp: 1712345678901
X-Sela-Signature-Version: v1
X-Sela-Signature: <hex hmac sha256>

طريقة التوقيع

احسب HMAC-SHA256 باستخدام السر المخزّن لديك وعلى النص التالي: timestamp + '.' + rawBody

javascript
import crypto from "node:crypto";

const signedPayload = `${req.headers["x-sela-timestamp"]}.${rawBody}`;
const expected = crypto
  .createHmac("sha256", process.env.SELA_WEBHOOK_SECRET!)
  .update(signedPayload)
  .digest("hex");

إعادة المحاولات

إذا أعادت نقطتك حالة غير ناجحة أو انتهت المهلة، تعيد صلة المحاولة حتى 5 مرات بتراجع تصاعدي. يجب التعامل مع X-Sela-Delivery كمفتاح إزالة التكرار.