V1 - Documentazione HubSpot - Google Contacts API Integration
Dal 12.02.2024 è operativa sul portale HubSpot di Ander Group un'integrazione sviluppata ad hoc per Google Contacts, in sostituzione della precedente App del Marketplace per l'integrazione tra le due piattaforme che risultava limitata nelle funzionalità disponibili.
Panoramica
L'integrazione è stata realizzata con lo scopo di automatizzare l'assegnazione dei contatti in Google Contacts alla cartella condivisa, che permette al resto del team di fruire degli indirizzi email e numeri di telefono tramite i vari dispositivi su cui si è loggati al proprio account Google di Ander Group.
In precedenza, questo step doveva essere svolto da Florian, prevedendo la ricerca periodica dei nuovi contatti in entrata da Google Contacts per assegnarli manualmente alla cartella condivisa.
Logica dell'integrazione
L'integrazione è basata su una nuova proprietà HubSpot denominata "Sync to Google Contacts", che se selezionata crea il contatto in Google Contacts e lo assegna automaticamente alla cartella condivisa "HubSpot Sync".
Tutti i contatti HubSpot con il flag su questa proprietà, invieranno aggiornamenti su Google Contacts in caso di modifiche future (vedi box sezione seguente con elenco proprietà sincronizzate).
La proprietà "Sync to Google Contacts" è accessibile tramite:
- Form di creazione nuovo contatto

- Sidebar sinistra pagina contatto esistente

Frequenza di aggiornamenti e condivisione
Le operazioni legate alla creazione e aggiornamento di contatti da sincronizzare avvengono in tempo reale.
È importante segnalare che i contatti vengono in prima battuta inseriti nell'account Google Contacts di fan@ander.group, mentre il meccanismo di condivisione al resto del team è gestito dal plug-in di terze parti Shared Contacts for Gmail, le quali avvengono con un delay non specificato.
Mappatura delle proprietà HubSpot
La tabella seguente riporta le proprietà HubSpot considerate dall'integrazione, la rispettiva tipologia e una breve nota sulla loro destinazione in Google Contacts.
Log delle operazioni
Le operazioni di avvenuta creazione dei contatti (no aggiornamenti) in Google Contacts sono automaticamente inviati come messaggio nel canale Slack #and-ecosystem-bot, se si desidera pertanto verificare la corretta creazione di un contatto in Google Contacts, subito dopo averlo creato in HubSpot, è possibile consultare dopo pochi secondi i messaggi del suddetto canale.

I messaggi di errore nelle operazioni svolte dall'integrazione sono anche esse riportate automaticamente su questo canale ma con menzione @mct, per immediata presa visione e intervento di risoluzione.