1. Accesso alla Google Cloud Console
Accedi alla Google Cloud Console
Seleziona o crea un nuovo progetto dedicato all’integrazione con TAC.
2. Abilitazione delle API necessarie
Nel progetto selezionato:
Vai su APIs & Services → Library
Abilita le seguenti API:
Gmail API
Google Calendar API
Admin SDK API (necessaria per utenti e directory)
3. Configurazione della schermata di consenso OAuth
Vai su APIs & Services → OAuth consent screen
Seleziona Internal (consigliato per aziende)
Compila i campi principali:
App name: TAC – Mail & Calendar Integration
User support email
Developer contact information
Salva e continua senza pubblicare (se app interna)
4. Creazione delle credenziali OAuth 2.0
Vai su APIs & Services → Credentials
Clicca su Create credentials → OAuth client ID
Seleziona:
Application type: Web application
Compila:
Name: TAC Web App
Authorized redirect URI:
<https://app.touchandcontact.com/>
Salva e prendi nota di:
Client ID
Client Secret
5. Scopes e permessi richiesti
L’integrazione utilizza i seguenti OAuth scopes, necessari per la sincronizzazione dello storico attività:
Email (Gmail)
Calendario
Directory utenti (Admin SDK)
⚠️ Gli scope readonly garantiscono accesso in sola lettura a email ed eventi di calendario.
6. Configurazione Domain-wide Delegation (Admin)
Questo passaggio è richiesto per consentire a TAC di accedere ai dati degli utenti a livello di dominio.
Accedi alla Admin Console Google Workspace
Vai su:
Security → API controls → Domain-wide delegation
Clicca su Add new
Inserisci:
Client ID (ottenuto dalla Cloud Console)
OAuth Scopes (separati da virgola):
<https://www.googleapis.com/auth/gmail.readonly>, <https://www.googleapis.com/auth/calendar.readonly>, <https://www.googleapis.com/auth/admin.directory.user.readonly>, <https://www.googleapis.com/auth/admin.directory.group.readonly>
Salva la configurazione.
7. Configurazione nel portale TAC
Accedi al portale TAC:
Vai in Impostazioni → Integrazioni
Seleziona Google Workspace
Inserisci:
Client ID
Client Secret
Abilita:
✅ Importa email
✅ Sincronizzazione calendario
Salva
8. Risultato dell’integrazione
Una volta completata l’integrazione:
TAC sincronizza le email Gmail associate ai contatti
TAC sincronizza gli eventi di Google Calendar (meeting, call, inviti)
Ogni contatto mostra uno storico attività centralizzato, utile per:
prepararsi prima di una call
tracciare follow-up e relazioni
garantire continuità anche in team distribuiti