✉️ البريد الإلكتروني (IMAP / SMTP)
يستخدم PulseHub بروتوكول SMTP للإرسال وIMAP للاستقبال. هذا يعني أن PulseHub يعمل مع أي مزود بريد إلكتروني يوفر وصول IMAP/SMTP القياسي: Gmail، Outlook، Zoho، خادم البريد الخاص بك، Mailgun، إلخ.
المتطلبات الأساسية
- حساب بريد إلكتروني مع تمكين وصول IMAP
- بيانات اعتماد SMTP للإرسال
- بالنسبة لـ Gmail: يجب إنشاء كلمة مرور التطبيقات (وليس كلمة مرور Google العادية) إذا كانت المصادقة الثنائية مفعلة
خطوات الإعداد
1. إضافة القناة في PulseHub
انتقل إلى Channels → Add Channel، اختر Email، واملأ الحقول التالية:
| الحقل | الوصف |
|---|---|
| SMTP Host | مثال: smtp.gmail.com، mail.yourdomain.com |
| SMTP Port | 587 (STARTTLS) أو 465 (SSL) |
| SMTP Username | عادةً عنوان بريدك الإلكتروني الكامل |
| SMTP Password | كلمة مرور بريدك الإلكتروني أو كلمة مرور التطبيق |
| From Email | العنوان الذي يظهر كمرسل (يمكن أن يكون اسمًا مستعارًا) |
| IMAP Host | مثال: imap.gmail.com، mail.yourdomain.com |
| IMAP Port | 993 (SSL، موصى به) أو 143 (STARTTLS) |
2. تكوين Cron للبريد الوارد
على عكس القنوات الأخرى حيث يرسل المزودون webhooks إلى PulseHub، يعمل البريد الإلكتروني بالعكس: يقوم PulseHub باستطلاع صندوق الوارد عبر IMAP كل دقيقة باستخدام مهمة cron.
إذا كانت إضافة imap مفقودة:
- cPanel: انتقل إلى Select PHP Version → حدد مربع
imap→ حفظ - Plesk: انتقل إلى PHP Settings → Extensions → فعّل
imap - VPS: نفّذ
sudo apt install php-imap
إعداد Gmail
- فعّل IMAP في Gmail Settings → Forwarding and POP/IMAP → Enable IMAP
- إذا كانت المصادقة الثنائية مفعلة، أنشئ كلمة مرور تطبيق: Google Account → Security → App Passwords
- استخدم هذه الإعدادات:
| الحقل | القيمة |
|---|---|
| SMTP Host | smtp.gmail.com |
| SMTP Port | 587 |
| IMAP Host | imap.gmail.com |
| IMAP Port | 993 |
المشاكل الشائعة
| العرض | السبب المحتمل |
|---|---|
| لا يتم استيراد رسائل البريد | إضافة imap غير محملة أو بيانات اعتماد IMAP خاطئة |
| خطأ "SSL certificate" | جرّب المنفذ 143 مع /tls بدلاً من /ssl |
| الرسائل المرسلة لا تصل | mail() غير مكوّن على VPS — قم بإعداد MTA محلي |
| استيراد رسائل مكررة | منع التكرار عبر external_id = Message-ID يمنع التكرارات الحقيقية |