كيف يمكنني إرسال تنبيهات إلى خدمات خارجية باستخدام Webhook؟

تقوم ميزة "إشعارات Webhook" بإرسال بيانات الأحداث من Auto Refresh Plus (ARP) إلى نقاط النهاية الخارجية كلما تم استيفاء شروط المراقبة. ومن خلال إعادة توجيه هذه الأحداث إلى خدمات الجهات الخارجية أو أدوات الأتمتة أو التطبيقات المخصصة، يمكنك إنشاء عمليات تكامل قوية وسير عمل آلي.

كيفية تكوين إخطارات Webhook

اتبع الخطوات التالية:

• افتح الإعدادات العامة
• انتقل إلى "الإشعارات"
• افتح Webhooks
• أنشئ تكوين Webhook جديد
• أدخل اسمًا لـ webhook
• حدد نوع الخدمة
• أدخل عنوان URL لـ Webhook
• حفظ التكوين

بعد إنشاء webhook:

• افتح ملحق Auto Refresh Plus
• انتقل إلى علامة التبويب "المراقبة"
• قم بتمكين "تلقي تنبيهات Webhook"
• ابدأ مراقبة الصفحة

لن يتم إرسال إشعارات Webhook إلا للصفحات التي تم تمكين تنبيهات Webhook فيها.

متطلبات عنوان URL لـ Webhook

يجب أن تكون نقطة نهاية Webhook الخاصة بك:

• أن تكون متاحة للجمهور
• قبول طلبات HTTP POST
• قبول حمولات JSON

مثال على عنوان URL:

https://yourdomain.com/webhook

إذا تعذر الوصول إلى الخادم الخاص بك من الإنترنت، فلن يتم تسليم إشعارات webhook.

البيانات المرسلة إلى Webhook الخاص بك

عند حدوث حدث مراقبة، يرسل Auto Refresh Plus حمولة JSON تحتوي على معلومات الحدث.

مثال على الحمولة:

{
  "content": "triggered",
  "type": "found",
  "url": "https://example.com"
}

خصائص الحمولة:

• المحتوى – الكلمة الرئيسية أو القيمة التي أدت إلى حدوث الحدث
• type – نوع الحدث (found, lost، أو any)
• url – عنوان URL لصفحة الويب التي وقع فيها الحدث

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

الاستخدامات الشائعة لـ Webhooks

يمكن استخدام إخطارات Webhook من أجل:

• إرسال تنبيهات إلى التطبيقات المخصصة
• تشغيل سير عمل الأتمتة
• تحديث لوحات المعلومات
• تسجيل أحداث المراقبة
• ربط Auto Refresh Plus بأنظمة الجهات الخارجية

ملاحظات مهمة

• يجب إكمال تكوين Webhook في الإعدادات العامة
• يجب أيضًا تمكين تنبيهات Webhook من علامة التبويب "المراقبة" لكل صفحة
• يتم إرسال الأحداث باستخدام طلبات HTTP POST
• يجب أن يكون الخادم الخاص بك قادرًا على استقبال ومعالجة بيانات JSON

ملخص

تسهل إشعارات Webhook ربط Auto Refresh Plus بالأنظمة الخارجية وأدوات الأتمتة. من خلال توفير عنوان URL لـ Webhook وتمكين التنبيهات، يمكن إعادة توجيه أحداث المراقبة تلقائيًا كلما تم الكشف عن شرط متتبع أو مشغل كلمة رئيسية.