قاعدة المعرفة
أرسل البريد الإلكتروني عبر حساب Mailgun الخاص بك
اربط حساب Mailgun الخاص بك: إضافة نطاق فرعي للإرسال، وسجلات SPF و DKIM و MX للنشر، ومفتاح إرسال بدلاً من مفتاح API الخاص بك، وسبب إرجاع الحساب المستضاف في EU لخطأ 401 ضد المضيف US.
ستحتاج إلى حساب Mailgun وإمكانية الوصول إلى سجلات DNS الخاصة بنطاقك.
توثيق Mailgun الخاص: إضافة نطاق والتحقق منه · مفاتيح API · الاشتراك
1. أضف نطاق الإرسال الخاص بك إلى Mailgun
في لوحة تحكم Mailgun، انتقل إلى Send ← Domains ← Add New Domain وأدخل نطاقًا فرعيًا، على سبيل المثال mail.yourdomain.com.
⚠️ إرشادات Mailgun الخاصة توصي بنطاق فرعي، والأمر أكثر أهمية هنا مقارنة ببعض المزودين الآخرين: تحدد Mailgun سجلات SPF و DKIM الخاصة بها على أي نطاق تزودها به، وتوجيهها إلى نطاقك الرئيسي يعني أن تلك السجلات ستوجد جنباً إلى جنب مع السجلات التي تعتمد عليها صناديق بريد أعمالك.
اختر المنطقة التي تطابق المكان الذي ترغب في حفظ بياناتك فيه — US أو EU. قم بتدوينها؛ ستحتاج إليها في الخطوة 4، وهي الخطأ الأكثر شيوعًا على الإطلاق.
2. انشر سجلات DNS التي توفرها لك Mailgun
تعرض لك Mailgun قائمة. أضف كل سجل منها لدى مزود خدمة DNS الخاص بك.
| النوع | المضيف | الغرض | | --- | --- | --- | | TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all | | TXT | mailo._domainkey.mail.yourdomain.com | المفتاح العام لـ DKIM | | CNAME | email.mail.yourdomain.com | التتبع ومعالجة الرسائل المرتدة | | MX | mail.yourdomain.com | استقبال الرسائل المرتدة (مضيفا MX لـ Mailgun) |
⛔ إذا كان النطاق الفرعي للإرسال يحتوي بالفعل على سجل SPF، فقم بتعديله — ولا تضف سجلًا ثانياً. النطاق الذي يحتوي على سجلي TXT من نوع SPF يفشل في اختبار SPF تماماً، وهو أمر أسوأ من عدم وجود أي سجل.
ثم اضغط على Verify DNS Settings في Mailgun. قد يستغرق الأمر ما يصل إلى ساعة حتى يتحول إلى اللون الأخضر.
⭐ أضف سجلات MX حتى لو كنت تقوم بالإرسال فقط. فهي الطريقة التي تجمع بها Mailgun الرسائل المرتدة. وبدونها، ترتد الرسائل الموجهة إلى العناوين الخاطئة إلى لا مكان، ولا تتمكن Mailgun من حظرها، وستستمر في الدفع مقابل الإرسال إلى عنوان لن يستلم أي شيء أبدًا.
3. احصل على مفتاح API الخاص بك
Send ← Sending ← Domain settings ← API keys، أو صفحة API Keys الخاصة بحسابك.
استخدم مفتاح إرسال مخصصًا لهذا النطاق إذا كانت خطتك توفر ذلك، بدلاً من مفتاح API الخاص ببحسابك. مفتاح الإرسال يمكنه الإرسال فقط؛ بينما يمكن للمفتاح الخاص قراءة سجلاتك وتعديل حسابك. لا يوجد سبب يدعونا للاحتفاظ بالمفتاح الثاني.
4. قم بالربط في Zinn®
افتح إرسال البريد الإلكتروني في لوحة التحكم الخاصة بك وقم بملء البيانات التالية:
- المزود — Mailgun
- الإرسال من هذا النطاق —
mail.yourdomain.com(نطاق، وليس عنوان بريد) - نطاق إرسال Mailgun — النطاق نفسه الذي أضفته في Mailgun
- المنطقة —
usأوeu، بما يطابق الخطوة 1 - مفتاح API لـ Mailgun — المفتاح من الخطوة 3
⛔⛔ تأكد من اختيار المنطقة الصحيحة. حسابات Mailgun المستضافة في EU تُخدم من مضيف API مختلف تمامًا. إرسال مفتاح حساب EU إلى مضيف US يرجع الخطأ "401 Unauthorized" — والذي يُقرأ تمامًا كمفتاح خاطئ. إذا كان مفتاحك صحيحًا بالتأكيد وتتلقى الخطأ 401، فهذا هو السبب في الغالبية العظمى من الحالات.
5. أرسل رسالة الاختبار وأدخل الرمز
اضغط على إرسال رسالة اختبار، باستخدام صندوق وارد على نطاق مختلف — عنوان Gmail يُعد مثاليًا. اقرأ الرمز من صندوق الوارد ذلك وأدخله. سيتم تحويل البريد الإلكتروني الخاص بك على الفور.
عندما لا يعمل الأمر
401 Unauthorized — منطقة خاطئة (انظر أعلاه)، أو أنك قمت بلصق مفتاح من حساب Mailgun آخر. قم بإعادة إنشاء المفتاح بدلاً من إعادة كتابته؛ فمن السهل فقدان بادئة key-.
رسالة الاختبار لا تصل أبدًا — تحقق من صفحة Logs في Mailgun. إذا لم يكن لدى Mailgun أي سجل لها على الإطلاق، فإن بيانات الاعتماد أو اسم النطاق خاطئ. إذا قبلتها Mailgun وفشلت بعد ذلك، فسيكون السبب موضحًا هناك بكلمات واضحة، وغالبًا ما يكون بسبب DNS.
"Domain not found" — يجب أن يكون حقل نطاق إرسال Mailgun مطابقًا تمامًا للنطاق كما توضحه Mailgun، بما في ذلك النطاق الفرعي. يُعتبر yourdomain.com و mail.yourdomain.com نطاقين مختلفين بالنسبة لـ Mailgun.
عمل الأمر ثم توقف — تحقق مما إذا كانت الفترة التجريبية المجانية قد انتهت. يمكن لحسابات Mailgun التجريبية الإرسال فقط إلى مستلمين معتمدين، لذا تستمر رسالة الاختبار إلى عنوانك الخاص في العمل بينما يفشل كل شيء مرسل إلى عملائك بصمت.