Inviare email tramite il proprio account Mailgun

Sarà necessario disporre di un account Mailgun e dell'accesso al DNS del proprio dominio.

Documentazione ufficiale di Mailgun: Adding and verifying a domain · API keys · Sign up

1. Aggiungere il proprio dominio di invio a Mailgun

Nella dashboard di Mailgun, andare su Send → Domains → Add New Domain e inserire un sottodominio, ad esempio mail.tuodominio.com.

⚠️ Le linee guida ufficiali di Mailgun consigliano un sottodominio, e qui la cosa è più importante rispetto ad altri provider: Mailgun imposta i propri record SPF e DKIM su qualunque cosa gli venga fornita, e puntarlo al dominio principale significa che tali record si affiancheranno a quelli su cui fanno affidamento le caselle di posta aziendali.

Scegliere la regione corrispondente al luogo in cui si desidera risiedano i propri dati: US o EU. Prenderne nota; sarà necessaria nel passaggio 4 ed è l'errore singolo più comune in assoluto.

2. Pubblicare i record DNS forniti da Mailgun

Mailgun mostrerà un elenco. Aggiungere ciascuno di essi presso il proprio provider DNS.

| Tipo | Host | Scopo | | --- | --- | --- | | TXT | mail.tuodominio.com | SPF — v=spf1 include:mailgun.org ~all | | TXT | mailo._domainkey.mail.tuodominio.com | Chiave pubblica DKIM | | CNAME | email.mail.tuodominio.com | Tracciamento e gestione dei rimbalzi (bounce) | | MX | mail.tuodominio.com | Ricezione dei rimbalzi (i due host MX di Mailgun) |

⛔ Se il sottodominio di invio dispone già di un record SPF, modificarlo, senza aggiungerne un secondo. Un dominio con due record TXT SPF fallisce completamente la convalida SPF, il che è peggio che non averne alcuno.

Quindi premere Verify DNS Settings in Mailgun. Possono essere necessarie fino a un'ora perché lo stato diventi verde.

⭐ Aggiungere i record MX anche se si sta solo effettuando l'invio. Sono il mezzo con cui Mailgun raccoglie i rimbalzi. Senza di essi, un indirizzo errato rimbalza nel nulla, Mailgun non può bloccarlo e si continua a pagare per l'invio a un indirizzo che non riceverà mai nulla.

3. Ottenere la propria chiave API

Send → Sending → Domain settings → API keys, oppure la pagina API Keys del proprio account.

Utilizzare una chiave di invio limitata a questo dominio, se il piano ne offre una, anziché la chiave API privata del proprio account. Una chiave di invio può solo inviare; la chiave privata può leggere i registri e modificare l'account. Non c'è alcun motivo per cui noi dovremmo conservare la seconda.

4. Eseguire il collegamento in Zinn®

Aprire Invio email nella dashboard e compilare i campi:

Provider — Mailgun
Invia da questo dominio — mail.tuodominio.com (un dominio, non un indirizzo)
Dominio di invio Mailgun — lo stesso dominio aggiunto in Mailgun
Regione — us o eu, in corrispondenza del passaggio 1
Chiave API Mailgun — la chiave del passaggio 3

⛔⛔ Impostare la regione corretta. Gli account Mailgun ospitati nell'UE vengono gestiti da un host API completamente diverso. L'invio della chiave di un account UE all'host US restituisce "401 Unauthorized", un messaggio che appare esattamente come una chiave errata. Se la chiave è sicuramente corretta e si riceve un errore 401, questo è quasi sempre il motivo.

5. Inviare il test e inserire il codice

Premere Invia messaggio di test, utilizzando una casella di posta su un dominio differente (un indirizzo Gmail è l'ideale). Leggere il codice da quella casella di posta e inserirlo. La posta verrà commutata immediatamente.

In caso di mancato funzionamento

401 Unauthorized — regione errata (vedere sopra), oppure è stata incollata una chiave proveniente da un account Mailgun diverso. Rigenerare la chiave anziché digitarla nuovamente; la parte iniziale key- è facile da perdere.

Il messaggio di test non arriva mai — controllare la pagina Logs di Mailgun. Se Mailgun non ne ha alcuna registrazione, le credenziali o il nome di dominio sono errati. Se Mailgun lo ha accettato ma l'invio è fallito in seguito, il motivo sarà indicato chiaramente lì e si tratta quasi sempre del DNS.

"Domain not found" — il campo Dominio di invio Mailgun deve corrispondere esattamente al dominio così come elencato da Mailgun, incluso il sottodominio. tuodominio.com e mail.tuodominio.com sono due domini differenti per Mailgun.

Ha funzionato e poi si è fermato — verificare se la prova gratuita è scaduta. Gli account di prova di Mailgun possono inviare solo a destinatari autorizzati, quindi il messaggio di test al proprio indirizzo continua a funzionare mentre tutto ciò che è diretto ai clienti smette silenziosamente di farlo.