قائمة الانتظار والعمال
تُظهر الإعدادات → متقدم → قائمة الانتظار والعمال برنامج تشغيل قائمة الانتظار الحالي ونوع الاتصال وحالة العمال لتثبيت LeadHub الخاص بك.
ماذا تفعل قائمة الانتظار
تعالج قائمة الانتظار جميع الأعمال الخلفية في LeadHub:
| المهمة | أولوية قائمة الانتظار |
|---|---|
| إرسال رسائل البريد الإلكتروني (معاملاتية، تسلسلات) | عالية |
| معالجة الـ webhooks الواردة من مصادر العملاء المحتملين | عالية |
| استدعاء واجهات برمجة التكاملات الصادرة (مزامنة CRM، Zapier، إلخ.) | افتراضية |
| تشغيل خطوات الأتمتة (التأخيرات، الإجراءات) | افتراضية |
| توليد التقارير والتصديرات | منخفضة |
| إرسال SMS / رسائل WhatsApp | افتراضية |
عند وصول عميل محتمل أو إطلاق أتمتة، يُضاف الإجراء إلى قائمة الانتظار بدلًا من تنفيذه بشكل متزامن. هذا يمنع استدعاءات API البطيئة من حجب طلب الويب.
برامج تشغيل قائمة الانتظار
| البرنامج | الوصف |
|---|---|
| ملف (قاعدة البيانات) | الافتراضي. تُخزَّن المهام في جدول قاعدة البيانات jobs. تتم معالجتها بمهمة cron. لا يلزم Redis أو Supervisor. |
| Redis | قائمة انتظار أسرع في الذاكرة. يتطلب Redis وSupervisor (أو Horizon) على الخادم. موصى به للتثبيتات عالية الحجم. |
| متزامن | ينفذ المهام فورًا في العملية. يُستخدم فقط في بيئات الاختبار. لا تستخدمه في الإنتاج. |
الاستضافة المشتركة: تعمل قائمة الانتظار الافتراضية المستندة إلى الملفات في LeadHub على أي خطة استضافة مشتركة مع مهمة cron. لا تحتاج إلى Redis أو Supervisor أو وصول SSH.
معالجة قائمة الانتظار (مهمة Cron)
تتم معالجة قائمة الانتظار بمهمة cron واحدة يجب تهيئتها على خادمك.
استضافة cPanel المشتركة
- سجّل الدخول إلى cPanel → مهام Cron.
- عيّن الجدول الزمني على كل دقيقة (
* * * * *). - عيّن الأمر على:
استبدل المسار بالمسار المطلق لتثبيت LeadHub الخاص بك.
php /home/yourusername/public_html/cron.php >> /dev/null 2>&1
راجع دليل الاستضافة المشتركة للتعليمات الكاملة لـ cPanel.
VPS / خادم مخصص (Linux crontab)
* * * * * cd /var/www/leadhub && php artisan queue:work --once --max-time=55 >> /dev/null 2>&1
أو باستخدام مدير عمليات (Supervisor):
[program:leadhub-worker]
command=php /var/www/leadhub/artisan queue:work --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
user=www-data
صفحة حالة العمال
تُظهر صفحة قائمة الانتظار والعمال في لوحة التحكم:
| المعلومات | الوصف |
|---|---|
| الاتصال | اسم اتصال قائمة الانتظار الحالي (من config/queue.php) |
| البرنامج | برنامج تشغيل قائمة الانتظار المستخدم (database، redis، sync) |
| Horizon | ما إذا كان Laravel Horizon مثبتًا (للمراقبة المتقدمة المستندة إلى Redis) |
هذه الصفحة للقراءة فقط. لتغيير برنامج تشغيل قائمة الانتظار، حدّث
QUEUE_CONNECTIONفي ملف.envالخاص بك.
المهام الفاشلة
إذا فشلت مهمة مُضافة إلى قائمة الانتظار (مثلًا عندما يُرجع API تكامل خطأ)، يُعيد LeadHub المحاولة حتى 3 مرات مع تراجع أسي. بعد 3 فشل، تُوسَم المهمة كفاشلة.
التحقق من صحة قائمة الانتظار
علامات على أن عامل قائمة الانتظار يعمل بشكل صحيح:
- تُطلق الأتمتة في غضون دقائق قليلة من الحدث
- تُطلق التكاملات الصادرة بعد وقت قصير من وصول عميل محتمل
- تُرسل تسلسلات البريد الإلكتروني في الموعد المحدد
- تكتمل التصديرات وتصبح قابلة للتنزيل
علامات على أن قائمة الانتظار لا تعمل:
- الأتمتة لا تُطلق أبدًا
- مزامنات التكامل عالقة كـ"معلقة"
- لا تُرسل رسائل البريد الإلكتروني أبدًا
الإصلاح: تحقق من تهيئة مهمة cron وتشغيلها. استخدم cPanel → مهام Cron للتحقق من وجود الإدخال وصحة المسار.