Risoluzione dei problemi SMTP

Usa questa pagina quando l’SMTP relay rifiuta un messaggio o il client non riesce a collegarsi. Gli errori sono raggruppati in base alla fase della conversazione SMTP in cui si verificano, e per ciascuno sono indicate causa e soluzione.

Trova il codice di risposta

• Nella tua applicazione. Le librerie di posta includono la risposta del server nell’errore, ad esempio Error: Invalid login: 535 Authentication failed in Nodemailer o SMTPAuthenticationError: (535, b'Authentication failed') in Python.
• In Emailit. Email API›Logs registra ogni messaggio inviato con l’origine SMTP e il relativo codice di risposta, oltre ai rifiuti per limite di frequenza e agli accessi non riusciti per le chiavi che Emailit riesce a identificare. Filtra per Status code o API key.
• Con una prova manuale. Esegui il comando cURL di Invia un messaggio di prova con -v per vedere l’intera conversazione.

I codici che iniziano con 4 sono temporanei: i client ben fatti li ritentano più tardi. I codici che iniziano con 5 sono permanenti: risolvi la causa prima di inviare di nuovo.

Riferimento rapido

Errori di accesso

Si verificano quando il client invia AUTH.

535 Authentication failed

Causa. La password non è una chiave API valida per nessun workspace. La chiave potrebbe contenere un errore di battitura o spazi in più, essere stata eliminata o rigenerata, oppure essere una vecchia chiave che hai sostituito.

Soluzione. Copia di nuovo la chiave da dove l’hai memorizzata al momento della creazione. Emailit mostra le chiavi una sola volta, quindi se non ce l’hai più, crea una nuova chiave in Email API›API Keys. Usa emailit come nome utente e la chiave completa, che inizia con secret_, come password. Vedi Perché l’SMTP restituisce 535 Authentication failed?.

454 Temporary authentication failure

Causa. Emailit non è riuscito a controllare la chiave a causa di un errore interno.

Soluzione. Riprova dopo una breve attesa. Se il problema continua per più di qualche minuto, controlla status.emailit.com e contatta il supporto.

Errori di limite di frequenza

Si verificano quando il client invia MAIL FROM per iniziare un messaggio.

452 4.4.5 Messages per second limit exceeded

Causa. Nell’ultimo secondo il workspace ha inviato più messaggi di quanti ne consenta il limite al secondo, che è 2 per impostazione predefinita. Il limite è condiviso con l’API e conta ogni transazione SMTP come un messaggio. I numeri tra parentesi indicano il conteggio attuale e il limite.

Soluzione. La maggior parte dei client ritenta automaticamente i 452. Per evitarli, invia tramite una coda con concorrenza limitata, oppure riusa una sola connessione e invia i messaggi uno dopo l’altro. Se ti serve una frequenza più alta, usa Request Increase nel riquadro Sending Limits della home page del pannello. Vedi Limiti e quote.

452 4.5.3 Daily message limit exceeded

Causa. Il workspace ha raggiunto il limite giornaliero, che è di 5000 messaggi per impostazione predefinita ed è condiviso con l’API.

Soluzione. Gli invii riprendono dopo la mezzanotte UTC. Chiedi un limite giornaliero più alto dal riquadro Sending Limits della home page del pannello. I workspace Pro e Business ricevono anche aumenti automatici quando la salute degli invii è buona.

Errori temporanei

451 Temporary local error in processing

Causa. Emailit ha incontrato un errore interno durante la gestione del comando. Può succedere in qualsiasi fase.

Soluzione. Riprova più tardi. I server di posta e la maggior parte delle librerie lo fanno automaticamente per le risposte 4xx. Se il problema persiste, contatta il supporto indicando l’ora del tentativo.

Errori sui destinatari

Si verificano quando il client invia RCPT TO per ogni destinatario.

501 Invalid RCPT TO

Causa. L’indirizzo del destinatario non è formato correttamente, ad esempio non ha la @ o non c’è nulla prima o dopo di essa. Il messaggio completo è Invalid RCPT TO format o Invalid RCPT TO.

Soluzione. Convalida gli indirizzi prima di inviare. Controlla che non ci siano valori vuoti o nomi visualizzati passati dove è previsto solo un indirizzo.

530 Authentication required

Causa. Il client non ha effettuato l’accesso, oppure l’accesso non è riuscito e il client è andato avanti comunque. Senza accesso, il relay accetta posta solo per gli indirizzi di ricezione e di bounce di Emailit.

Soluzione. Attiva l’autenticazione SMTP nel client e imposta nome utente e password. Controlla se nella stessa sessione c’è un 535 precedente.

