انتقل إلى المحتوى الرئيسي

تحرير حدث

يتكون محرر الحدث من ثلاث علامات تبويب:

  • Conditions
  • Attributes
  • Settings

Conditions​

تحتوي علامة التبويب "Conditions" على حقول تحرير الحدث: بياناته الأساسية Name ومعرّف فريد يمكن من خلاله الحصول على الكيان، وشروط إطلاقه.

الوحدات​

اختر في الشروط الوحدة التي يُحدَّد على أساسها شرط إرسال الحدث. الوحدات المتاحة:

  • catalog
  • forms
  • orders
  • users

شروط الوحدة catalog​

في الوحدة catalog يمكنك أن تختار في الحقل type التصفية حسب الحالات (يفتح في علامة تبويب جديدة)، ثم تختار حالة محددة، فتشترك بذلك في حدث تغيّر حالة عناصر الكتالوج.
ويمكنك بدلًا من ذلك الاشتراك في الحدث حسب مجموعات السمات (يفتح في علامة تبويب جديدة) واختيار سمة محددة.

شروط الوحدة forms​

في الوحدة forms اختر نوع النموذج الذي يُضاف إليه الحدث. الخيارات المتاحة:

  • Registration
    يُنشأ الحدث عند تسجيل مستخدم جديد عبر Content API أو في نظام إدارة المحتوى.
  • Send Code
    يُنشأ الحدث عند توليد رمز تأكيد جديد للمستخدم (بما في ذلك عند التسجيل).
  • Change Password
    يُنشأ الحدث عندما يغيّر المستخدم كلمة المرور.
  • Submit form data
    يُنشأ الحدث عند إرسال بيانات النموذج المحدد عبر API.

في خيار Submit form data اختر نموذجًا (من النماذج ذات النوع "Data submission") والسمة التي أضفتها للبريد الإلكتروني، فهذا الاشتراك لا يشمل السمات الأخرى. عند إرسال النموذج تُرسَل البيانات إلى البريد الإلكتروني المحدد في هذه السمة.
للمزيد عن النماذج، راجع فصل Forms (يفتح في علامة تبويب جديدة).

تتضمن كل أحداث الوحدة forms معلومات عن المستخدم، وتحتوي أحداث Registration وSend Code أيضًا على رمز التأكيد.

شروط الوحدة orders​

في الوحدة orders اختر مستودع الطلبات (يفتح في علامة تبويب جديدة) المحدد والحالة (يفتح في علامة تبويب جديدة) التي يرتبط الحدث بتغيّرها.

شروط الوحدة users​

في الوحدة users اختر التصفية حسب مجموعات السمات (يفتح في علامة تبويب جديدة) وحدّد السمة التي يرتبط الحدث بتغيّرها.

عند إعداد الإرسال الجماعي يمكنك استخدام شروط خاصة:

  • today: يتحقق من أن التاريخ الحالي يطابق التاريخ في سمة المستخدم من النوع date أو dateTime.
  • now: يتحقق من أن الوقت الحالي (الساعات والدقائق) يطابق القيمة في السمة من النوع time أو dateTime.

طريقة الإرسال​

تتوفر لكل الوحدات، باستثناء forms، ثلاث طرق لإرسال الإشعار:

  1. Push Notification: عبر الإشعارات الفورية
  2. Email: عبر البريد الإلكتروني
  3. Socket IO: عبر WebSockets، وهي مناسبة للاشتراك في الأحداث في الوقت الفعلي، مثل تغيّر السعر. للتفاصيل، راجع وثائق Socket.IO.

المستلمون​

في الوحدة catalog يمكنك اختيار مستلمي الإشعار:

  • جميع مستخدمي أو تطبيقك،
  • أو مجموعة محددة من المستخدمين.

تكرار الإرسال​

لأحداث الوحدتين catalog وusers يمكنك اختيار عدد مرات الإرسال:

  • Once: عند وقوع الحدث،
  • Every time: في كل مرة يتكرر فيها إطلاق الحدث.

Attributes​

تحتوي علامة التبويب "Attributes" على قائمة منسدلة لاختيار مجموعة السمات (يفتح في علامة تبويب جديدة).

بعد اختيار مجموعة السمات، املأ القيم. على سبيل المثال:

  • event_send_date (من النوع Date and Time)
  • event_desc (من النوع String)

يمكنك استخدام هذه السمات في قالب الرسالة في علامة التبويب Settings، وهي متاحة عبر المفتاح event:

{{ event.attribute_marker }}

السمة timeInterval لجدولة الإرسال الجماعي**
إذا احتوت مجموعة السمات المختارة على سمة من النوع timeInterval، يمكنك اختيارها في إعدادات جدولة الإرسال الجماعي (الوضع Mailing).
عند اختيار هذه السمة، يُرسَل البريد الجماعي في الأيام المحددة في الفاصل الزمني فقط (مثلًا أيام الاثنين والجمعة فقط).

Settings​

تحتوي علامة التبويب "Settings" على حقلين نصيين لقالب الرسالة التي يتلقاها مستخدمو أو تطبيقك.

المتغيرات المتاحة

تظهر أسفل الحقول قائمة بالمتغيرات التي يمكن إدراجها في القالب (مثل {{ email }} و{{ user.attribute_marker }} وغيرها).

الإرسال الجماعي للمستخدمين (الوضع Mailing)​

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

إعداد الإرسال الجماعي​

  1. أنشئ الحدث

    • نوع الحدث: Users
    • وضع العمل: Mailing (الإرسال الجماعي)

  2. أعدّ الجدول الزمني

    • Time: نقطة البدء (مثلًا الاثنين الساعة 10:00)
    • Frequency:
      • Daily
      • Weekly
      • Monthly
      • Custom interval
      • من السمة timeInterval: إذا كانت هذه السمة موجودة في مجموعة السمات، يمكنك اختيارها، فيُرسَل البريد الجماعي في أيام الأسبوع المحددة فيها فقط.

  3. حدّد شروط اختيار المستخدمين

    • أمثلة:
      • تاريخ التسجيل > 2024-01-01
      • الاشتراك في الرسائل البريدية = true
      • today: التاريخ الحالي = قيمة السمة date/dateTime لدى المستخدم
      • now: الوقت الحالي (سس:دد) = قيمة السمة time/dateTime لدى المستخدم

مثال​

  • الإعداد:

    • Time: كل اثنين الساعة 10:00
    • Frequency: من السمة timeInterval (اختار المستخدم «الاثنين، الأربعاء، الجمعة»)
    • الشروط:
      • الاشتراك = true
      • today: user.birthday_date = اليوم

  • النتيجة:
    كل اثنين الساعة 10:00 يقوم النظام بما يلي:

    1. يبحث عن المستخدمين ذوي الاشتراك النشط الذين يصادف اليوم عيد ميلادهم
    2. يتحقق مما إذا كان اليوم الحالي (الاثنين) ضمن timeInterval الخاص بهم
    3. يرسل إليهم تهنئة مخصصة

أمثلة على إعداد الأحداث​

فيما يلي أمثلة على إعداد الأحداث لكل وحدة من الوحدات الست المتاحة.

الكتالوج​

النماذج​

الخصومات​

الطلبات​

المدفوعات​

المستخدمون​

آخر تحديث في