ارسال ایمیل از طریق حساب کاربری Mailgun خودتان

شما به یک حساب کاربری Mailgun و دسترسی به DNS دامنه خود نیاز خواهید داشت.

مستندات خود Mailgun: افزودن و تأیید یک دامنه · کلیدهای API · ثبت‌نام

۱. دامنه ارسال خود را به Mailgun اضافه کنید

در داشبورد Mailgun به مسیر Send → Domains → Add New Domain بروید و یک زیردامنه، به عنوان مثال mail.yourdomain.com را وارد کنید.

⚠️ راهنمایی خود Mailgun استفاده از یک زیردامنه است و در اینجا این موضوع نسبت به برخی از ارائه‌دهندگان اهمیت بیشتری دارد: Mailgun رکوردهای SPF و DKIM خود را روی هر چیزی که به آن بدهید تنظیم می‌کند، و اشاره دادن آن به دامنه اصلی به این معناست که آن رکوردها در کنار رکوردهایی قرار می‌گیرند که صندوق‌های پستی کسب‌وکار شما به آن‌ها وابسته هستند.

منطقه‌ای را انتخاب کنید که با محل مورد نظر شما برای میزبانی داده‌ها مطابقت دارد — US یا EU. آن را یادداشت کنید؛ در مرحله ۴ به آن نیاز خواهید داشت و این رایج‌ترین موردی است که اشتباه انجام می‌شود.

۲. رکوردهای 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 کاملاً رد می‌شود، که این حالت از نداشتن هیچ رکوردی بدتر است.

سپس در Mailgun روی گزینه Verify DNS Settings کلیک کنید. سبز شدن وضعیت ممکن است تا یک ساعت طول بکشد.

⭐ رکوردهای MX را اضافه کنید، حتی اگر فقط در حال ارسال هستید. این رکوردها ابزاری هستند که Mailgun به کمک آن‌ها برگشت ایمیل‌ها را جمع‌آوری می‌کند. بدون آن‌ها، یک آدرس نامعتبر به هیچ کجا برنمی‌گردد، Mailgun نمی‌تواند آن را مسدود کند، و شما به پرداخت هزینه برای ارسال به آدرسی که هرگز چیزی دریافت نخواهد کرد، ادامه می‌دهید.

۳. کلید API خود را دریافت کنید

مسیر Send → Sending → Domain settings → API keys، یا صفحه API Keys حساب کاربری خود.

اگر پلن شما از آن پشتیبانی می‌کند، به جای کلید API خصوصی حساب خود، از یک کلید ارسال (sending key) محدود شده به این دامنه استفاده کنید. کلید ارسال فقط می‌تواند ارسال انجام دهد؛ اما کلید خصوصی می‌تواند لاگ‌های شما را بخواند و حساب شما را تغییر دهد. هیچ دلیلی وجود ندارد که ما کلید دوم را نگه داریم.

۴. آن را در Zinn® متصل کنید

بخش Email sending را در داشبورد خود باز کرده و موارد زیر را پر کنید:

• ارائه‌دهنده (Provider) — Mailgun
• ارسال از این دامنه (Send from this domain) — mail.yourdomain.com (یک دامنه، نه یک آدرس)
• دامنه ارسال Mailgun (Mailgun sending domain) — همان دامنه ای که در Mailgun اضافه کرده‌اید
• منطقه (Region) — مقدار us یا eu، مطابق با مرحله ۱
• کلید API متعلق به Mailgun (Mailgun API key) — کلید به دست آمده در مرحله ۳

⛔⛔ منطقه را به درستی انتخاب کنید. حساب‌های Mailgun میزبانی‌شده در EU از یک میزبان API کاملاً متفاوت سرویس می‌گیرند. ارسال کلید یک حساب مربوط به EU به میزبان US خطای *"401 Unauthorized"* را برمی‌گرداند — که دقیقاً شبیه به خطای کلید اشتباه به نظر می‌رسد. اگر کلید شما قطعاً درست است و خطای 401 دریافت می‌کنید، تقریباً همیشه دلیل آن همین است.

۵. تست را ارسال کرده و کد را وارد کنید

با استفاده از یک صندوق پستی روی دامنه‌ای دیگر (یک آدرس جیمیل ایده‌آل است) روی گزینه Send test message کلیک کنید. کد را از آن صندوق پستی بخوانید و وارد کنید. ایمیل‌های شما بلافاصله سوییچ می‌شوند.

زمانی که کار نمی‌کند

خطای 401 Unauthorized — منطقه اشتباه (به بالا مراجعه کنید)، یا اینکه کلید را از حساب دیگری در Mailgun کپی کرده‌اید. به جای تایپ مجدد کلید، آن را دوباره تولید (Regenerate) کنید؛ پیشوند key- به راحتی ممکن است از دست برود.

پیام تستی هرگز نمی‌رسد — صفحه Logs در Mailgun را بررسی کنید. اگر Mailgun هیچ سابقه ای از آن ثبت نکرده باشد، یعنی اطلاعات احراز هویت یا نام دامنه اشتباه است. اگر Mailgun آن را پذیرفته و پس از آن ناموفق بوده است، دلیل آن با کلمات ساده در آنجا وجود خواهد داشت و تقریباً همیشه مربوط به DNS است.

خطای "Domain not found" — فیلد Mailgun sending domain باید دقیقاً همان دامنه‌ای باشد که Mailgun آن را فهرست کرده است، شامل زیردامنه. yourdomain.com و mail.yourdomain.com از نظر Mailgun دو دامنه متفاوت هستند.

کار کرد و سپس متوقف شد — بررسی کنید که آیا دوره آزمایشی رایگان شما به پایان رسیده است یا خیر. حساب‌های آزمایشی Mailgun فقط می‌توانند به گیرندگان مجاز ارسال کنند، بنابراین پیام تستی به آدرس خودتان به کار کردن ادامه می‌دهد در حالی که تمام پیام‌ها به مشتریانتان بدون هیچ سر و صدایی ارسال نمی‌شوند.