الأحداث

في هذه الصفحة، يمكنك إعداد معالجات الأحداث لمراقبة أحداث محددة في النظام وتعريف مسارات العمل التي تعمل تلقائياً عند حدوثها.

معلومات عامة

يتم توفير المعلومات التالية حول كل معالج أحداث:

المعرّف

معرّف معالج الأحداث.

الوصف المختصر

وصف موجز لمعالج الأحداث.

الحدث

نوع الحدث. أنواع الأحداث التالية مدعومة:

• استلام رصيد الحساب
• حدث التحويل
• إنشاء حساب
• عملية ناجحة

مسار عمل معالج الأحداث

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

مفعّل

إذا كان مفعّل، فإن معالج الأحداث يكون نشطاً وسيعالج الأحداث التي تستوفي الشروط المكوّنة.

لعرض تفاصيل معالج الأحداث أو تعديلها، حدد معالجاً وانقر زر تعديل.

التفاصيل

في صفحة التفاصيل، يمكنك تفعيل أو تعطيل معالج الأحداث المحدد وضبط معلماته.

فيما يلي قائمة بمعالجات الأحداث المدعومة التي يمكنك ضبط معلماتها الخاصة:

استلام رصيد الحساب

يتم تشغيل معالج الأحداث هذا عندما يتلقى B2CORE رصيداً محدثاً من مزود خدمة خارجي متصل بـ Back Office (على سبيل المثال، Twilio). إذا كان الرصيد المستلم يفي بالحد الأدنى المكوّن، يتم إرسال إشعار إلى عناوين البريد الإلكتروني المحددة.

إرسال إشعار إذا كان رصيد الحساب أقل من أو يساوي

حد الرصيد الذي يشغّل الإشعار.

مسارات العمل المتاحة

SendNotificationWorkflow — يرسل إشعاراً عبر البريد الإلكتروني إلى عناوين البريد الإلكتروني المحددة عندما ينخفض رصيد الخدمة الخارجية إلى ما دون الحد المكوّن أو يساويه.

رسائل البريد الإلكتروني

عنوان بريد إلكتروني واحد أو أكثر سيتم إرسال الإشعار إليها.

القالب

قالب البريد الإلكتروني المستخدم لإرسال الإشعارات، مثل balanceWarning. يمكن اختيار القالب من قائمة قوالب البريد الإلكتروني المتاحة في System > Templates > Email > Templates.

حدث التحويل

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

المعالجات المتاحة

Filter by platforms and amount — يرشح أحداث التحويل استناداً إلى منصات المصدر والوجهة المحددة والحد الأدنى لمبلغ التحويل. لا يتم تشغيل المعالج إلا عندما يستوفي التحويل الشروط المحددة.

معرّف منصة الوجهة

معرّف منصة الوجهة التي يتم إجراء التحويل إليها. هذه معلمة مطلوبة.

معرّف منصة المصدر

معرّف منصة المصدر التي يتم إجراء التحويل منها. هذه معلمة اختيارية.

الحد الأدنى للمبلغ

الحد الأدنى لمبلغ التحويل المطلوب لتشغيل الحدث. هذه المعلمة اختيارية.

مسارات العمل المتاحة

SendNotificationWorkflow — يرسل إشعاراً عبر البريد الإلكتروني إلى عناوين البريد الإلكتروني المحددة عند حدوث تحويل يطابق المعايير المكوّنة.

رسائل البريد الإلكتروني

عنوان بريد إلكتروني واحد أو أكثر سيتم إرسال الإشعار إليها.

القالب

قالب البريد الإلكتروني المستخدم لإرسال الإشعارات، مثل TransferEvent. يمكن اختيار القالب من قائمة قوالب البريد الإلكتروني المتاحة في System > Templates > Email > Templates.

إنشاء حساب

يتم تشغيل معالج الأحداث عند إنشاء حساب أو محفظة لعميل. عند وقوع هذا الحدث، يتم إرسال طلب POST إلى عنوان URL الخارجي المحدد. يتضمن نص الطلب تفاصيل الحساب بتنسيق JSON أو بيانات نموذج مرمزة بـ URL، وفقاً لنوع المحتوى المحدد.

توضح الأمثلة أدناه كيفية تنسيق نص طلب POST لكل نوع محتوى مدعوم:

{
  "client": {
    "id": 3651,
    "email": "client@example.com"
  },
  "product": {
    "name": "ewallet",
    "group_type": "Default",
    "platform": {
      "id": 1,
      "name": "eWallet",
      "caption": "eWallet"
    }
  },
  "account_number": "80759"
}

client%5Bid%5D=3650&client%5Bemail%5D=client%40example.com&product%5Bname%5D=ewallet&product%5Bgroup_type%5D=Default&product%5Bplatform%5D%5Bid%5D=1&product%5Bplatform%5D%5Bname%5D=eWallet&product%5Bplatform%5D%5Bcaption%5D=eWallet&account_number=80735

مسارات العمل المتاحة

SendToEndpoint — يرسل طلب POST يتضمن تفاصيل الحساب أو المحفظة المنشأة إلى نقطة النهاية الخارجية المحددة. يتم إرسال الطلب فور تشغيل الحدث.

نقطة النهاية الخارجية

عنوان URL الخارجي الذي سيتم إرسال طلب POST إليه. هذه المعلمة مطلوبة.

نوع المحتوى

تنسيق نص الطلب. القيم التالية مدعومة:

• application/x-www-form-urlencoded
• application/json

عملية ناجحة

يتم تشغيل معالج الأحداث عند إكمال إيداع أو سحب أو تحويل أو صرف بنجاح. عند وقوع هذا الحدث، يتم إرسال طلب POST إلى عنوان URL الخارجي المحدد. يتضمن نص الطلب تفاصيل المعاملة بتنسيق JSON أو بيانات نموذج مرمزة بـ URL، وفقاً لنوع المحتوى المحدد.

العمليات

نوع معاملة واحد أو أكثر. هذه المعلمة مطلوبة.

يمكن تحديد أنواع المعاملات التالية:

• payment — الإيداعات
• payout — السحوبات
• transfer — التحويلات
• exchange — عمليات الصرف

مسارات العمل المتاحة

SendToEndpoint — يرسل طلب POST يتضمن تفاصيل معاملة ناجحة إلى نقطة النهاية الخارجية المحددة. يتم إرسال الطلب فور تشغيل الحدث.

نقطة النهاية الخارجية

عنوان URL الخارجي الذي سيتم إرسال طلب POST إليه. هذه المعلمة مطلوبة.

نوع المحتوى

تنسيق نص الطلب. القيم التالية مدعومة:

• application/x-www-form-urlencoded
• application/json