Сізге 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 | Қадағалау және қайтарылған хаттарды өңдеу |
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 кілтінің орнына осы доменге бекітілген жіберу кілтін пайдаланыңыз. Жіберу кілті тек хат жібере алады; жеке кілт журналдарыңызды оқи алады және тіркелгіңізді өзгерте алады. Бізге екіншісін сақтаудың ешқандай қажеттілігі жоқ.
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. Сынақты жіберіңіз және кодты енгізіңіз
Басқа домендегі кіріс жәшігін пайдаланып, Send test message түймесін басыңыз — Gmail мекенжайы өте қолайлы. Сол кіріс жәшігінен кодты оқып, оны енгізіңіз. Поштаңыз дереу ауысады.
Мәселелер туындаған кезде
401 Unauthorized — қате аймақ (жоғарыдан қараңыз) немесе басқа Mailgun тіркелгісінің кілтін қойдыңыз. Кілтті қайта тергеннен гөрі қайта жасақтаңыз; бастапқы key- префиксін оңай жоғалтып алуға болады.
Сынақ хабары мүлдем келмейді — Mailgun жүйесіндегі Logs бетін тексеріңіз. Егер Mailgun-да бұл туралы мүлдем жазба болмаса, сәйкестендіру дерегі немесе домен атауы қате. Егер Mailgun оны қабылдап, кейін қате орын алса, себебі сонда анық сөздермен жазылады және бұл әрдайым дерлік DNS мәселесі болады.
"Domain not found" — Mailgun sending domain өрісінде домен дәл Mailgun-да көрсетілгендей, соның ішінде ішкі доменмен бірге болуы керек. yourdomain.com және mail.yourdomain.com — Mailgun үшін екі түрлі домен.
Жұмыс істеп тұрып, содан кейін тоқтап қалды — тегін сынақ мерзіміңіздің аяқталғанын-аяқталмағанын тексеріңіз. Mailgun сынақ тіркелгілері тек рұқсат етілген алушыларға хат жібере алады, сондықтан өз мекенжайыңызға жіберілген сынақ хабары жұмыс істей береді, ал клиенттеріңізге жіберілгендердің барлығы дыбыссыз тоқтап қалады.