# Posta elettronica (email)

> Come collegare una casella di posta per ricevere le email nella chat di Narciso e rispondere da lì: cosa serve, i passi, la compilazione dei parametri, il test, i messaggi di errore, i gestori che oggi non si possono collegare (Gmail, Outlook, Yahoo) e cosa succede dopo il collegamento.

Ultimo aggiornamento: 23 ottobre 2026. Fonte: https://narciso.io/docs/email/

Collega una **casella di posta** con **SMTP** (per inviare) e **IMAP** (per ricevere). Le email ricevute compaiono nella chat come conversazioni «Email» e si risponde da lì ([Scrivere e inviare un messaggio](https://narciso.io/docs/scrivere-messaggi/)). La stessa casella serve anche per **inviare** ai clienti le comunicazioni di Narciso (per esempio le notifiche).

> **Attenzione.** **Oggi le caselle Gmail e Google Workspace, Outlook/Hotmail/Live, Microsoft 365 e Yahoo non si riescono a collegare da Narciso.** Per questi gestori il programma chiede un accesso tramite pagina sicura che non è ancora completato (vedi sotto). Se la tua casella è una di queste, scrivi a about@narciso.io ([Assistenza](https://narciso.io/docs/assistenza/)); le caselle di molti altri gestori (Aruba, Libero, Virgilio, Register, Zoho, iCloud e altri) si collegano con la procedura descritta qui.

## Cosa serve

1. L'**indirizzo email** e la **password**; se il gestore lo richiede (di solito con la verifica in due passaggi), una **«password per le app»**, cioè una password speciale generata nelle impostazioni di sicurezza del gestore.
2. L'**IMAP attivo** sul gestore. Alcuni lo tengono spento di default.
3. Un indirizzo **non temporaneo**: le email «usa e getta» non sono ammesse.

## La schermata

Titolo **«Configurazione Email»**, sottotitolo «Collega il tuo provider di posta per inviare e ricevere email (IMAP/SMTP).» La barra dei passi è **Account → Parametri** (oppure Account → Autenticazione). Errori in riquadro rosso, riuscite in riquadro verde. Per un attimo compare «Caricamento configurazione...»: se per la sede c'è già una casella, il modulo salta ai Parametri già compilati.

### Passo 1: Account

| Campo | Note |
|---|---|
| **Indirizzo Email** | Mentre scrivi, dopo mezzo secondo di pausa (e solo se c'è una «@»), Narciso controlla con un servizio esterno che non sia un indirizzo temporaneo; un cerchio gira nel campo. Se lo è, il campo diventa rosso con «Email temporanea non consentita.» Se il servizio non risponde, l'indirizzo è accettato. Diventa anche lo username di accesso (modificabile al passo 2) |
| **Password o App Password** | Compare **solo dopo** che l'indirizzo è stato controllato ed è valido |

**Salva e Testa** resta spento finché l'indirizzo non è valido e la password non è compilata.

### Cosa fa «Salva e Testa»

1. **Riconosce il gestore**: confronta il dominio con un elenco interno di oltre 170 gestori (Aruba, Libero, Virgilio, Alice/TIM, Register, Zoho, Fastmail, iCloud, GMX e molti esteri); se il dominio non c'è, guarda a chi è affidata la posta di quel dominio e riconosce Google, Microsoft, Zoho, Titan, Aruba e Register.
2. Se **non riconosce nessun gestore**, passa ai **Parametri** senza errore, con i campi da compilare a mano.
3. Se il gestore è **Gmail/Google Workspace, Outlook/Hotmail/Live/Microsoft 365 o Yahoo**, passa al passo **Autenticazione** (vedi sotto).
4. Negli altri casi compila da solo server e porte, **prova il collegamento** e, se riesce, **salva** e chiude la finestra senza avvisi. Se non riesce, passa ai Parametri con i valori già scritti e il messaggio d'errore.

### Il passo «Autenticazione»: perché non funziona

Compare «Autenticazione con [gestore]», con il testo «Il tuo provider richiede l'accesso tramite una pagina sicura. Clicca sul pulsante qui sotto per autorizzare l'applicazione.» e il pulsante **«Accedi a [gestore]»**. Oggi il pulsante apre una finestra che **non porta a nessuna autorizzazione reale** e non c'è una via d'uscita verso i parametri manuali: per queste caselle il collegamento non si completa. **Indietro** riporta al passo 1.

> **Nota.** Il riconoscimento vale anche per i domini aziendali la cui posta è ospitata da Google o Microsoft (ad esempio `info@tuosalone.it` gestita con Google Workspace): anche questi finiscono nel passo «Autenticazione».

### Passo «Parametri» (compilazione a mano)

Ci si arriva perché il gestore non è stato riconosciuto, perché la prova automatica è fallita o perché la casella era già configurata.

| Campo | Obbligatorio | Note |
|---|---|---|
| **Server SMTP** | Sì | Il server per **inviare**, per esempio `smtp.aruba.it` |
| **Porta** | Sì | Numero da 1 a 65535; proposta **587**. Porte comuni: 465 (con SSL attivo) e 587 (con SSL **disattivato**, «STARTTLS») |
| **Username (Email di accesso)** | Sì | Di solito l'indirizzo completo; è precompilato |
| **Password o App Password** | Sì | Se la casella è già salvata compare come ••••••••: lasciare i puntini = **non cambiare** la password |
| **Indirizzo Email Mittente** | Sì | L'indirizzo con cui partono le email |
| **Usa connessione sicura (SSL/TLS)** | — | Attiva di default. Con la **porta 587 va tolta la spunta**; con la 465 va lasciata |
| **Server IMAP (Ricezione)** | No | Per esempio `imap.aruba.it`. **Senza IMAP non si riceve nulla** e la casella resta grigia nella finestra dei collegamenti |
| **Porta IMAP** | Sì, **se** indichi un server IMAP | Proposta **993** |

Pulsanti: **Indietro**, **Test Connessione** e **Salva Configurazione**.

- **Test Connessione** prova SMTP e, se indicato, IMAP. Se va bene compare «Connessione SMTP verificata con successo!» (la frase parla di SMTP anche se è stato provato pure l'IMAP). **Il test invia davvero un'email di prova**, da e verso il tuo stesso indirizzo, con oggetto «Narciso - Test Connessione SMTP con React Email»: la troverai nella posta.
- **Salva Configurazione** ripete lo stesso collegamento e salva solo se riesce. Fatto, la finestra si chiude senza avvisi.

> **Nota.** Per circa un terzo dei gestori dell'elenco (quelli con porta 587) la configurazione automatica imposta comunque la connessione sicura **attiva**, e la prova **fallisce** con «non risponde» o «errore SSL/TLS». In quel caso, nei Parametri, si **toglie la spunta** «Usa connessione sicura (SSL/TLS)» e si preme **Salva Configurazione**. La sicurezza dell'IMAP non è modificabile da qui: si usa la porta 993 quando il gestore la offre.

#### Messaggi di controllo

«Il server SMTP è obbligatorio.», «La porta SMTP è obbligatoria.», «L'username è obbligatorio.», «L'indirizzo email di invio è obbligatorio.», «La password è obbligatoria.», «La porta IMAP è obbligatoria se si specifica un server IMAP.», «Inserisci email e password.», «Indirizzo email temporaneo non consentito.», «Porta SMTP non valida (1-65535)», «Password mancante per il test», «Dati mancanti per il test», «Errore durante il salvataggio.», «Errore durante il test di connessione.»

#### Gli errori del gestore, spiegati

| Situazione | Messaggio (in sintesi) | Cosa fare |
|---|---|---|
| IMAP spento | «L'accesso IMAP è disattivato sul tuo account di posta. Accedi al pannello del tuo provider e abilita l'IMAP…» | Si abilita l'IMAP dal pannello del gestore |
| Serve una password per le app | «Il provider richiede una 'Password per le App'…» | Si genera dalle impostazioni di sicurezza e si usa al posto della password normale |
| Credenziali rifiutate | «Il server [SMTP/IMAP] [server:porta] ha rifiutato le credenziali. Controlla username e password…» | Si controllano username, password e che l'accesso SMTP/IMAP sia abilitato |
| Server inesistente | «Server [SMTP/IMAP] … non trovato. Controlla che il nome del server sia scritto correttamente.» | Si corregge il nome del server |
| Porta irraggiungibile | «Impossibile raggiungere il server … Controlla il nome del server e la porta.» | Si controllano server e porta |
| Nessuna risposta | «Il server … non risponde. Di solito la porta o l'impostazione SSL/TLS non sono corrette: prova porta 465 con SSL attivo oppure porta 587 con SSL disattivato (STARTTLS).» | Si provano le due combinazioni |
| Sicurezza non corrispondente | «Errore SSL/TLS sul server …: la combinazione porta/sicurezza non è corretta.» | Come sopra |
| Altro | «Errore di connessione [SMTP/IMAP] [server:porta]: [motivo].» | Si legge il motivo |

### Gestori particolari

Per alcuni gestori conviene compilare a mano seguendo le indicazioni del gestore: **Zoho** (l'IMAP va abilitato a mano), **iCloud** (password specifica per app), **Fastmail** (password per le app), **Mailfence** (lo username è il nome utente, non l'indirizzo completo), **Startmail** (password del dispositivo).

## Modificare una casella già collegata (Ricollega)

**Ricollega** apre direttamente i Parametri con tutti i valori salvati e la password come ••••••••.

> **Attenzione.** Se non si tocca la password e la casella è già attiva, Narciso **non ripete la prova** di collegamento: un errore nei parametri modificati (per esempio un server sbagliato) si scopre solo dopo, perché le email non arrivano o non partono.

Se si scrive un **indirizzo diverso** in una sede che aveva una casella non condivisa, la nuova **sostituisce** la vecchia in quella sede. Se la casella era condivisa con altre sedi, la sede esce dalla vecchia (che resta per le altre) e ne crea una nuova ([Più sedi e canali condivisi](https://narciso.io/docs/canali-e-sedi/)).

## Dopo il collegamento

- La posta viene **controllata circa ogni 30 secondi**. La prima volta si scaricano solo le email delle **ultime 24 ore**; poi solo le nuove.
- Si leggono la **Posta in arrivo** e la cartella **Posta inviata** (riconosciuta per tipo o per nome): le email inviate dal telefono o dalla webmail compaiono come **in uscita**.
- Le email di **contatti bloccati** non vengono nemmeno scaricate ([Silenziare, bannare ed eliminare una conversazione](https://narciso.io/docs/gestire-conversazioni/)).
- Le email in uscita (risposte e notifiche ai clienti) partono con questa casella; se un invio non riesce, Narciso riprova da solo alcune volte e poi il messaggio risulta non inviato ([Scrivere e inviare un messaggio](https://narciso.io/docs/scrivere-messaggi/)).
- **Nessun avviso a video** se la password cambia o il gestore smette di rispondere: semplicemente le email non arrivano più e quelle in uscita non partono. Se si cambia la password dal gestore, si aggiorna la casella con **Ricollega** ([Quando un collegamento si interrompe da solo](https://narciso.io/docs/collegamento-interrotto/)).

## Voci correlate

- [Collegare i canali](https://narciso.io/docs/collegare-i-canali/)
- [PEC (posta elettronica certificata)](https://narciso.io/docs/pec/)
- [Scollegare un canale](https://narciso.io/docs/scollegare-un-canale/)
- [Problemi frequenti con i canali](https://narciso.io/docs/problemi-dei-canali/)