Invia email tramite il Suo account Mailgun

Avrà bisogno di un account Mailgun e dell'accesso al DNS del Suo dominio.

Documentazione ufficiale di Mailgun: Aggiungere e verificare un dominio · Chiavi API · Registrati

1. Aggiunga il Suo dominio di invio a Mailgun

Nella dashboard di Mailgun vada su Send → Domains → Add New Domain e inserisca un sottodominio, ad esempio mail.yourdomain.com.

⚠️ La raccomandazione stessa di Mailgun è di utilizzare un sottodominio, e qui conta più che con altri provider: Mailgun imposta i propri record SPF e DKIM su qualsiasi valore Lei inserisca, e puntarlo al Suo dominio radice significa che tali record si affiancheranno a quelli da cui dipendono le Sue caselle di posta aziendali.

Scelga la regione corrispondente a dove desidera risiedano i Suoi dati — US o EU. La annoti; Le servirà al passaggio 4, ed è l'errore in assoluto più comune.

2. Pubblichi i record DNS forniti da Mailgun

Mailgun Le mostrerà un elenco. Aggiunga ciascuno di essi presso il Suo provider DNS.

⛔ Se il Suo sottodominio di invio dispone già di un record SPF, lo modifichi — non ne aggiunga un secondo. Un dominio con due record SPF TXT fallisce del tutto la verifica SPF, il che è peggio che non averne alcuno.

Quindi prema Verify DNS Settings in Mailgun. Può essere necessaria fino a un'ora prima che diventi verde.

⭐ Aggiunga i record MX anche se effettua solo invii. Sono lo strumento con cui Mailgun raccoglie i bounce. Senza di essi, un indirizzo errato rimbalza nel vuoto, Mailgun non può sopprimerlo e Lei continuerà a pagare per inviare a un indirizzo che non riceverà mai nulla.

3. Recuperi la Sua chiave API

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

Utilizzi una chiave di invio (sending key) limitata a questo dominio se il Suo piano ne prevede una, anziché la chiave API privata del Suo account. Una chiave di invio può soltanto inviare; la chiave privata può leggere i Suoi log e modificare il Suo account. Non c'è alcun motivo per cui noi si debba conservare la seconda.

4. Effettui il collegamento in Zinn®

Apra Invio email nella Sua dashboard e compili:

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

⛔⛔ Inserisca la regione corretta. Gli account Mailgun ospitati nell'EU sono gestiti da un host API completamente diverso. L'invio della chiave di un account EU all'host US restituisce "401 Unauthorized" — il che sembra esattamente un errore di chiave non valida. Se la Sua chiave è sicuramente corretta e riceve l'errore 401, il motivo è quasi sempre questo.

5. Invii il test e inserisca il codice

Prema Invia messaggio di prova, utilizzando una casella di posta su un dominio diverso — un indirizzo Gmail è l'ideale. Legga il codice ricevuto in quella casella e lo inserisca. La Sua posta verrà instradata immediatamente.

In caso di problemi

401 Unauthorized — regione errata (vedere sopra), oppure è stata incollata una chiave appartenente a un altro account Mailgun. Rigeneri la chiave anziché ridigitarla; il prefisso iniziale key- si perde facilmente.

Il messaggio di prova non arriva mai — controlli la pagina Logs di Mailgun. Se Mailgun non ne ha alcuna traccia, la credenziale o il nome del dominio sono errati. Se Mailgun lo ha accettato ed è fallito successivamente, il motivo sarà indicato a chiare lettere, e si tratta quasi sempre del DNS.

"Domain not found" — il campo Dominio di invio Mailgun deve corrispondere esattamente al dominio indicato da Mailgun, incluso il sottodominio. Per Mailgun, yourdomain.com e mail.yourdomain.com sono due domini diversi.

Funzionava e poi ha smesso — verifichi se il Suo periodo di prova gratuito è terminato. Gli account di prova di Mailgun possono inviare solo a destinatari autorizzati, pertanto il messaggio di prova verso il Suo indirizzo continuerà a funzionare, mentre tutte le comunicazioni verso i Suoi clienti smetteranno silenziosamente di partire.