خطافات الويب

أضف نقطة استقبال

من الإعدادات ← المطورون، أضف عنوان https واختر الأحداث: إنشاء جهة اتصال، وإضافة وسم، ووصول رسالة، وتسجيل عملية بيع، وإلغاء حجز، والمزيد. انسخ سر التوقيع؛ فهو يُعرض مرة واحدة فقط.

تحقّق من التوقيع

يحمل كل طلب `X-ChatinFlow-Signature: t=<unix time>,v1=<signature>`. احسب HMAC-SHA256 لـ `<t>.<raw body>` بالسر، وقارنه بـ `v1` في زمن ثابت، وارفض الطوابع الزمنية الأقدم من خمس دقائق.

signature = hex(hmac_sha256(secret, t + "." + raw_body))
valid = equals(signature, v1) and now - t < 300

استجب بسرعة وتجاهل التكرار

استجب بأي رمز 2xx خلال 10 ثوانٍ. يُعاد تسليم أي طلب فاشل بعد دقيقة، ثم 5 دقائق، ثم 30 دقيقة، ثم ساعتين، ثم 12 ساعة. التسليم يحدث مرة واحدة على الأقل: تبقى `X-ChatinFlow-Delivery` كما هي عبر المحاولات، فتجاهل المعرّفات التي عالجتها.

نقاط الاستقبال المتوقفة

بعد 50 محاولة فاشلة متتالية، أو رد 410 Gone، تتوقف نقطة الاستقبال وتعرض السبب. أصلحها وأعد تشغيلها، ثم أعد إرسال عمليات التسليم الفاشلة من السجل.

Zapier وMake وn8n

أنشئ نقطة استقبال للحدث الذي تحتاجه والصق عنوان الالتقاط الخاص بـ Zap أو السيناريو لديك. `GET /api/v1/workspaces/<workspace>/webhooks/events` يسرد كل حدث مع حمولة نموذجية لربط الحقول.

اربط القناة أولًا

يسجّل الربط عبر OAuth أو بيانات الاعتماد من لوحة التحكم ← القنوات مسار الـ Webhook وأسراره. في منتجنا لا تحتاج إلى لصق روابط callback الخاصة بـ Meta يدويًا.

استقبال دون تكرار

تُزال التكرارات من عمليات تسليم المزوّدين باستخدام Idempotency-Key أو معرّفات رسائل المزوّد، فلا تُنشئ إعادة المحاولة محادثات مكررة.

فقدان الأذونات

إذا أُلغيت الأذونات، تعرض صفحة القنوات طلب إعادة التفويض. أصلح الأذونات قبل البحث عن "Webhooks مفقودة".