Avrà bisogno di un account SendGrid (Twilio SendGrid) e dell'accesso al DNS del Suo dominio.
Documentazione ufficiale di SendGrid: Autenticazione del mittente · Chiavi API · Registrazione
1. Autentichi il Suo dominio
Settings → Sender Authentication → Authenticate Your Domain.
Scelga il Suo provider DNS dall'elenco e risponda Yes a "Would you like to also brand the links for this domain?" — il link branding riscrive i link tracciati verso il Suo dominio anziché sendgrid.net, e un cliente che passa il cursore su un link nella Sua fattura dovrebbe visualizzare il Suo nome.
Inserisca un sottodominio come mail.yourdomain.com quando Le viene chiesto il dominio da cui invia.
2. Pubblichi i record CNAME
SendGrid fornisce tre o cinque record CNAME. Li aggiunga tutti.
| Type | Host | Purpose |
|---|
CNAME | em1234.yourdomain.com | Dominio Return-path (bounce) |
CNAME | s1._domainkey.yourdomain.com | Chiave DKIM 1 |
CNAME | s2._domainkey.yourdomain.com | Chiave DKIM 2 |
⭐ SendGrid utilizza deliberatamente i record CNAME anziché TXT, ed è decisamente preferibile: i valori effettivi delle chiavi risiedono su SendGrid, consentendo loro di ruotare le chiavi di firma senza che Lei debba modificare nuovamente il Suo DNS.
⚠️ Se il Suo provider DNS è Cloudflare, imposti questi record su DNS only (nuvola grigia), non su proxied. Un CNAME con proxy risolve verso gli indirizzi di Cloudflare e la verifica di SendGrid fallisce.
Prema Verify in SendGrid. Attenda fino a un'ora.
3. Crei una chiave API
Settings → API Keys → Create API Key.
Scelga Restricted Access e conceda esclusivamente Mail Send → Full Access. Nient'altro.
⛔ Non utilizzi una chiave Full Access. Una chiave Full Access può leggere i Suoi contatti, modificare le impostazioni del Suo account e creare ulteriori chiavi; l'unica operazione di cui abbiamo bisogno è inviare un messaggio. Se la nostra copia della Sua chiave venisse mai esposta, la differenza tra queste due chiavi è la differenza tra della posta indesiderata e un account compromesso.
⚠️ La chiave viene mostrata una sola volta. La copi prima di lasciare la pagina — SendGrid non potrà mostrarGliela nuovamente, solo sostituirla.
4. La colleghi in Zinn®
Apra Invio email nella Sua dashboard:
- Provider — SendGrid
- Invia da questo dominio —
mail.yourdomain.com (un dominio, non un indirizzo)
- Chiave API di SendGrid — la chiave del passaggio 3
SendGrid non richiede altre impostazioni da parte Sua.
5. Invii il test e inserisca il codice
Prema Invia messaggio di test verso una casella di posta su un dominio diverso, legga il codice ricevuto e lo inserisca.
Quando non funziona
403 Forbidden — la Sua chiave API non dispone del permesso Mail Send. Questo è di gran lunga l'errore più comune: una chiave Restricted Access creata senza alcuna autorizzazione spuntata si autentica perfettamente, ma non è autorizzata a fare nulla.
"The from address does not match a verified Sender Identity" — l'autenticazione del Suo dominio non è ancora andata a buon fine, oppure il dominio in Invia da questo dominio non è quello che ha autenticato. SendGrid verifica il dominio esatto: autenticare mail.yourdomain.com non autorizza l'invio da yourdomain.com.
Accettata ma mai recapitata — controlli Activity in SendGrid. Un account nuovo di zecca a volte viene trattenuto per una verifica durante il primo giorno circa, e i messaggi restano bloccati lì invece di rimbalzare.
Il Suo account è stato sospeso dopo pochi invii — SendGrid è severa con i nuovi account che inviano verso indirizzi che generano bounce. Si assicuri che il Suo elenco di clienti sia pulito prima di effettuare il passaggio.