إرسال البريد الإلكتروني عبر حساب Mailgun الخاص بك

ستحتاج إلى حساب Mailgun وإمكانية الوصول إلى نظام أسماء النطاقات (DNS) الخاص بنطاقك.

وثائق Mailgun الرسمية: Adding and verifying a domain · API keys · Sign up

1. أضف نطاق الإرسال الخاص بك إلى Mailgun

في لوحة تحكم Mailgun، انتقل إلى Send → Domains → Add New Domain وأدخل نطاقاً فرعياً، على سبيل المثال mail.yourdomain.com.

⚠️ إرشادات Mailgun الخاصة توصي بنطاق فرعي، وهو أمر أكثر أهمية هنا مقارنة ببعض المزودين الآخرين: يضبط Mailgun سجلات SPF وDKIM الخاصة به على أي نطاق تقدمه له، وتوجيهه إلى نطاقك الجذري يعني أن هذه السجلات ستكون جنباً إلى جنب مع السجلات التي تعتمد عليها صناديق بريد عملك.

اختر المنطقة التي تطابق المكان الذي ترغب في حفظ بياناتك فيه — US أو EU. دونها جانباً؛ فستحتاج إليها في الخطوة 4، وهي الخطأ الأكثر شيوعاً على الإطلاق.

2. انشر سجلات DNS التي يوفرها لك Mailgun

يعرض لك Mailgun قائمة. أضف كل سجل منها لدى مزود DNS الخاص بك.

⛔ إذا كان لنطاق الإرسال الفرعي الخاص بك سجل SPF بالفعل، فقم بتعديله — لا تضف سجلاً ثانياً. فأي نطاق يحتوي على سجلي TXT لـ SPF يفشل في التحقق من SPF تماماً، وهو أسوأ من عدم وجود أي سجل على الإطلاق.

بعد ذلك، اضغط على Verify DNS Settings في Mailgun. قد يستغرق الأمر ما يصل إلى ساعة ليتحول إلى اللون الأخضر.

⭐ أضف سجلات MX حتى لو كنت ترسل فقط. فهي الطريقة التي يجمع بها Mailgun الرسائل المرتدة. وبدونها، ترتد الرسالة المرسلة إلى عنوان خاطئ إلى المجهول، ولا يستطيع Mailgun حجبها، وتستمر في الدفع مقابل الإرسال إلى عنوان لن يستلم أي شيء على الإطلاق.

3. احصل على مفتاح API الخاص بك

Send → Sending → Domain settings → API keys، أو صفحة API Keys الخاصة بحسابك.

استخدم مفتاح إرسال مخصصاً لهذا النطاق إذا كانت خطتك توفر ذلك، بدلاً من مفتاح API الخاص بحسابك. فمفتاح الإرسال يمكنه الإرسال فقط؛ بينما يمكن للمفتاح الخاص قراءة سجلاتك وتعديل حسابك. وليس هناك سبب يدعونا للاحتفاظ بالمفتاح الثاني.

4. قم بربطه في Zinn®

افتح Email sending في لوحة التحكم الخاصة بك واملأ:

• Provider — Mailgun
• Send from this domain — mail.yourdomain.com (نطاق وليس عنواناً)
• Mailgun sending domain — النطاق نفسه الذي أضفته في Mailgun
• Region — us أو eu، بما يطابق الخطوة 1
• Mailgun API key — المفتاح من الخطوة 3

⛔⛔ تأكد من اختيار المنطقة الصحيحة. حسابات Mailgun المستضافة في EU تُخدم من مضيف API مختلف تماماً. وإرسال مفتاح حساب EU إلى مضيف US يعيد الخطأ "401 Unauthorized" — والذي يظهر تماماً وكأنه مفتاح غير صحيح. إذا كان مفتاحك صحيحاً بالتأكيد وكنت تواجه الخطأ 401، فهذا هو السبب في الغالب دائماً.

5. أرسل رسالة الاختبار وأدخل الرمز

اضغط على Send test message، باستخدام صندوق بريد على نطاق مختلف — عنوان Gmail يُعد مثالياً. اقرأ الرمز من صندوق البريد هذا وأدخله. سيتم تحويل بريدك على الفور.

عندما لا تنجح العملية

401 Unauthorized — منطقة غير صحيحة (راجع أعلاه)، أو أنك قمت بلصق مفتاح من حساب Mailgun مختلف. أعد إنشاء المفتاح بدلاً من إعادة كتابته يدوياً؛ فمن السهل أن تسقط بادئة key-.

رسالة الاختبار لا تصل أبداً — تحقق من صفحة Logs في Mailgun. إذا لم يكن لدى Mailgun أي سجل لها على الإطلاق، فإن بيانات الاعتماد أو اسم النطاق غير صحيح. وإذا قبلها Mailgun وفشلت بعد ذلك، فسيكون السبب مذكوراً هناك بكلمات واضحة، وغالباً ما يكون السبب هو DNS.

"Domain not found" — يجب أن يكون حقل Mailgun sending domain مطابقاً تماماً للنطاق كما يسرده Mailgun، بما في ذلك النطاق الفرعي. حيث يعد yourdomain.com وmail.yourdomain.com نطاقين مختلفين بالنسبة لـ Mailgun.

نجح الأمر في البداية ثم توقف — تحقق مما إذا كانت الفترة التجريبية المجانية قد انتهت. الحسابات التجريبية في Mailgun يمكنها الإرسال فقط إلى مستلمين معتمدين، لذا فإن رسالة الاختبار إلى عنوانك الخاص تستمر في العمل بينما يتوقف كل ما يتم إرساله إلى عملائك بصمت.