Riferimento
Codici di stato estesi
I codici di stato estesi dell’RFC 3463 come 5.1.1, 4.7.0 e 5.7.26 spiegati, con la causa più comune di ciascuno e cosa cambiare prima di inviare di nuovo.
I codici di stato estesi sono i codici x.y.z che seguono la risposta a tre cifre nella maggior parte delle risposte SMTP. Sono più precisi del codice di risposta, quindi sono il modo più rapido per capire perché un’email ha generato un bounce o è stata rinviata.
Come è composto il codice
Un codice di stato esteso ha tre parti, class.subject.detail:
550 5.1.1 The email account that you tried to reach does not exist.
│ │ └─ detail: bad destination mailbox address
│ └─── subject: addressing
└───── class: permanent failure| Classe | Significato |
|---|---|
2 |
Successo. |
4 |
Errore temporaneo persistente. Il messaggio potrebbe essere consegnato se viene inviato di nuovo più tardi. |
5 |
Errore permanente. Inviare di nuovo lo stesso messaggio non funzionerà. |
| Soggetto | Ambito |
|---|---|
0 |
Altro o non definito. |
1 |
Indirizzamento: l’indirizzo del mittente o del destinatario. |
2 |
Casella: la casella del destinatario, ad esempio piena o disattivata. |
3 |
Sistema di posta: il sistema ricevente, ad esempio limiti di spazio o di dimensione. |
4 |
Rete e instradamento: DNS, connessioni e timeout. |
5 |
Protocollo di consegna: comandi e sintassi SMTP. |
6 |
Contenuto del messaggio o media: codifica e conversione. |
7 |
Sicurezza o policy: autenticazione, filtri antispam e reputazione. |
Emailit memorizza il codice esteso di ogni consegna non riuscita. Lo vedi con la risposta completa nella scheda Deliveries dell’email, e come smtp_enhanced_code negli eventi webhook email.attempted. Il fatto che Emailit ritenti o meno dipende dal codice di risposta e dal messaggio, come descritto in Come Emailit gestisce le risposte.
Codici di successo
| Codice | Significato | Note |
|---|---|---|
2.0.0 |
Successo. | L’SMTP relay di Emailit risponde 250 2.0.0 OK: queued as em_... quando accetta il tuo messaggio. |
2.1.5 |
Indirizzo di destinazione valido. | Il destinatario è stato accettato. |
2.6.0 |
Messaggio accettato. | Frequente nelle risposte dei server Microsoft. |
Errori temporanei (4.x.x)
| Codice | Significato | Causa comune | Cosa fare |
|---|---|---|---|
4.2.1 |
Casella temporaneamente non disponibile. | La casella sta ricevendo posta troppo velocemente, oppure è inattiva. | Nulla, per un singolo messaggio. Emailit tratta come permanenti le risposte di Gmail «receiving mail at a rate» e «inactive mailbox». |
4.2.2 |
Casella piena. | Il destinatario ha superato la quota di spazio. | Emailit tratta le risposte più comuni di quota superata come hard bounce. Rimuovi l’indirizzo se il problema si ripete. |
4.3.0 |
Problema del sistema di posta. | Un guasto temporaneo sul server ricevente. | Nulla. Emailit ritenta. |
4.4.1 |
Nessuna risposta dall’host. | Il server del destinatario non ha risposto o la connessione è andata in timeout. | Nulla, per un singolo messaggio. Se è interessato un intero dominio, controlla che i suoi record MX funzionino. |
4.4.2 |
Connessione non riuscita. | La connessione si è interrotta durante la transazione. | Nulla. Emailit ritenta. |
4.4.5 |
Sistema congestionato. | Il server ricevente è sovraccarico. Il relay di Emailit usa questo codice anche quando superi il limite di invio al secondo. | Rallenta. Con il relay di Emailit, resta sotto il limite al secondo. |
4.5.3 |
Troppi destinatari. | Troppi destinatari in una sola transazione. Il relay di Emailit usa questo codice anche quando raggiungi il limite di invio giornaliero. | Con il relay di Emailit, attendi l’azzeramento giornaliero alle 00:00 UTC o chiedi un limite più alto. |
4.7.0 |
Rifiuto temporaneo per sicurezza o policy. | Greylisting, oppure un provider che limita la velocità della posta che considera sospetta, come il «unusual rate of unsolicited mail» di Gmail. | Lascia che Emailit ritenti. Se persiste, controlla la salute degli invii, i tassi di segnalazione e l’autenticazione. |
4.7.1 |
Consegna temporaneamente non autorizzata. | Greylisting o un blocco temporaneo dovuto a una policy. | Lascia che Emailit ritenti. |
4.7.28 |
Velocità limitata (Gmail). | Gmail ha rilevato un volume insolito di posta non richiesta dal tuo IP o dominio. | Riduci il volume verso Gmail, pulisci la lista ed esamina le segnalazioni. |
Errori permanenti (5.x.x)
| Codice | Significato | Causa comune | Cosa fare |
|---|---|---|---|
5.0.0 |
Errore permanente, senza dettagli. | Un rifiuto generico. | Leggi il testo del messaggio per conoscerne il motivo. |
5.1.0 |
Errore di indirizzo. | L’indirizzo è stato rifiutato per un motivo di indirizzamento non specificato. | Controlla che l’indirizzo non contenga errori di battitura. |
5.1.1 |
Casella di destinazione non valida. | La casella non esiste. | Rimuovi l’indirizzo. Emailit lo sopprime se genera un altro hard bounce entro 24 ore. |
5.1.2 |
Sistema di destinazione non valido. | Il dominio del destinatario non esiste o non ha un server di posta. | Controlla che il dominio non contenga errori di battitura, come gmial.com. |
5.1.3 |
Sintassi dell’indirizzo di destinazione non valida. | L’indirizzo non è valido. | Correggi l’indirizzo, oppure verifica la lista prima di inviare. |
5.1.8 |
Indirizzo di sistema del mittente non valido. | Il server ricevente non è riuscito a risolvere il dominio del mittente della busta. | Controlla che i record MX e SPF del return path su emailit.yourdomain.com siano pubblicati. Vedi Record DNS. |
5.1.10 |
Il destinatario ha un null MX, oppure destinatario non trovato. | Null MX dell’RFC 7505. Microsoft usa questo codice anche quando il destinatario non esiste. | Rimuovi l’indirizzo. |
5.2.1 |
Casella disattivata. | L’account è stato chiuso o sospeso. | Rimuovi l’indirizzo. |
5.2.2 |
Casella piena. | Il destinatario ha superato la quota. | Riprova molto più tardi, oppure rimuovi l’indirizzo se il problema si ripete. |
5.2.3 |
Messaggio troppo lungo per la casella. | Il messaggio supera il limite di dimensione del destinatario. | Riduci la dimensione del messaggio. |
5.3.4 |
Messaggio troppo grande per il sistema. | Il messaggio supera il limite di dimensione del server ricevente. | Invia allegati più piccoli, oppure inserisci un link ai file. |
5.4.1 |
Nessuna risposta dall’host, oppure accesso negato. | Microsoft lo usa quando un destinatario viene rifiutato all’ingresso, spesso perché l’indirizzo non esiste. | Controlla l’indirizzo e rimuovilo se non è valido. |
5.4.4 |
Impossibile instradare. | Il dominio del destinatario non ha un record MX o A utilizzabile. | Controlla il dominio. |
5.5.0 |
Errore di protocollo. | Il server ha rifiutato un comando SMTP. | Contatta il supporto se riguarda molti destinatari. |
5.7.0 |
Rifiuto per sicurezza o policy. | Un blocco generico dovuto a una policy, spesso per spam o reputazione. | Leggi il testo del messaggio e rivedi il contenuto e la qualità della lista. |
5.7.1 |
Consegna non autorizzata, messaggio rifiutato. | Il server del destinatario ha bloccato il messaggio o il tuo IP: filtro antispam, blocklist, oppure il destinatario accetta posta solo da determinati mittenti. | Leggi il testo del messaggio. Per le blocklist, vedi le best practice. Per i blocchi non legati al contenuto, Emailit mette in pausa per un’ora quel percorso tra IP e dominio. |
5.7.8 |
Credenziali di autenticazione non valide. | Nome utente o password errati, di solito quando la tua app accede a un server SMTP. | Con il relay di Emailit, usa una chiave API come password. |
5.7.9 |
Meccanismo di autenticazione troppo debole. | Il server richiede un metodo di accesso più sicuro. | Con il relay di Emailit, usa PLAIN o LOGIN su TLS. |
5.7.23 |
Convalida SPF non riuscita. | L’IP di invio non è autorizzato dal record SPF del dominio del mittente della busta. | Assicurati che il record TXT su emailit.yourdomain.com contenga include:_spf.emailit.com. |
5.7.25 |
Convalida del DNS inverso non riuscita. | L’IP di invio non ha un record PTR corrispondente. | Contatta il supporto. Emailit gestisce il DNS inverso dei propri IP. |
5.7.26 |
Più controlli di autenticazione non superati, oppure DMARC non superato. | Il messaggio non ha superato l’allineamento SPF e DKIM, e la policy DMARC del dominio prevede il rifiuto. Gmail lo usa anche per la posta non autenticata. | Verifica il dominio in modo che il DKIM venga superato, e controlla con i report DMARC gli altri servizi che inviano a nome del tuo dominio. |
5.7.27 |
L’indirizzo del mittente ha un null MX. | Null MX dell’RFC 7505 sul dominio del mittente. Gmail lo usa anche quando l’SPF non viene superato. | Controlla i record del return path e dell’SPF. |
5.7.509 |
Accesso negato, DMARC non superato (Microsoft). | Outlook.com ha rifiutato il messaggio perché non ha superato DMARC e la tua policy è reject. |
Correggi SPF e DKIM per il servizio di invio, poi rivedi la policy DMARC. |
5.7.515 |
Accesso negato, livello di autenticazione non raggiunto (Microsoft). | Outlook.com richiede che SPF, DKIM e DMARC vengano superati per i mittenti di grandi volumi. | Pubblica un record DMARC e assicurati che il dominio sia verificato in Emailit. |
5.7.606 |
Accesso negato, IP di invio bloccato (Microsoft). | L’IP di invio è nella blocklist di Microsoft. | Contatta il supporto con la risposta completa. |