Ձեզ անհրաժեշտ կլինի Mailgun-ի հաշիվ և հասանելիություն Ձեր դոմեյնի DNS-ին:
Mailgun-ի պաշտոնական փաստաթղթերը՝ Adding and verifying a domain · API keys · Sign up
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 էջը:
Օգտագործեք այս դոմեյնի համար նախատեսված ուղարկման բանալի (sending key), եթե Ձեր սակագնային պլանն առաջարկում է այն, այլ ոչ թե Ձեր հաշվի անձնական API բանալին: Ուղարկման բանալին կարող է միայն ուղարկել. անձնական բանալին կարող է կարդալ Ձեր մատյանները (logs) և փոփոխել Ձեր հաշիվը: Մեզ համար երկրորդը պահելու ոչ մի պատճառ չկա:
4. Միացրեք այն Zinn®-ում
Ձեր կառավարման վահանակում բացեք Email sending բաժինը և լրացրեք.
- Provider — Mailgun
- Send from this domain —
mail.yourdomain.com (դոմեյն, այլ ոչ թե հասցե)
- Mailgun sending domain — նույն դոմեյնը, որն ավելացրել եք Mailgun-ում
- Region —
us կամ eu, համապատասխան 1-ին քայլին
- 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-ի փորձնական հաշիվները կարող են ուղարկել միայն լիազորված ստացողներին, այնպես որ Ձեր սեփական հասցեին ուղարկվող թեստային հաղորդագրությունը շարունակում է աշխատել, մինչդեռ Ձեր հաճախորդներին ուղղված ամեն ինչ լուռ ձախողվում է: