Guide > Collegare i canali > Collegare una casella email

Collegare una casella e-mail (IMAP/SMTP)

Questa guida collega una casella email esistente (ad es. support@yourcompany.com) a The-Y CRM. Dopo, la posta in arrivo finisce automaticamente come ticket nell'inbox e le tue risposte partono dallo stesso indirizzo.

⏱ circa 5–10 min · Permesso “Manage settings” (amministratore) · Vale per Free, Cloud Pro e Paid · Aggiornato al 15 nov 2026 (versione 1.1.68)

La pagina Settings → Channels di The-Y CRM
Settings → Channels: qui aggiungi la casella.

Prima di iniziare: cosa ti serve

Dalla versione 1.1.50 colleghi Microsoft 365 e Outlook.com con un clic, senza password: ecco come. Tutte le altre caselle si collegano via IMAP/SMTP come descritto qui; funziona con qualsiasi provider.

Passo per passo

Se nell'assistente di configurazione hai scelto Google o Microsoft, la finestra si apre già nella vista giusta: per Google solo indirizzo e password per le app (dalla 1.1.66).

  1. Apri i canali. Nell'app clicca a sinistra su Settings → Channels. Se hai più marchi, scegli prima, in alto nella scheda “Connected”, il marchio a cui appartiene questa casella.
  2. Riquadro “Email”. In “Add a channel” clicca “Email”. Si apre la finestra “Connect a mailbox”.
  3. Inserisci l'indirizzo email: quello a cui ti scrivono i clienti (ad es. support@yourcompany.com).
  4. “Where is your mailbox?” The-Y propone il provider in base all'indirizzo: Microsoft 365 / Outlook.com, Gmail / Google Workspace o Other provider (IMAP/SMTP). Per Microsoft e Gmail prosegui più sotto (Microsoft, Gmail).
  5. Compila “Access” (altro provider). Receiving (IMAP) a sinistra, Sending (SMTP) a destra:
    • Host (ad es. imap.yourcompany.com o smtp.yourcompany.com)
    • Port: in ricezione di solito 993, in invio 587 (STARTTLS) o 465 (SSL). Per l'invio The-Y sceglie la crittografia in base alla porta.
    • User (se lo lasci vuoto vale l'indirizzo email) e password, salvati in forma cifrata (AES-256).
  6. “Sender and signature” (facoltativo, da espandere).
    • Label (un'etichetta solo per te, ad es. “Assistenza”) e nome del mittente.
    • Firma (HTML): i segnaposto come {{user.firstname}} vengono compilati per ogni agente che invia; un'anteprima mostra il risultato.
    • Importazione alla configurazione: “Only new mail (from now on)” (consigliato) o “Whole history (all earlier emails)”: in questo caso la casella esistente viene ripresa un po' alla volta.
  7. “Connect”. Solo ora The-Y crea la casella, salva i dati di accesso e verifica subito invio e ricezione. Se funzionano entrambi, la finestra si chiude e in alto compare “support@…” connected. La casella appare nell'elenco “Connected” ed è attiva: la posta in arrivo compare nell'Inbox, le risposte partono da questo indirizzo.
  8. Se qualcosa non funziona, la finestra resta aperta: il riquadro “The connection doesn't work yet.” indica il motivo riga per riga (“Sending: …”, “Receiving: …”), ad es. 535 Authentication failed direttamente dal server (vedi Risoluzione dei problemi). I dati mancanti sono segnati in rosso accanto al campo. Se annulli prima di cliccare “Connect”, non viene creato nulla.

Modificare in seguito: nell'elenco “Connected” clicca “Edit” sulla casella (finché manca qualcosa c'è scritto “Configure”). Si apre la stessa finestra con “Save” e “Test connection”. Delete si trova solo lì, in basso a sinistra, con conferma. L'interruttore “Active” nell'elenco mette offline una casella senza cancellare nulla.

Puoi aggiungere più caselle per marchio (ad es. support@ e info@). Quale casella invia la posta di sistema (reimpostazione password, inviti) lo imposti in Settings → Email sender. Un'email può andare al massimo a 20 destinatari (A, Cc e Ccn insieme) e nel piano Free conta come uno dei 1.000 messaggi in uscita al mese.

Collegare Microsoft 365 o Outlook.com

Microsoft rifiuta l'accesso con password per Outlook.com/Hotmail dal 16 set 2024 e per il recupero della posta dalle caselle aziendali (Microsoft 365) dal 1° ott 2022; per l'invio Microsoft lo disattiva di default a fine dicembre 2026 (aggiornato al 12 nov 2026, fonti: Outlook.com · Microsoft 365 · invio). Per questo, dalla versione 1.1.50 colleghi queste caselle direttamente con il tuo account Microsoft. La tua password resta a Microsoft; The-Y riceve solo il permesso di scaricare e inviare email.

  1. Apri la finestra. Settings → Channels → riquadro “Email” e inserisci l'indirizzo (per una casella esistente: “Configure” o “Edit” nell'elenco “Connected”).
  2. Scegli il provider. In “Where is your mailbox?” scegli “Microsoft 365 / Outlook.com” (già proposto per gli indirizzi Microsoft).
  3. Clicca “Connect with Microsoft”. Vieni portato per un attimo su Microsoft (una chiamata in corso in questa finestra termina).
  4. Accedi con esattamente questo indirizzo e conferma l'autorizzazione.
  5. Fatto. Torni indietro automaticamente e la finestra della casella si riapre: “Connected! The mailbox is now linked via Microsoft.” Le nuove email compaiono nell'inbox entro un minuto.

