🔗 إنشاء وإدارة Webhooks لربط نظامك بالأنظمة الخارجية
📹 ملخص الفيديو
في هذا الشرح ستتعرف على معنى Webhooks ودورها في ربط نظام أزير بالأنظمة الخارجية، وكيف يمكنك الوصول إلى صفحة الـ Webhooks، إنشاء خطاف جديد خطوة بخطوة (الاسم، الحدث، السياسة، نقطة النهاية، ورمز الأمان)، بالإضافة إلى كيفية إدارة وتفعيل الخطافات الحالية وأفضل الممارسات لحماية البيانات.
مرحبًا، في هذا الشرح سنتعرّف على ميزة إنشاء وإدارة Webhooks في منصة أزير (Azeer)، وكيف تساعدك على إرسال إشعارات فورية من حسابك إلى أنظمتك الداخلية أو أدواتك الخارجية كلّما حدثت واقعة معيّنة داخل النظام.
من خلال Webhooks يمكنك متابعة الأحداث المهمة مثل الرسائل الواردة، إنشاء جهات الاتصال، أو انتهاء البث، وربطها مع أنظمة مثل الـ CRM، أنظمة التقارير، أو أي نظام داخلي آخر؛ بدون الحاجة لعمل استعلامات يدوية في كل مرة.
1. مسار الوصول إلى صفحة Webhooks
للوصول إلى صفحة إدارة Webhooks:
- من القائمة الجانبية في لوحة التحكم انتقل إلى الإعدادات.
- من قائمة الإعدادات الفرعية اختر Webhooks.
ستظهر لك صفحة تحتوي على:
- زر إنشاء خطاف ويب أعلى الجدول.
- جدول بقائمة الـ Webhooks الحالية، يحتوي على أعمدة مثل: الاسم، الرابط (URL المختصر)، حالة التفعيل، وتاريخ الإنشاء، بالإضافة إلى قائمة الإجراءات لإدارة كل خطاف.
2. أولًا: ما هو الـ Webhook؟
الـ Webhook هو طريقة لإرسال إشعار فوري إلى نقطة الربط (endpoint) في نظام خارجي عند وقوع حدث معيّن داخل حسابك في أزير. بمجرّد أن يحدث الحدث (مثل استقبال رسالة جديدة)، يقوم النظام بإرسال طلب HTTP POST يحتوي على بيانات الحدث إلى عنوان URL الذي قمت بتحديده.
بهذه الطريقة تستطيع:
- مزامنة الأحداث مع نظام الـ CRM.
- إنشاء سجلات في قاعدة بيانات خارجية.
- تشغيل أتمتة معيّنة في نظام آخر (مثل فاتورة، تنبيه، أو تحديث حالة).
3. ثانيًا: إنشاء Webhook جديد خطوة بخطوة
1. إدخال البيانات الأساسية
- الاسم: أدخل اسمًا واضحًا (مثال: `Webhook | incoming_ms`).
- الوصف: (اختياري) يوضّح وظيفة الخطاف (مثال: "إرسال تفاصيل الرسائل الواردة إلى نظام الـ CRM").
2. اختيار الحدث والسياسة
- الحدث (Event): اختر متى يتم إرسال الإشعار (مثل: رسالة واردة، المحادثة مغلقة، تم إنشاء جهة اتصال...).
- السياسة (Policy): اختر طريقة التشغيل المناسبة (بسيط، دفعة متوسطة، إلخ) حسب كثافة البيانات، ويُفضل التنسيق مع فريقك التقني.
3. نقطة الربط والأمان
- نقطة النهاية (Endpoint URL): عنوان URL في نظامك الخارجي الذي سيستقبل الطلب (يُفضّل أن يبدأ بـ https).
- رمز الأمان (Secret Token): قيمة سرّية للتحقق من أن الطلب قادم من أزير؛ لا تشاركها إلا مع الأطراف المصرّح لها.
بعد الانتهاء، اضغط حفظ وتأكد من تفعيل الخطاف من الجدول.
4. ثالثًا: إدارة الـ Webhooks الموجودة
من صفحة Webhooks الرئيسية يمكنك إدارة الخطافات:
- تفعيل أو إيقاف: استخدم زر الحالة لتوقيف الإرسال مؤقتًا (مفيد أثناء الصيانة).
- مراجعة التفاصيل: التحقق من الاسم والرابط وتاريخ الإنشاء.
- الإجراءات المتقدمة: (من زر الثلاث نقاط) لتعديل الإعدادات أو حذف الخطاف نهائيًا.
5. رابعًا: أفضل الممارسات
- استخدم أسماء واضحة ومحدّدة لكل Webhook.
- استخدم https في نقطة الربط لحماية البيانات أثناء الانتقال.
- اختبر نقطة الربط داخليًا قبل الاعتماد عليها في بيئة حقيقية.
- احفظ رمز الأمان في مكان آمن، وغيّره إذا اشتبهت في تسريبه.
- جمّع الأحداث المتشابهة في خطاف واحد، وتجنّب ربط كل شيء بخطاف واحد ضخم.
✨ الخلاصة
ميزة إنشاء وإدارة Webhooks في أزير تمنحك طريقة مرنة لربط حسابك بأنظمة أخرى واستقبال الأحداث المهمة فور وقوعها. من خلال الإعداد الصحيح للحدث، السياسة، ونقطة الربط، تستطيع بناء تكاملات قوية تدعم فرقك بدون تدخّل يدوي.
❓ الأسئلة الشائعة
س1: ما الفرق بين إيقاف Webhook وحذفه؟
الإيقاف يوقف الإرسال مؤقتًا مع الاحتفاظ بالإعدادات، بينما الحذف يزيله نهائيًا ولا يمكن استعادته.
س2: هل يمكن استخدام نفس نقطة الربط لأكثر من Webhook؟
نعم، بشرط أن يكون نظامك الخارجي قادرًا على التمييز بين أنواع الأحداث المختلفة الواردة إليه.
س3: ماذا يحدث إذا كانت نقطة الربط غير متاحة؟
لن يتم استقبال البيانات، وقد يحاول النظام إعادة الإرسال حسب الإعدادات. يجب مراقبة سجلات الأخطاء في نظامك.
س4: هل استخدام Webhooks يؤثر على أداء المحادثات؟
غالبًا لا، لأنها تعمل في الخلفية. لكن إرسال كم هائل لنقطة بطيئة قد يؤثر على سرعة المعالجة الخارجية.
س5: كيف أختار السياسة المناسبة لتشغيل Webhook؟
يعتمد على حجم البيانات؛ للأحداث البسيطة اختر سياسة عادية، وللحملات الكبيرة نسّق مع فريقك التقني لاختيار سياسة تردد مناسبة.