Integrations

Collega Gmail / Outlook (OAuth) e sincronizza le e-mail

Collega il tuo account Google Workspace (Gmail) o Microsoft 365 (Outlook) tramite OAuth, usando l'app OAuth della tua stessa organizzazione, e registra automaticamente le e-mail come attività sui tuoi contatti.

💡 Vecchie email apparivano tagliate? Dopo la connessione, fai clic su "Recupera cronologia completa" nella scheda: il CRM recupera il testo integrale dei messaggi più vecchi rimasti solo con l'anteprima. È sicuro ripeterlo (non accorcia mai ciò che è già completo). Anche gli allegati delle email vengono scaricati e conservati.

Puoi collegare la tua casella Google Workspace (Gmail) o Microsoft 365 (Outlook) al CRM. Una volta collegata, il CRM legge le tue e-mail recenti e, per ogni messaggio il cui mittente o destinatario corrisponde a un Contatto o Lead (per e-mail), registra un'attività "e-mail" nella timeline di quel record.

Il modello è BYO ("bring your own", porta la tua app): usi l'app OAuth della tua stessa organizzazione. Noi non vediamo mai le tue credenziali e non c'è alcun costo da parte nostra. L'integrazione parte inerte: non succede nulla finché non configuri l'app OAuth e colleghi l'account.

Prerequisiti

Un account Google Workspace (Gmail) OPPURE Microsoft 365 (Outlook). Va bene il tuo normale account di lavoro.
Il permesso di creare un'app OAuth nella tua organizzazione: accesso alla Google Cloud Console (Gmail) o al Portale Azure / Microsoft Entra ID (Outlook). Nelle aziende, questo di solito richiede un amministratore IT.
In Sellio, l'accesso da amministratore (permesso di gestire le impostazioni) per salvare le credenziali dell'app in Impostazioni → Integrazioni. Collegare la casella vera e propria (Passo 3) lo fa ogni utente per il proprio account.

Passo 1: crea l'app OAuth della tua organizzazione

Google Workspace (Gmail): nella Google Cloud Console, crea un progetto, configura la schermata di consenso OAuth, abilita la Gmail API e crea una credenziale "ID client OAuth" (Applicazione web). Copia il Client ID e il Client Secret.

Microsoft 365 (Outlook): nel Portale Azure, vai su Microsoft Entra ID → Registrazioni app → Nuova registrazione. In "Certificati e segreti", genera un Client Secret. In "Autorizzazioni API", aggiungi Microsoft Graph con le autorizzazioni delegate Mail.Read e User.Read. Copia il Client ID (ID applicazione) e il Client Secret.

💡 Per entrambi i provider, registra ESATTAMENTE l'URI di reindirizzamento mostrato nella scheda dell'integrazione (termina con /api/oauth/google/callback o /api/oauth/microsoft/callback). Deve essere identico, altrimenti il provider rifiuterà la connessione.

Passo 2: incolla le credenziali nel CRM

Apri Impostazioni → Integrazioni e trova la scheda "Google Workspace (Gmail)" o "Microsoft 365 (Outlook)".
Copia l'URI di reindirizzamento mostrato e registralo nella tua app OAuth (Passo 1).
Incolla il Client ID e il Client Secret e clicca su "Salva credenziali app". Il Client Secret viene salvato cifrato e non viene mai più mostrato.

Passo 3: collega il tuo account

Sempre nella scheda, clicca su "Collega". Verrai portato alla schermata di consenso del provider, già autenticato con il tuo account.
Autorizza l'accesso in lettura alla posta. Tornerai al CRM e la scheda mostrerà "Collegato come" con l'indirizzo dell'account.
Clicca su "Sincronizza e-mail" per importare subito le e-mail recenti. Il CRM ti dirà quante e-mail ha letto e quante attività ha creato.

Ogni utente collega la propria casella: la sincronizzazione avviene nel contesto di chi l'ha collegata. Le e-mail diventano attività solo quando il mittente o il destinatario corrisponde a un Contatto o Lead esistente (per il campo e-mail). Le e-mail che non corrispondono a nessun record vengono ignorate.

Sicurezza e privacy

I token di accesso e di refresh vengono salvati cifrati e non vengono mai mostrati. Il token di accesso viene rinnovato automaticamente alla scadenza, senza un nuovo login. La connessione e-mail è completamente separata dal login al CRM: collegare o scollegare qui non cambia il modo in cui accedi al sistema.

💡 Per revocare l'accesso, clicca su "Scollega" nella scheda, e i token salvati vengono rimossi. Puoi ricollegarti in qualsiasi momento. Se la connessione scade (ad esempio, dopo aver cambiato la password dell'account), usa "Ricollega".

Example: URI di reindirizzamento da registrare: https://app.yourcompany.com/api/oauth/google/callback (Google) oppure https://app.yourcompany.com/api/oauth/microsoft/callback (Microsoft).

Come testare

Dopo aver collegato (Passo 3), conferma che la scheda mostri "Collegato come" con l'indirizzo corretto.
Clicca su "Sincronizza e-mail". Il CRM ti dirà quante e-mail ha letto e quante attività ha creato.
Apri un Contatto o Lead che sai avere scambiato e-mail di recente e controlla la timeline: dovrebbe comparire un'attività di tipo "E-mail".

Risoluzione dei problemi

Errore "redirect_uri_mismatch" o il provider rifiuta la connessione: l'URI di reindirizzamento registrato nell'app OAuth è diverso da quello mostrato nella scheda. Copialo di nuovo e incollalo ESATTAMENTE identico (stesso dominio, stessa barra finale).
401/invalid_client durante il collegamento: Client ID o Client Secret errati. Reinserisci le credenziali nella scheda (il Secret non viene mai restituito dal server, quindi reincollalo per intero).
Si collega, ma non crea attività: le e-mail diventano attività solo quando mittente/destinatario corrisponde a un Contatto o Lead tramite il campo e-mail. Le e-mail senza corrispondenza vengono ignorate, quindi aggiungi l'e-mail al record.
"Accesso negato" / schermata di consenso bloccata: su Google, pubblica la schermata di consenso OAuth (o aggiungi l'utente come tester); su Azure, concedi il consenso amministratore alle autorizzazioni.
La connessione ha smesso di funzionare (ad esempio, dopo aver cambiato la password dell'account): clicca su "Ricollega" nella scheda per rifare il consenso e rinnovare i token.

Open this article inside the system →