قنوات التسليم
يرسل tikento الإشعارات عبر قناتين:
البريد الإلكتروني
القناة الرئيسية لجميع أنواع الإشعارات. تُرسل الرسائل على العنوان الذي أدخله المشارك عند التسجيل (حقل registrant_email). يتلقى المنظم الإشعارات على البريد الإلكتروني المرتبط بالحساب.
الإمكانيات:
- قوالب HTML بشعار وألوان العلامة التجارية للمؤسسة (Pro وأعلى)
- قوالب متعددة اللغات عبر i18n-service (7 لغات)
- تتبع التسليم والفتح والنقرات
- إعداد DKIM للإرسال باسم نطاقك (Business وأعلى)
Telegram
إشعارات فورية عبر البوت @tikento_bot. تعمل للمستخدمين المصادقين عبر Telegram أو الذين ربطوا حساب Telegram في الإعدادات.
الإمكانيات:
- تسليم فوري عبر Telegram API
- أزرار مضمّنة للإجراءات السريعة (فتح التذكرة، الانتقال للفعالية)
- دعم التنسيق والروابط
أنواع الإشعارات
تأكيد التسجيل
يُرسل للمشارك مباشرة بعد التسجيل الناجح. يتضمن:
- اسم الفعالية والتاريخ والمكان
- رقم التسجيل
- رمز QR للتذكرة (إن كان قابلاً للتطبيق)
- رابط لصفحة التسجيل
إيصال الدفع
يُرسل بعد الدفع الناجح. يتضمن:
- المبلغ وطريقة الدفع
- اسم التذكرة والخيارات
- رقم المعاملة
- رابط الإيصال
التذكير بالفعالية
تذكير تلقائي قبل 24 ساعة من بدء الفعالية. يتضمن:
- تاريخ ووقت البدء
- العنوان أو رابط البث المباشر
- تذكير بالتحضير (إن أعدّه المنظم)
التغييرات في الفعالية
يُرسل لجميع المشاركين المسجلين عند تغيير معلمات رئيسية للفعالية:
- تغيير التاريخ أو الوقت
- تغيير مكان الإقامة
- إلغاء الفعالية
إشعارات الفريق
إشعارات داخلية للمنظمين وأعضاء الفريق:
- تسجيل جديد
- دفع جديد
- استرداد أموال
- اقتراب من حد المشاركين
معالجة الطابور
تُعالج جميع الإشعارات بشكل غير متزامن عبر طابور BullMQ في notifications-service. هذا يضمن:
- الموثوقية — عند عدم توفر قناة التسليم مؤقتاً ستُرسل الرسالة مجدداً
- قابلية التوسع — الأحمال العالية (إرسال جماعي، بدء فعالية شعبية) لا تؤثر على عمل التطبيق الرئيسي
- تحديد الأولويات — الإشعارات المعاملاتية (تأكيد الدفع) تُعالج بأولوية عالية، التسويقية بأولوية عادية
تتم إعادة محاولات الإرسال تلقائياً: 3 محاولات بتأخير أسي (10 ث، 30 ث، 90 ث).
تتبع التسليم
تُعرض حالة كل إشعار في قسم الفعالية -> الإشعارات -> سجل التسليم:
| الحالة | المعنى |
|---|---|
| مُرسل | تم تمرير الرسالة للمزود (خدمة البريد أو Telegram API) |
| مُسلَّم | تم تأكيد التسليم (البريد الإلكتروني) |
| مفتوح | المستلم فتح الرسالة (البريد الإلكتروني فقط، عند تفعيل التتبع) |
| مرفوض | رفض خادم المستلم الرسالة (bounce) |
| خطأ | خطأ تقني عند الإرسال |
يُحفظ سجل التسليم لمدة 90 يوماً ويمكن تصفيته حسب القناة والحالة والتاريخ.
الحدود حسب الخطة
قيود على عدد إشعارات البريد الإلكتروني شهرياً:
| الخطة | بريد إلكتروني / شهر |
|---|---|
| Free | 500 |
| Pro | 5,000 |
| Business | 50,000 |
| Enterprise | بدون قيود |
إشعارات Telegram ليس لها حدود على جميع الخطط.
عند الاقتراب من الحد (80% و95%) يتلقى المنظم تحذيراً. بعد استنفاد الحد تُوقف إشعارات البريد الإلكتروني التلقائية حتى بداية فترة الحساب التالية. تستمر الإشعارات المعاملاتية (تأكيد الدفع، الإيصالات) في الإرسال.