Sincronizza i contatti con Google/Outlook
Una volta collegato l'account Google Workspace o Microsoft 365, importa i tuoi contatti da Google Contacts (People API) o Outlook (Microsoft Graph) come contatti del CRM, senza duplicare e senza sovrascrivere quanto già compilato.
La sincronizzazione dei contatti funziona sulla stessa connessione OAuth usata per email e calendario (modello BYO: l'app OAuth appartiene alla tua organizzazione). Porta i tuoi contatti dal provider nel CRM come record di tipo Contatto.
Prerequisito: concedi l'accesso ai contatti
Quando colleghi Google Workspace o Microsoft 365, il CRM ora richiede anche il permesso sui contatti (Google: contacts; Microsoft: Contacts.ReadWrite), oltre a email e calendario. Se avevi già collegato l'account PRIMA di questo aggiornamento, la connessione non include i contatti: apri Impostazioni → Integrazioni, clicca su "Riconnetti" sulla scheda del provider e concedi il permesso sui contatti. La sezione "Sincronizzazione contatti (bidirezionale)" mostrerà quindi "In sincronizzazione".
Importa contatti (Provider → CRM)
- Apri Impostazioni → Integrazioni e trova la scheda del provider collegato.
- Nella sezione "Sincronizzazione contatti (bidirezionale)", clicca su "Importa contatti".
- Il CRM legge i tuoi contatti (fino a 200 alla volta) e crea o aggiorna un Contatto per ciascuno. Riporta quanti ne ha letti, creati e aggiornati.
Come funzionano corrispondenza e deduplicazione
La chiave di corrispondenza è l'EMAIL del contatto: se esiste già un Contatto con quell'email, viene aggiornato invece di duplicato; altrimenti ne viene creato uno nuovo. Il CRM memorizza anche l'id del contatto sul provider (sul record stesso) come ulteriore protezione anti-duplicati. Quando aggiorna un contatto esistente, il CRM compila solo i campi VUOTI e non sovrascrive mai nome, telefono o ruolo che hai già modificato nel CRM.
Invia un contatto del CRM al provider (CRM → Provider)
Puoi anche creare un contatto del CRM su Google/Outlook (best-effort). Una volta inviato, il CRM mantiene il collegamento in modo da non ricreare lo stesso contatto negli invii successivi. Questa direzione è opzionale e funziona solo con il permesso sui contatti concesso.
Nessuna connessione? La funzione resta inattiva
Se non hai collegato un account (o non hai concesso l'ambito contatti), non viene importato o inviato nulla e non ci sono errori nel tuo flusso di lavoro. Il pulsante di importazione appare solo quando esiste una connessione attiva con il permesso sui contatti.
Come testare
- In Impostazioni → Integrazioni → scheda del provider collegato, sezione "Sincronizzazione contatti (bidirezionale)", clicca su "Importa contatti".
- Controlla il riepilogo mostrato: quanti contatti sono stati letti, creati e aggiornati.
- Apri l'elenco Contatti del CRM e verifica che un contatto conosciuto da Google/Outlook sia comparso (o sia stato aggiornato) senza duplicazioni.
Risoluzione dei problemi
- Il pulsante "Importa contatti" non appare: non esiste una connessione con l'ambito contatti. Clicca su "Riconnetti" sulla scheda e concedi il permesso sui contatti (Google: contacts / People API; Microsoft: Contacts.ReadWrite).
- Alcuni contatti non sono arrivati: i contatti SENZA email vengono saltati (l'email è obbligatoria ed è la chiave di deduplicazione). Aggiungi un'email al contatto sul provider e importa di nuovo.
- Un contatto che avevo già modificato è stato "sovrascritto": non dovrebbe succedere. L'importazione compila solo i campi VUOTI e non sovrascrive mai nome/telefono/ruolo che hai modificato. Se noti una sovrascrittura, segnalala al supporto indicando il contatto.
- 403/permesso insufficiente: l'ambito contatti non è stato concesso; riconnetti e accetta il permesso nella schermata di consenso. Su Google, verifica che la People API sia abilitata nell'app OAuth.