ستحتاج إلى حساب AWS وإمكانية الوصول إلى نظام أسماء النطاقات (DNS) الخاص بنطاقك. تُعد SES الخيار الأرخص في هذه القائمة بفارق كبير، ولكنها الأكثر تطلباً للخطوات.
وثائق Amazon الخاصة: التحقق من نطاق · الحصول على بيانات اعتماد SMTP · الخروج من البيئة التجريبية (sandbox)
⭐ نحن نتصل بـ SES عبر واجهة SMTP الخاصة بها، وليس عبر REST API. لهذا السبب يُطلب منك اسم مستخدم وكلمة مرور SMTP بدلاً من مفتاح وصول AWS. يوفر كلا المسارين الرسالة نفسها تماماً؛ ويتجنب مسار SMTP فئة كاملة من مشكلات توقيع طلبات AWS التي يصعب تشخيصها من الخارج، وهي الواجهة التي تنشر Amazon بيانات الاعتماد لها خصيصاً لتتمكن أدوات مثل أدواتنا من استخدامها.
1. اختر منطقة والتزم بها
إن SES خدمة إقليمية. كل شيء أدناه — نطاقك المتحقق منه، وبيانات اعتمادك، وحصة الإرسال الخاصة بك — ينتمي إلى منطقة AWS واحدة ولا وجود له في أي منطقة أخرى.
اختر المنطقة الأقرب إلى عملائك (eu-west-1 لأوروبا، وus-east-1 لأمريكا الشمالية) ودونها. إن التحقق من نطاقك في أيرلندا ثم إنشاء بيانات الاعتماد في فرانكفورت هو أكثر الطرق شيوعاً لإضاعة الوقت هنا، والخطأ الناتج عن ذلك لا يذكر أي شيء عن المناطق.
2. تحقق من نطاقك
Amazon SES console ← Identities ← Create identity ← Domain. أدخل نطاقاً فرعياً مثل mail.yourdomain.com.
قم بتفعيل Easy DKIM واختر RSA_2048_BIT. تمنحك SES ثلاثة سجلات CNAME:
| Type | Host |
|---|
CNAME | <token1>._domainkey.mail.yourdomain.com |
CNAME | <token2>._domainkey.mail.yourdomain.com |
CNAME | <token3>._domainkey.mail.yourdomain.com |
أضف السجلات الثلاثة جميعها. يكتمل التحقق عادةً في غضون ساعة.
⭐ قم أيضاً بتمكين نطاق MAIL FROM مخصص (bounce.mail.yourdomain.com) وأضف سجلي MX وSPF TXT اللذين يطلبهما. من دونه، يكون مرسل الغلاف الخاص بك هو amazonses.com، وبالتالي تتوافق SPF مع Amazon بدلاً منك، وتصبح معتمداً على DKIM وحده.
3. اخرج من البيئة التجريبية (sandbox) — هذه هي الخطوة التي يتغاضى عنها الكثيرون
⛔⛔ حساب SES الجديد يكون داخل بيئة تجريبية (sandbox) ولا يمكنه الإرسال إلا إلى العناوين التي تحققت منها بشكل منفصل. وسيقبل كل شيء آخر دون تسليم أي منه.
هذا هو الفشل ذاته الذي وُجدت خطوة التحقق لدينا لاكتشافه: في البيئة التجريبية، تستقبل SES رسالتك مع استجابة نجاح عادية تماماً ثم تتجاهلها بعد ذلك. إذا تحققت من إعدادنا عن طريق إرسال الاختبار إلى عنوان تصادف أنك تحققت منه في AWS، فسيعمل — وبعد ذلك ستتلاشى كل رسالة موجهة إلى عميل حقيقي.
Account dashboard ← Request production access. تسأل Amazon عن طبيعة ما ترسله وكيفية تعاملك مع الرسائل المرتدة؛ وتتم الموافقة عادةً في غضون 24 ساعة بناءً على جملتين صادقتين حول الإشعارات المعاملاتية المرسلة إلى عملائك.
⭐ قم بذلك قبل توصيل SES هنا. فلن يكون هناك ما يمكن استكشاف أخطائه وإصلاحه لاحقاً، نظراً لعدم ظهور أي فشل.
4. أنشئ بيانات اعتماد SMTP
SES console ← SMTP settings ← Create SMTP credentials.
يؤدي هذا إلى إنشاء مستخدم IAM بإذن إرسال فقط، ويمنحك اسم مستخدم SMTP وكلمة مرور SMTP.
⛔ هذه ليست مفتاح وصول AWS والمفتاح السري الخاصين بك. بل تُشتق من المفتاح السري لـ IAM بواسطة خوارزمية محددة ولا يمكن التبديل بينهما. سيؤدي لصق مفتاح وصول AWS السري هنا إلى فشل المصادقة في كل مرة، وسينص الخطأ ببساطة على أنه تم رفض بيانات الاعتماد.
⚠️ تُعرض كلمة المرور لمرة واحدة فقط. قم بتنزيل ملف CSV قبل مغادرة الصفحة.
5. اربطها في Zinn®
افتح Email sending في لوحة التحكم الخاصة بك:
- Provider — Amazon SES
- Send from this domain —
mail.yourdomain.com
- AWS region — المنطقة من الخطوة 1، مثل
eu-west-1
- SMTP username — من الخطوة 4
- Port — اتركه على 587
- SES SMTP password — من الخطوة 4
نحن نقوم بإنشاء المضيف نيابة عنك (email-smtp.<region>.amazonaws.com)، لذلك لن تخطئ في كتابة اسم المضيف.
6. أرسل الاختبار وأدخل الرمز
اضغط على Send test message إلى صندوق وارد على نطاق مختلف لم تتحقق منه في AWS — ويُعد عنوان Gmail الشخصي مثالياً، لأنه العنوان الذي يثبت خروجك من البيئة التجريبية. اقرأ الرمز وأدخله.
عندما لا تنجح العملية
"Email address is not verified" أثناء الإرسال إلى عميل حقيقي — ما زلت في البيئة التجريبية. راجع الخطوة 3.
535 Authentication Credentials Invalid — لقد استخدمت مفتاح وصول AWS بدلاً من بيانات اعتماد SMTP (الخطوة 4)، أو أن بيانات الاعتماد تنتمي إلى منطقة مختلفة عن تلك التي أدخلتها.
"Maximum sending rate exceeded" — يبدأ حساب الإنتاج الجديد بمعدل 14 رسالة في الثانية و50,000 رسالة يومياً. هذا عدد هائل من الإشعارات، ولكن إذا كنت بصدد ترحيل قاعدة عملاء كبيرة، فاطلب زيادة الحصة أولاً.
نجح الأمر في الاختبار وتوقف في مرحلة الإنتاج — تحقق من لوحة تحكم Reputation في SES. توقف Amazon الإرسال تلقائياً عندما يتجاوز معدل الارتداد أو الشكاوى الحد المسموح به، ومن السهل تجاوزه مع قوائم العملاء القديمة.