מאגר ידע

שלח דוא"ל דרך חשבון Mailgun משלך

חבר את חשבון ה-Mailgun שלך: הוספת תת-דומיין לשליחה, רשומות ה-SPF, ה-DKIM וה-MX לפרסום, מפתח שליחה במקום מפתח ה-API הפרטי שלך, ומדוע חשבון המתארח ב-EU מחזיר שגיאת 401 מול השרת ב-US.

תזדקקו לחשבון Mailgun ולגישה ל-DNS של הדומיין שלכם.

התיעוד הרשמי של Mailgun: הוספה ואימות של דומיין · מפתחות API · הרשמה

1. הוספת דומיין השליחה שלכם ל-Mailgun

בלוח הבקרה של Mailgun עברו אל Send → Domains → Add New Domain והזינו תת-דומיין (subdomain), לדוגמה mail.yourdomain.com.

⚠️ ההנחיה הרשמית של Mailgun היא להשתמש בתת-דומיין, והדבר חשוב כאן יותר מאשר אצל ספקים אחרים: Mailgun מגדירה רשומות SPF ו-DKIM משלה עבור כל מה שתספקו לה, והצבעה על הדומיין הראשי שלכם משמעותבה רשומות אלו יושבות לצד הרשומות שעליהן נשענות תיבות הדואר העסקיות שלכם.

בחרו את האזור הגאוגרפי התואם למיקום שבו תרצו שהנתונים שלכם יישמרו — US או EU. רשמו אותו לעצמכם; תזדקקו לו בשלב 4, וזו הטעות הנפוצה ביותר.

2. פרסום רשומות ה-DNS ש-Mailgun מספקת

Mailgun מציגה לכם רשימה. הוסיפו כל אחת מהן אצל ספק ה-DNS שלכם.

| סוג (Type) | מארח (Host) | מטרה (Purpose) | | --- | --- | --- | | 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, ערכו אותה — אל תוסיפו רשומת שנייה. דומיין עם שתי רשומות SPF מסוג TXT ייכשל לחלוטין בבדיקת 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 domainmail.yourdomain.com (דומיין, לא כתובת)
  • Mailgun sending domain — אותו דומיין שהוספתם ב-Mailgun
  • Regionus או 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 יכולים לשלוח רק אל נמענים מורשים, כך שודעת הבדיקה לכתובת שלכם ממשיכה לעבוד בזמן שכל השליחות ללקוחותיכם מפסיקות לעבוד בשקט.

עדיין תקועים?

התמיכה כלולה בכל תוכנית והמענים ניתנים בשפה שלך.

צור קשר עם התמיכה כל המאמרים