Θα χρειαστείτε έναν λογαριασμό 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. Δημοσιεύστε τις εγγραφές DNS που σας δίνει το Mailgun
Το 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 | Παρακολούθηση και διαχείριση αναπηδήσεων |
MX | mail.yourdomain.com | Λήψη αναπηδήσεων (οι δύο κεντρικοί υπολογιστές MX του Mailgun) |
⛔ Εάν ο υποτομέας αποστολής σας διαθέτει ήδη εγγραφή SPF, επεξεργαστείτε την — μην προσθέσετε δεύτερη. Ένας τομέας με δύο εγγραφές SPF TXT αποτυγχάνει πλήρως στον έλεγχο SPF, κάτι που είναι χειρότερο από το να μην έχει καθόλου.
Στη συνέχεια, πατήστε Verify DNS Settings στο Mailgun. Μπορεί να χρειαστεί έως και μία ώρα για να γίνει πράσινο.
⭐ Προσθέστε τις εγγραφές 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 —
us ή eu, αντίστοιχα με το βήμα 1
- Mailgun API key — το κλειδί από το βήμα 3
⛔⛔ Επιλέξτε τη σωστή περιοχή. Οι λογαριασμοί Mailgun που φιλοξενούνται στην EU εξυπηρετούνται από έναν εντελώς διαφορετικό κεντρικό υπολογιστή API. Η αποστολή ενός κλειδιού λογαριασμού EU στον κεντρικό υπολογιστή US επιστρέφει «401 Unauthorized» — κάτι που μοιάζει ακριβώς με λανθασμένο κλειδί. Εάν το κλειδί σας είναι σίγουρα σωστό και λαμβάνετε 401, σχεδόν πάντα αυτός είναι ο λόγος.
5. Στείλτε τη δοκιμή και εισαγάγετε τον κωδικό
Πατήστε Send test message, χρησιμοποιώντας ένα εισερχόμενο γραμματοκιβώτιο σε διαφορετικό τομέα — μια διεύθυνση Gmail είναι ιδανική. Διαβάστε τον κωδικό από αυτό το γραμματοκιβώτιο και εισαγάγετέ τον. Η αλληλογραφία σας ενεργοποιείται αμέσως.
Όταν δεν λειτουργεί
401 Unauthorized — λάθος περιοχή (δείτε παραπάνω), ή επικολλήσατε ένα κλειδί από διαφορετικό λογαριασμό Mailgun. Δημιουργήστε ξανά το κλειδί αντί να το πληκτρολογήσετε εκ νέου· το αρχικό key- παραλείπεται εύκολα.
Το δοκιμαστικό μήνυμα δεν φτάνει ποτέ — ελέγξτε τη σελίδα Logs του Mailgun. Εάν το Mailgun δεν έχει κανένα αρχείο καταγραφής για αυτό, το διαπιστευτήριο ή το όνομα τομέα είναι λάθος. Εάν το Mailgun το αποδέχτηκε και απέτυχε στη συνέχεια, ο λόγος θα αναφέρεται ρητά εκεί, και σχεδόν πάντα οφείλεται στο DNS.
«Domain not found» — το πεδίο Mailgun sending domain πρέπει να είναι ακριβώς ο τομέας όπως τον εμφανίζει το Mailgun, συμπεριλαμβανομένου του υποτομέα. Το yourdomain.com και το mail.yourdomain.com είναι δύο διαφορετικοί τομείς για το Mailgun.
Λειτούργησε και μετά σταμάτησε — ελέγξτε αν έληξε η δωρεάν δοκιμαστική σας περίοδος. Οι δοκιμαστικοί λογαριασμοί Mailgun μπορούν να στέλνουν μόνο σε εξουσιοδοτημένους παραλήπτες, επομένως το δοκιμαστικό μήνυμα στη δική σας διεύθυνση συνεχίζει να λειτουργεί ενώ οτιδήποτε προς τους πελάτες σας σιωπηρά αποτυγχάνει.