# Risoluzione dei problemi SMTP

> Ogni codice di risposta che l’SMTP relay di Emailit può restituire, con causa e soluzione, più porte bloccate, errori TLS, timeout e posta accettata ma non consegnata.

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](/it/docs/smtp/#send-a-test-message) 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

| Codice e messaggio | Fase | Sezione |
| --- | --- | --- |
| `535 Authentication failed` | AUTH | [Errori di accesso](#login-errors) |
| `454 Temporary authentication failure` | AUTH | [Errori di accesso](#login-errors) |
| `452 4.4.5 Messages per second limit exceeded` | MAIL FROM | [Errori di limite di frequenza](#rate-limit-errors) |
| `452 4.5.3 Daily message limit exceeded` | MAIL FROM | [Errori di limite di frequenza](#rate-limit-errors) |
| `451 Temporary local error in processing` | Qualsiasi | [Errori temporanei](#temporary-errors) |
| `501 Invalid RCPT TO` | RCPT TO | [Errori sui destinatari](#recipient-errors) |
| `530 Authentication required` | RCPT TO | [Errori sui destinatari](#recipient-errors) |
| `535 Mail server has been suspended` | RCPT TO | [Errori sui destinatari](#recipient-errors) |
| `550 Unverified workspaces can only send to…` | RCPT TO | [Errori sui destinatari](#recipient-errors) |
| `552 Message too large` | DATA | [Errori sul messaggio](#message-errors) |
| `530 From/Sender domain is not verified for this workspace` | DATA | [Errori sul messaggio](#message-errors) |
| `530 API key is restricted to sending domain` | DATA | [Errori sul messaggio](#message-errors) |
| `550 Sending from this domain is paused` | DATA | [Errori sul messaggio](#message-errors) |
| `550 Loop detected` | DATA | [Errori sul messaggio](#message-errors) |
| `550 Message processing failed` | DATA | [Errori sul messaggio](#message-errors) |
| `452 Insufficient credits to receive inbound email` | DATA | [Errori sulle email in entrata](#inbound-errors) |

## 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?](/it/docs/kb/smtp-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](https://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](/it/docs/limits/).

### 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](/it/docs/deliverability/sending-health/).

**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](/it/docs/workspaces/production-access/). Vedi [Come provo l’invio prima che il workspace sia verificato?](/it/docs/kb/test-sending-before-production-access/).

## 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?](/it/docs/kb/smtp-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](/it/docs/deliverability/sending-health/) e [Bounce e segnalazioni di spam](/it/docs/deliverability/bounces-and-complaints/).

### 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](/it/docs/inbound/), 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](/it/docs/billing/credits/) o attiva la [ricarica automatica](/it/docs/billing/auto-refill/). La posta che il mittente ritenta arriva quando i crediti sono disponibili.

## Problemi di connessione

| Sintomo | Causa probabile | Soluzione |
| --- | --- | --- |
| La connessione va in timeout o viene rifiutata | Il tuo ISP, hosting o provider cloud blocca la porta. La porta 25 è bloccata sulla maggior parte delle piattaforme cloud, e alcune bloccano la 587. | Usa la `587`, poi la `2525` o la `2587`. Vedi [Perché la connessione SMTP va in timeout?](/it/docs/kb/smtp-connection-timeout-port-25/). |
| `wrong version number`, oppure la connessione si blocca dopo essersi aperta | La modalità TLS non corrisponde alla porta: TLS implicito sulla 587, o STARTTLS sulla 465. | Usa STARTTLS sulle porte 587, 2525, 2587 e 25, e il TLS implicito solo sulla 465. |
| Il nome del certificato non corrisponde | Ti colleghi tramite indirizzo IP o tramite un tuo nome host. | Collegati a `smtp.emailit.com`. |
| L’handshake non riesce su un sistema datato | Il client non riesce a negoziare una versione moderna di TLS, oppure i suoi certificati CA non sono aggiornati. | Aggiorna il runtime, OpenSSL e il bundle CA. |

Per maggiori dettagli, vedi [Perché ricevo errori TLS quando mi collego all’SMTP?](/it/docs/kb/smtp-tls-errors/).

## 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](/it/docs/deliverability/spam-checks/). Risolvi la causa, poi [ritenta](/it/docs/email-api/retry-and-forward/). Vedi [Perché l’email è trattenuta?](/it/docs/kb/email-status-held/).
- **Suppressed:** il destinatario è nella [lista di soppressione](/it/docs/suppressions/).
- **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](/it/docs/deliverability/bounces-and-complaints/).

Per una checklist completa, vedi [Perché la mia email non è arrivata?](/it/docs/kb/email-not-delivered-checklist/).

## Serve ancora aiuto?

Scrivi a support@emailit.com o chiedi su [Discord](https://discord.emailit.com). Indica l’ora del tentativo, la porta, la libreria di posta e la risposta completa del server.

---
Fonte: https://emailit.com/it/docs/smtp/troubleshooting/