დაგჭირდებათ 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 პროვაიდერთან.
| Type | Host | Purpose |
|---|
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 | bounce-ების მიღება (Mailgun-ის ორი MX ჰოსტი) |
⛔ თუ თქვენს გამგზავნ ქვედომენს უკვე აქვს SPF ჩანაწერი, ჩაასწორეთ იგი — არ დაამატოთ მეორე. დომენი ორი SPF TXT ჩანაწერით სრულად ვერ გადის SPF შემოწმებას, რაც იმაზე უარესია, საერთოდ რომ არ გქონდეთ.
შემდეგ დააჭირეთ Verify DNS Settings Mailgun-ში. გამწვანებას შესაძლოა ერთ საათამდე დასჭირდეს.
⭐ დაამატეთ MX ჩანაწერები მაშინაც კი, თუ მხოლოდ გაგზავნას ახორციელებთ. სწორედ მათი საშუალებით აგროვებს Mailgun-ი bounce-ებს. მათ გარეშე არასწორი მისამართი ბრუნდება არსად, Mailgun-ი ვერ შეძლებს მის შეზღუდვას და თქვენ გააგრძელებთ თანხის გადახდას ისეთ მისამართზე გაგზავნისთვის, რომელიც ვერასდროს ვერაფერს მიიღებს.
3. მიიღეთ თქვენი API გასაღები
Send → Sending → Domain settings → API keys, ან თქვენი ანგარიშის API Keys გვერდი.
გამოიყენეთ ამ დომენისთვის განკუთვნილი გამგზავნი გასაღები (sending key), თუ თქვენი ტარიფი ამას ითვალისწინებს, ნაცვლად თქვენი ანგარიშის პირადი API გასაღებისა. გამგზავნ გასაღებს მხოლოდ გაგზავნა შეუძლია; პირად გასაღებს შეუძლია წაიკითხოს თქვენი ჟურნალები და შეცვალოს თქვენი ანგარიში. ჩვენთვის მეორე გასაღების შენახვის არანაირი მიზეზი არ არსებობს.
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-ის საცდელ ანგარიშებს გაგზავნა შეუძლიათ მხოლოდ ავტორიზებულ მიმღებებთან, ამიტომ სატესტო შეტყობინება თქვენს პირად მისამართზე კვლავ იმუშავებს, მაშინ როცა თქვენს კლიენტებთან გაგზავნილი ყველა წერილი შეუმჩნევლად შეწყდება.