The-Y imposta i server da solo (ricezione outlook.office365.com, invio smtp.office365.com, o smtp-mail.outlook.com per Outlook.com).

“Your organisation only allows new apps with the approval of an admin” (serve l'approvazione di un amministratore)

Molte organizzazioni richiedono, una volta sola, il consenso di un amministratore prima di poter usare una nuova app. The-Y mostra allora un link di approvazione:

  1. Copia il link e invialo al tuo amministratore.
  2. L'amministratore lo apre (ruolo Amministratore globale, Amministratore applicazioni cloud o Amministratore applicazioni), controlla le autorizzazioni (leggere email via IMAP, inviare via SMTP, restare connessi, profilo) e clicca “Accetta”. In alternativa: interfaccia di amministrazione di Microsoft Entra → Applicazioni aziendali → “The-Y CRM” → Autorizzazioni → “Concedi il consenso amministratore”.
  3. Poi clicca di nuovo “Connect with Microsoft”.

Messaggi frequenti con Microsoft

Scollegare: “Disconnect” rimuove da The-Y l'accesso Microsoft. Conversazioni e messaggi restano. Puoi rimuovere l'app anche su myapps.microsoft.com (account di lavoro) o account.live.com/consent/Manage (account personale).

Gmail con una password per le app

Google non consente di usare la normale password di Gmail in altri programmi. Ti serve una password per le app (16 caratteri):

  1. Attiva la verifica in due passaggi nel tuo account Google (Sicurezza → Verifica in due passaggi).
  2. Apri myaccount.google.com/apppasswords, inserisci un nome (ad es. “The-Y CRM”) e clicca Crea.
  3. In The-Y, in “Where is your mailbox?” scegli “Gmail / Google Workspace” → incolla la password di 16 caratteri (senza spazi) nel campo “Google app password” → “Connect”. The-Y imposta i server da solo; “Connect” verifica subito.
Aiuto nell'app (dalla 1.1.68): la vista Gmail ha il riquadro “Help for Gmail” con i link alle pagine di Google sulla verifica in due passaggi e sulle password per le app. Se Google rifiuta la password, in alto compare “Google rejected the password.”: di solito è stata usata la normale password di Google invece di una password per le app, oppure la verifica in due passaggi è disattivata. Compare anche “Stuck? We'll set it up with you – free of charge.”: con un clic ci mandi una richiesta di aiuto (mai le password).

Server: ricezione imap.gmail.com, porta 993 (SSL) · invio smtp.gmail.com, porta 465 (SSL) o 587 (STARTTLS) · utente: indirizzo Gmail completo. Se la pagina “Password per le app” non c'è, Google indica tre motivi: la verifica in due passaggi usa solo token di sicurezza, è un account di lavoro o della scuola (Google Workspace: in tal caso l'amministratore l'ha bloccata, oppure ha bloccato IMAP) oppure è attivo il Programma di protezione avanzata (aggiornato al 12 nov 2026, fonte: Google). Se cambi la password di Google, tutte le password per le app vengono cancellate; in quel caso inseriscine una nuova.

Self-hosted: “Connect with Microsoft” richiede una tua registrazione dell'app presso Microsoft sul tuo server (MS_OAUTH_CLIENT_ID, MS_OAUTH_CLIENT_SECRET, URI di reindirizzamento https://<your-domain>/api/channels/email/oauth/microsoft/callback), spiegata passo per passo in SELF-HOSTING.md (in tedesco). Senza, “Connect with Microsoft” non funziona: per una casella esistente manca la scelta “Microsoft 365 / Outlook.com”; per una nuova, dopo il clic la finestra dice che l'accesso con Microsoft non è configurato su questa installazione e passa a “Other provider”. Gmail e tutti gli altri provider continuano a funzionare con la password.

Dati dei server dei provider più diffusi

Se non conosci i dati del tuo server, di solito li trovi nella guida del tuo provider alla voce “configurare IMAP/SMTP”. I più comuni:

ProviderIMAP (in entrata)SMTP (in uscita)Accesso / nota
Gmail / Google Workspaceimap.gmail.com : 993 (SSL)smtp.gmail.com : 465 (SSL) o 587 (STARTTLS)Password per le app obbligatoria (guida); attiva IMAP nell'account Gmail
Microsoft 365 / Outlook.comoutlook.office365.com : 993smtp.office365.com : 587
(Outlook.com: smtp-mail.outlook.com)
Con un clic tramite “Connect with Microsoft” (guida); The-Y inserisce i server da solo
GMXimap.gmx.net : 993mail.gmx.net : 587Attiva “POP3/IMAP access” nell'account GMX
web.deimap.web.de : 993smtp.web.de : 587Attiva IMAP nell'account
Server proprio / hostingimap.tuodominio.it : 993smtp.tuodominio.it : 587Dati dal tuo hosting (Virtualmin/Plesk/cPanel, “Account email”)
Ogni tanto i provider cambiano i dati dei server. Nel dubbio vale sempre la guida IMAP/SMTP ufficiale del tuo provider email.

Verifica che funzioni

  1. Test “Does it arrive?” (dalla 1.1.68): dopo che hai collegato una nuova casella, The-Y invia una breve email di prova al suo stesso indirizzo. Appena la tua casella la scarica, compare nell'inbox: puoi rispondere, la risposta va al tuo stesso indirizzo. Se dopo qualche minuto non arriva niente, la finestra lo dice e indica cosa controllare (ad es. la cartella spam). Puoi sempre saltare il test.
  2. In entrata: invia un'email di prova da un altro account all'indirizzo collegato. Entro ~1 minuto compare come nuovo ticket nell'Inbox.
  3. In uscita: apri il ticket, scrivi una risposta, “Send”. Controlla nell'altro account che la risposta arrivi (firma compresa).

Risoluzione dei problemi

535 Authentication failed / “nome utente o password errati”

Il server rifiuta le credenziali. Cause più comuni: (1) con Gmail ti serve una password per le app invece della password normale (guida). Microsoft 365 e Outlook.com si collegano con “Connect with Microsoft” invece che con una password (guida). (2) Il nome utente non è l'indirizzo email completo (alcuni hosting vogliono ad es. u12345). (3) IMAP/SMTP non è attivato sulla casella.

wrong version number / errore SSL durante la connessione

Porta e crittografia non corrispondono. Usa 993 per IMAP (SSL) e 587 (STARTTLS) o 465 (SSL) per SMTP. The-Y ricava la crittografia dalla porta: se inserisci ad es. la porta 587 con SSL forzato, compare questo errore.

Errore di certificato/nome host (server di posta proprio)

Se il certificato TLS del tuo server è rilasciato per un altro nome host, The-Y riprova l'invio SMTP una volta con un controllo del certificato meno rigido: così di solito l'invio funziona comunque. La soluzione più pulita è un certificato che corrisponda esattamente al nome host del tuo server di posta.

Il primo recupero ha importato tutto lo storico

Succede quando alla configurazione è stato scelto “Full history”. Per partire puliti scegli “New mail only”. La vecchia posta già importata puoi chiuderla nell'inbox.

Non arriva niente

Controlla: la casella è attiva (interruttore “Active” nell'elenco “Connected”)? Host e porta IMAP sono corretti? Il recupero gira in background circa una volta al minuto: aspetta un attimo. Se la casella mostra “Still missing: …” oppure non arriva niente anche se diceva “Connection works.”, aprila con “Configure” o “Edit”: in “Access” vedi allora “Fetch is failing: …” con il motivo. Se il server rifiuta l'accesso, The-Y aspetta 15 minuti prima di riprovare, così il tuo server di posta non ci blocca; riprova subito appena cambi le credenziali. Se il recupero fallisce per una casella che prima funzionava, gli amministratori ricevono una notifica: dopo 2 tentativi falliti se l'accesso viene rifiutato, altrimenti dopo 3 errori e 30 minuti.

Prossimi passi