الانتقال إلى المحتوى الرئيسي
تتيح خدمة Webhooks لموقع Flowella إرسال الأحداث إلى أنظمتك الخاصة في الوقت الفعلي — على سبيل المثال، إخطار بريدك الإلكتروني CRM عند تسليم رسالة عبر WhatsApp ، أو بدء مهمة في الخلفية عند فشل مزامنة نموذج عبر HubSpot . تتناول هذه الصفحة شاشة الإعدادات → Webhooks داخل التطبيق. للاطلاع على مخططات الحمولة لكل حدث، راجع مرجع Webhooks.

​
من يمكنه إدارة Webhooks

لا يمكن إلا لأدوار المالك والمسؤول رؤية الإعدادات → Webhooks. لا تتمتع الأدوار الأخرى بحق الوصول.

​
إضافة نقطة نهاية webhook

1

افتح الإعدادات → خطاف الويب

من شريط التنقل الأيسر، انتقل إلى الإعدادات → Webhooks.
2

انقر فوق إضافة نقطة نهاية

أدخل عنوان URL العام لـ HTTPS الذي يجب أن ترسل إليه Flowella الأحداث. لا يُقبل HTTP (بدون TLS).
3

اختر الأحداث التي تريد الاشتراك فيها

اختر نوعًا واحدًا أو أكثر من أنواع الأحداث — على سبيل المثال،message.delivered ،template.approved ،flow.sync.failed . توجد قائمة الأحداث الكاملة في مرجع Webhooks. يمكنك الاشتراك في جميع الأحداث باستخدام مربع اختيار واحد.
4

نسخ سر التوقيع

Flowella يعرض سر التوقيع مرة واحدة في نهاية عملية الإنشاء. احفظه في مخزن آمن — ستستخدمه للتحقق من توقيع HMAC في كل طلب وارد.
5

إرسال حدث اختبار

استخدم زر إرسال اختبار لإطلاق حدث اصطناعي في نقطة النهاية الخاصة بك. يسجل سجل التسليم النتيجة حتى تتمكن من التأكد من أن المعالج الخاص بك موصول قبل بدء التشغيل.

​
التوقيع والتحقق

يتضمن كل طلب webhook رأس “X-Flowella-Signature ” مع توقيع HMAC-SHA256 لنص الطلب الخام، محسوبًا باستخدام سر التوقيع الخاص بنقطة النهاية الخاصة بك. تحقق منه قبل الوثوق بالحمولة: 
import crypto from "crypto";

function verify(rawBody, signature, secret) {
  const expected = crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}
يتضمن الطلب أيضًا: -X-Flowella-Timestamp — الطابع الزمني لنظام Unix في وقت الإرسال. قم برفض الطلبات التي يكون الطابع الزمني فيها أكثر من 5 دقائق في الماضي أو المستقبل لمنع هجمات إعادة التشغيل. -X-Flowella-Event — نوع الحدث (على سبيل المثال،message.delivered ). -X-Flowella-Delivery — معرف تسليم فريد، مفيد لإزالة التكرار.

​
المحاولات المتكررة والتراجع

إذا عادت نقطة النهاية الخاصة بك برمز حالة غير 2xx (أو انتهت مهلة الانتظار بعد 10 ثوانٍ)، فإن Flowella تعيد المحاولة مع تراجع أسي:
المحاولةالتأخير بعد السابقة
1 (أولية)—
230 ثانية
3دقيقتان
410 دقائق
5ساعة واحدة
66 ساعات
7 (نهائية)24 ساعة
بعد 7 محاولات فاشلة، يتم وضع علامة فشل على التسليم ويتم إسقاطه. لا يتم تعطيل نقطة النهاية تلقائيًا — لا يزال بإمكانك تلقي الأحداث المستقبلية على نفس نقطة النهاية. إذا فشلت 100 عملية تسليم متتالية، يقوم Flowella بإيقاف نقطة النهاية تلقائيًا وإرسال إشعارWEBHOOK_PAUSED . استأنفها من قائمة الصف بعد إصلاح المشكلة الأساسية.

​
سجل التسليم

يتوسع كل صف من صفوف نقاط النهاية ليظهر سجل التسليم الذي يعرض محاولات الأيام السبعة الأخيرة:
  • نوع الحدث ومعرفه
  • الحالة — ناجح، فاشل، إعادة المحاولة
  • رقم المحاولة
  • رمز الاستجابة ومدتها
  • نص الاستجابة (أول 1 كيلوبايت)
  • تم الإرسال في
انقر فوق أي عملية تسليم لعرض الطلب والاستجابة بالكامل، أو إعادة التسليم يدويًا.

​
إدارة نقاط النهاية

من قائمة صف نقطة النهاية، يمكنك:
  • تحرير — تغيير عنوان URL أو اشتراكات الأحداث. (يظل سر التوقيع كما هو.)
  • تدوير السر — إنشاء سر توقيع جديد. يتوقف السر القديم عن العمل على الفور، لذا قم بتنسيق التغيير مع المعالج الخاص بك.
  • إيقاف مؤقت — إيقاف عمليات التسليم مؤقتًا دون فقدان التكوين.
  • استئناف — إعادة تشغيل نقطة نهاية متوقفة مؤقتًا.
  • حذف — إزالة نقطة النهاية وسجل التسليم الخاص بها.

​
الأسئلة الشائعة

نعم — لا يوجد حد أقصى. تمتلك معظم المؤسسات 1–3 نقاط نهاية (الإنتاج، والتجهيز، ومستودع سجل داخلي). حافظ على عدد منخفض حتى يتم توزيع الأحداث بشكل متوقع.
واجهة برمجة التطبيقات (API) هي سحب — يطلب كودك من Flowella الحالة. أما Webhooks فهي دفع — حيث يُعلم Flowella كودك عند تغير الحالة. استخدم Webhooks لأي شيء كنت ستقوم باستقصائه بطريقة أخرى.
تتضمن حمولات Webhook معرّفات المحادثة وأرقام هواتف الاتصال ومحتوى الرسائل وأسماء القوالب. تعامل مع السر وعنوان URL لنقطة النهاية على أنهما حساسان. قم بتقييد نقطة النهاية الخاصة بك لقبول POST من نطاق IP الخاص بـ Flowella إذا كانت البنية التحتية الخاصة بك تسمح بذلك.
استخدم أداة نفق (ngrok، Cloudflare Tunnel) لعرض نقطة النهاية الخاصة بـ localhost على عنوان URL HTTPS عام، ثم وجه نقطة نهاية اختبار إليها. لا تضع عنوان URL للنفق في نقطة النهاية الخاصة بالإنتاج — فهي تنتهي صلاحيتها.

​
ذات صلة

مرجع Webhooks

أنواع الأحداث ومخططات الحمولة والرؤوس.

مفاتيح واجهة برمجة التطبيقات

النصف الآخر من التكامل البرمجي.

مقدمة واجهة برمجة التطبيقات

الأخطاء وحدود المعدل وترقيم الصفحات.

أحداث الإخطار

نفس الأحداث التي يتم تسليمها إلى موجز التطبيق والبريد الإلكتروني.