إعداد البريد الإلكتروني / SMTP
يرسل FeedbackPulse رسائل بريد إلكتروني تحويلية متعددة. يُعدّ إعداد البريد الإلكتروني بشكل صحيح أمرًا مهمًا لـ:
- رسائل الترحيب للمستأجرين الجدد
- روابط دعوة فريق العمل
- رسائل إعادة تعيين كلمة المرور
- التحقق عبر رمز OTP (لنماذج التعليقات)
- الملخصات اليومية/الأسبوعية
- التقارير المجدولة
- تنبيهات الاستخدام
- إشعارات تغيير الخطة
⚙️ طرق الإعداد
الطريقة الأولى: عبر لوحة الإدارة (موصى بها)
- سجّل الدخول بصفتك مشرفًا عامًا
- انتقل إلى الإدارة ← الإعدادات ← البريد الإلكتروني
- أدخل تفاصيل SMTP الخاصة بك
- انقر على إرسال بريد اختباري للتحقق
- احفظ الإعدادات
الطريقة الثانية: عبر ملف .env
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
MAIL_USERNAME=your_username
MAIL_PASSWORD=your_password
MAIL_ENCRYPTION=tls
[email protected]
MAIL_FROM_NAME="FeedbackPulse"
📮 إعداد كل مزود خدمة
📧 Gmail
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your_app_password
MAIL_ENCRYPTION=tls
⚠️ مهم: يتطلب Gmail كلمة مرور التطبيق، وليس كلمة المرور العادية.
- انتقل إلى أمان حساب Google
- فعّل التحقق بخطوتين (مطلوب)
- انتقل إلى كلمات مرور التطبيقات ← اختر "Mail" ← أنشئها
- استخدم كلمة المرور المكونة من 16 حرفًا التي تم إنشاؤها
🔴 حدود Gmail: 500 رسالة/يوم (شخصي) أو 2,000/يوم (Workspace). غير موصى به للإنتاج.
🔫 Mailgun
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your_mailgun_smtp_password
MAIL_ENCRYPTION=tls
- سجّل في Mailgun
- أضف نطاقك ← تحقق من سجلات DNS
- انتقل إلى Sending ← Domain Settings ← SMTP credentials
- انسخ كلمة مرور SMTP
📦 Amazon SES
MAIL_HOST=email-smtp.us-east-1.amazonaws.com
MAIL_PORT=587
MAIL_USERNAME=your_ses_smtp_username
MAIL_PASSWORD=your_ses_smtp_password
MAIL_ENCRYPTION=tls
- انتقل إلى AWS SES Console
- تحقق من نطاقك
- انتقل إلى SMTP Settings ← Create SMTP Credentials
- اخرج من وضع sandbox للإنتاج
📨 SendGrid
MAIL_HOST=smtp.sendgrid.net
MAIL_PORT=587
MAIL_USERNAME=apikey
MAIL_PASSWORD=your_sendgrid_api_key
MAIL_ENCRYPTION=tls
💡 ملاحظة: اسم المستخدم هو
apikeyحرفيًا (وليس بريدك الإلكتروني). كلمة المرور هي مفتاح API الخاص بـ SendGrid.
✉️ Postmark
MAIL_HOST=smtp.postmarkapp.com
MAIL_PORT=587
MAIL_USERNAME=your_postmark_server_api_token
MAIL_PASSWORD=your_postmark_server_api_token
MAIL_ENCRYPTION=tls
🔵 ZOHO Mail
MAIL_HOST=smtp.zoho.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your_zoho_password
MAIL_ENCRYPTION=tls
🧪 Mailtrap (للاختبار فقط!)
MAIL_HOST=sandbox.smtp.mailtrap.io
MAIL_PORT=587
MAIL_USERNAME=your_mailtrap_username
MAIL_PASSWORD=your_mailtrap_password
MAIL_ENCRYPTION=tls
⚠️ Mailtrap مخصص للتطوير/الاختبار فقط. يتم التقاط الرسائل في صندوق وارد Mailtrap ولا يتم تسليمها إلى مستلمين حقيقيين.
🧪 اختبار البريد الإلكتروني
عبر لوحة الإدارة
- انتقل إلى الإدارة ← الإعدادات ← البريد الإلكتروني
- انقر على إرسال بريد اختباري
- تحقق من صندوق الوارد
عبر سطر الأوامر
php artisan tinker
Mail::raw('Test email from FeedbackPulse', function ($message) {
$message->to('[email protected]')->subject('SMTP Test');
});
📨 رسائل البريد المُرسلة بواسطة FeedbackPulse
| الرسالة | متى يُرسل | المستلم |
|---|---|---|
| ترحيب | تسجيل مستأجر جديد | مشرف المستأجر |
| دعوة فريق العمل | يدعو المشرف عضوًا في الفريق | البريد الإلكتروني للمدعو |
| تغيير الخطة | تغييرات الاشتراك | مشرف المستأجر |
| تنبيه تقديم جديد | استلام ملاحظات جديدة | مشرف/موظف المستأجر |
| ملخص البريد | جدول يومي/أسبوعي | مشرف المستأجر |
| تقرير مجدول | يومي/أسبوعي/شهري | مشرف المستأجر |
| تنبيه الاستخدام | 90%+ من حد الخطة | مشرف المستأجر |
| إعادة تعيين كلمة المرور | يطلب المستخدم إعادة التعيين | المستخدم الطالب |
| التحقق من البريد | تسجيل جديد | المستخدم الجديد |
| رمز OTP | نموذج تعليقات مع OTP | المستخدم النهائي الذي يقدم تعليقات |
🐛 استكشاف أخطاء البريد الإلكتروني وإصلاحها
| المشكلة | الحل |
|---|---|
| عدم إرسال الرسائل | تحقق من إعدادات SMTP في .env. جرّب MAIL_MAILER=log للاختبار بدون SMTP. تحقق من storage/logs/laravel.log. |
| الرسائل تصل إلى مجلد الرسائل غير المرغوب فيها | أضف سجلات SPF وDKIM وDMARC إلى DNS الخاص بنطاقك. استخدم مزود SMTP موثوقًا. |
| "انتهت مهلة الاتصال" | قد يكون المنفذ 587/465 محجوبًا من مزود الاستضافة. جرّب منفذًا مختلفًا أو مزودًا آخر. |
| خطأ Gmail "التطبيقات الأقل أمانًا" | استخدم كلمة مرور التطبيق عوضًا عن ذلك. راجع قسم Gmail أعلاه. |
| تأخر الرسائل | إذا كنت تستخدم QUEUE_CONNECTION=database، فتأكد من تشغيل عامل قائمة الانتظار. |