شما به یک حساب 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 | ردیابی و مدیریت ایمیلهای برگشتی (Bounce) |
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 با دسترسی محدود به این دامنه استفاده کنید. یک sending key فقط میتواند ارسال کند؛ کلید خصوصی میتواند گزارشهای شما را بخواند و حسابتان را تغییر دهد. دلیلی ندارد که ما مورد دوم را در اختیار داشته باشیم.
۴. آن را در Zinn® متصل کنید
بخش Email sending را در پیشخوان خود باز کرده و موارد زیر را تکمیل کنید:
- ارائهدهنده — Mailgun
- ارسال از این دامنه —
mail.yourdomain.com (یک دامنه، نه یک نشانی)
- دامنه ارسال Mailgun — همان دامنهای که در Mailgun اضافه کردهاید
- منطقه —
us یا eu، مطابق با مرحله ۱
- کلید API مربوط به Mailgun — کلید بهدستآمده از مرحله ۳
⛔⛔ منطقه را بهدرستی وارد کنید. حسابهای Mailgun میزبانیشده در EU از یک هاست API کاملاً متفاوت سرویسدهی میشوند. ارسال کلید یک حساب EU به هاست US خطای "401 Unauthorized" را برمیگرداند — که دقیقاً شبیه به یک کلید اشتباه به نظر میرسد. اگر از درستی کلید خود اطمینان کامل دارید و خطای 401 دریافت میکنید، علت تقریباً همیشه همین است.
۵. ارسال پیام آزمایشی و وارد کردن کد
روی 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 فقط میتوانند به گیرندگان مجاز ایمیل ارسال کنند، بنابراین پیام آزمایشی به نشانی خود شما همچنان ارسال میشود، در حالی که همه پیامها به مشتریانتان بدون هیچ هشداری ارسال نمیشوند.