Танд Mailgun бүртгэл болон домэйнийхээ DNS-д хандах эрх шаардлагатай.
Mailgun-ий албан ёсны баримт бичиг: Домэйн нэмэх болон баталгаажуулах · API түлхүүрүүд · Бүртгүүлэх
1. Илгээх домэйноо Mailgun-д нэмэх
Mailgun-ий хянах самбарт Send → Domains → Add New Domain гэж ороод дэд домэйн оруулна уу, жишээ нь mail.yourdomain.com.
⚠️ Mailgun-ий өөрийнх нь өгдөг зөвлөмж бол дэд домэйн ашиглах явдал бөгөөд энэ нь зарим үйлчилгээ үзүүлэгчдээс илүү энд чухал юм: Mailgun таны оруулсан домэйнд өөрийн SPF болон DKIM бичлэгүүдийг тохируулдаг тул үүнийг үндсэн домэйн дээрээ заах нь эдгээр бичлэгүүд таны бизнесийн имэйл хайрцагнуудын ашигладаг бичлэгүүдтэй зэрэгцэн байрлана гэсэн үг юм.
Өөрийн өгөгдлийг байршуулахыг хүсэж буй бүсээ сонгоно уу — US эсвэл EU. Үүнийг тэмдэглэж аваарай; танд 4-р алхамд хэрэг болох ба энэ нь хамгийн түгээмэл гаргадаг алдаа юм.
2. Mailgun-аас өгсөн DNS бичлэгүүдийг нийтлэх
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 | Буцаалтыг хүлээн авах (Mailgun-ий хоёр MX хост) |
⛔ Хэрэв таны илгээх дэд домэйнд аль хэдийн SPF бичлэг байгаа бол түүнийг засна уу — хоёр дахийг нэмж болохгүй. Хоёр SPF TXT бичлэгтэй домэйн нь SPF-ийг шууд унагаадаг бөгөөд энэ нь огт бичлэггүй байхаас ч дор үр дагавартай.
Дараа нь Mailgun дээр Verify DNS Settings товчийг дарна уу. Ногоон болж баталгаажих хүртэл нэг цаг хүртэл хугацаа орж болно.
⭐ Та зөвхөн имэйл илгээж байгаа ч гэсэн MX бичлэгүүдийг заавал нэмээрэй. Тэдгээр нь Mailgun буцаалтуудыг цуглуулах арга юм. Тэдгээргүйгээр буруу хаяг нь хаашаа ч үгүй замхарч, Mailgun түүнийг дарах боломжгүй болох ба та хэзээ ч юу ч хүлээн авахгүй хаяг руу илгээхийн тулд мөнгө төлсөөр байх болно.
3. Өөрийн API түлхүүрийг авах
Send → Sending → Domain settings → API keys, эсвэл өөрийн бүртгэлийн API Keys хуудас руу орно уу.
Хэрэв таны багцад байгаа бол бүртгэлийнхээ хувийн API түлхүүрийн оронд зөвхөн энэ домэйнд зориулсан илгээх түлхүүр (sending key) ашиглаарай. Илгээх түлхүүр нь зөвхөн имэйл илгээх боломжтой; харин хувийн түлхүүр нь таны логуудыг уншиж, бүртгэлийг тань өөрчлөх боломжтой байдаг. Бидэнд хоёр дахь түлхүүрийг хадгалах ямар ч шаардлага байхгүй.
4. Үүнийг Zinn®-д холбох
Хянах самбараасаа Email sending хэсгийг нээгээд дараахыг бөглөнө үү:
- Provider — Mailgun
- Send from this domain —
mail.yourdomain.com (хаяг биш, домэйн байна)
- Mailgun sending domain — Mailgun дээр нэмсэнтэй яг ижил домэйн
- Region — 1-р алхамтай тохирох
us эсвэл eu
- Mailgun API key — 3-р алхмын түлхүүр
⛔⛔ Бүсээ зөв сонгоно уу. EU-д байрладаг Mailgun бүртгэлүүд нь огт өөр API хостоор үйлчлэгддэг. EU бүртгэлийн түлхүүрийг US хост руу илгээхэд "401 Unauthorized" гэсэн алдаа буцаадаг бөгөөд энэ нь яг буруу түлхүүр оруулсан мэт харагддаг. Хэрэв таны түлхүүр гарцаагүй зөв бөгөөд 401 алдаа аваад байгаа бол шалтгаан нь бараг үргэлж үүнээс болдог.
5. Тест илгээж, кодыг оруулах
Өөр домэйний имэйл хайрцгийг (Gmail хаяг хамгийн тохиромжтой) ашиглан Send test message товчийг дарна уу. Тэрхүү имэйл хайрцгаас кодыг уншиж, оруулна уу. Таны имэйл систем шууд шилжих болно.
Ажиллахгүй байгаа тохиолдолд
401 Unauthorized — буруу бүс (дээрээс харна уу), эсвэл өөр Mailgun бүртгэлийн түлхүүр хуулж тавьсан байна. Түлхүүрийг гараар дахин шивэхийн оронд шинээр үүсгээрэй; эхний key- хэсгийг гээхэд амархан байдаг.
Тест зурвас огт ирэхгүй байна — Mailgun-ий Logs хуудсыг шалгана уу. Хэрэв Mailgun дээр ямар ч тэмдэглэл байхгүй бол нэвтрэх мэдээлэл эсвэл домэйн нэр буруу байна. Хэрэв Mailgun үүнийг хүлээн аваад дараа нь амжилтгүй болсон бол шалтгааныг тодорхой бичсэн байх бөгөөд энэ нь бараг үргэлж DNS-ээс шалтгаалдаг.
"Domain not found" — Mailgun sending domain талбар нь дэд домэйнийг оруулаад Mailgun дээр бүртгэгдсэн домэйнтой яг таг тохирч байх ёстой. Mailgun-ий хувьд yourdomain.com болон mail.yourdomain.com нь хоёр өөр домэйн юм.
Ажиллаж байгаад гэнэт зогссон — туршилтын хугацаа дууссан эсэхийг шалгана уу. Mailgun туршилтын бүртгэлүүд нь зөвхөн зөвшөөрөгдсөн хүлээн авагчид (authorised recipients) руу илгээх боломжтой тул таны өөрийн хаяг руу илгээсэн тест зурвас ажилласаар байх боловч харилцагчид руу тань илгээсэн бүх зүйл ямар ч чимээгүйгээр очихгүй болдог.