535 Mail server has been suspended

Causa. Il workspace è sospeso, di solito a causa di un tasso di bounce elevato. Vedi Salute degli invii.

Soluzione. Contatta il supporto all’indirizzo support@emailit.com. Gli invii riprendono quando la sospensione viene revocata.

550 Unverified workspaces can only send to workspace members’ account emails

Causa. Il workspace è in modalità sandbox e il destinatario non è l’email dell’account di un membro del workspace. Il messaggio termina con l’indirizzo bloccato.

Soluzione. Fai le prove con l’email dell’account di un membro, oppure richiedi l’accesso alla produzione. Vedi Come provo l’invio prima che il workspace sia verificato?.

Errori sul messaggio

Si verificano dopo che il client ha inviato il messaggio con DATA.

552 Message too large (maximum size 40MB)

Causa. Il messaggio, allegati codificati compresi, supera i 40 MB. La codifica Base64 rende gli allegati più grandi dei file di circa un terzo.

Soluzione. Invia allegati più piccoli, oppure carica i file grandi su un tuo spazio di archiviazione e includi un link.

530 From/Sender domain is not verified for this workspace

Causa. Un indirizzo nell’header From non si trova su un dominio di invio verificato del workspace a cui appartiene la chiave. Motivi comuni: il dominio non è ancora verificato o è in attesa di revisione, l’indirizzo From è su un sottodominio che non hai aggiunto, la chiave appartiene a un altro workspace, oppure il messaggio non ha un header From. L’indirizzo MAIL FROM della busta non conta.

Soluzione. Controlla lo stato del dominio in Email API›Domains, fai corrispondere esattamente l’indirizzo From a un dominio verificato e usa una chiave dello stesso workspace. Vedi Perché l’SMTP restituisce 530 From domain not verified?.

530 API key is restricted to sending domain

Causa. La chiave è una chiave Sending Only limitata a un dominio, e l’indirizzo From è su un altro dominio. Il messaggio indica il dominio consentito.

Soluzione. Invia dal dominio consentito, oppure usa una chiave senza limitazione di dominio.

550 Sending from this domain is paused

Causa. Emailit ha messo in pausa il dominio del From perché il suo tasso di bounce ha superato il 5%.

Soluzione. Trova l’origine dei bounce e ripulisci la lista. Vedi Salute degli invii e Bounce e segnalazioni di spam.

550 Loop detected

Causa. Il messaggio è già passato più di quattro volte attraverso il relay di Emailit, di solito perché delle regole di inoltro lo rimandano avanti e indietro.

Soluzione. Trova e interrompi il ciclo di inoltro tra i tuoi sistemi o le tue caselle.

550 Message processing failed

Causa. Emailit ha accettato i dati ma non è riuscito a memorizzare il messaggio.

Soluzione. Ritenta il messaggio. Se non riesce di nuovo, contatta il supporto indicando l’ora del tentativo e gli indirizzi From e To.

Errori sulle email in entrata

452 Insufficient credits to receive inbound email

Causa. È stato inviato un messaggio a uno dei tuoi indirizzi per le email in entrata, ma il workspace non ha più crediti. Ricevere un’email costa 1 credito. Il server mittente riceve questo errore temporaneo e ritenta più tardi.

Soluzione. Ricarica i crediti o attiva la ricarica automatica. La posta che il mittente ritenta arriva quando i crediti sono disponibili.

Problemi di connessione

Per maggiori dettagli, vedi Perché ricevo errori TLS quando mi collego all’SMTP?.

Accettata ma non consegnata

Una risposta 250 significa che Emailit ha accettato il messaggio, non che è arrivato in inbox. Apri l’email in Email API›Emails usando l’ID della risposta e controllane lo stato:

• Held: il workspace ha esaurito i crediti, il dominio è stato messo in pausa o il messaggio ha ottenuto un punteggio pari o superiore a 7 nei controlli antispam. Risolvi la causa, poi ritenta. Vedi Perché l’email è trattenuta?.
• Suppressed: il destinatario è nella lista di soppressione.
• Attempted: il server del destinatario ha restituito un errore temporaneo. Emailit ritenta per circa 21 ore.
• Bounced o Failed: i dettagli della consegna mostrano la risposta del server ricevente. Vedi Bounce e segnalazioni di spam.

Per una checklist completa, vedi Perché la mia email non è arrivata?.

Serve ancora aiuto?

Scrivi a support@emailit.com o chiedi su Discord. Indica l’ora del tentativo, la porta, la libreria di posta e la risposta completa del server.