תזדקקו לחשבון 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 שלכם.
| סוג | מארח | מטרה |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | מפתח DKIM ציבורי |
CNAME | email.mail.yourdomain.com | מעקב וטיפול בהודעות שחזרו (bounces) |
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 בחשבונכם.
השתמשו ב-sending key המוגבל לדומיין זה אם התוכנית שלכם כוללת כזה, במקום במפתח ה-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 מציג אותו, כולל תת-הדומיין. מבחינת Mailgun, yourdomain.com ו-mail.yourdomain.com הם שני דומיינים שונים.
זה עבד ואז הפסיק — בדקו אם תקופת הניסיון בחינם שלכם הסתיימה. חשבונות ניסיון ב-Mailgun יכולים לשלוח אך ורק אל נמענים מורשים, ולכן הודעת הבדיקה לכתובת שלכם ממשיכה לעבוד בעוד שכל ההודעות ללקוחות שלכם אינן נשלחות מבלי שתוצג הודעה על כך.