I punti chiave
- Holded by Vexco abbina i record in quest'ordine: collegamento esistente, codice fiscale, email.
- Nei casi dubbi l'app non crea nulla: il caso va alla casella di revisione con i pulsanti «Merge», «Create new» e «Ignore».
- «Analyze duplicates» confronta i due sistemi in sola lettura, con circa una chiamata API di Holded ogni 100 record.
- La modalità di carico iniziale «Link only» collega i record presenti in entrambi i sistemi senza creare né modificare nulla.
- Con l'impostazione predefinita, se un record viene eliminato in un sistema l'app non lo cancella nell'altro: registra l'eliminazione e lascia a voi la decisione.
Perché nascono i duplicati
Quando Holded e HubSpot vivono separati per anni, ognuno costruisce il suo elenco di clienti. Il commerciale crea l'azienda in HubSpot con il nome che usa al telefono; l'amministrazione la crea in Holded con la ragione sociale e il codice fiscale. Al primo collegamento, senza regole chiare, lo stesso cliente rischia di comparire due volte da ogni lato. Le cause più frequenti:
- Nomi diversi: ragione sociale in Holded («Rossi Distribuzione S.r.l.»), nome commerciale in HubSpot («Rossi»).
- Codice fiscale in formati diversi: con o senza prefisso del paese, con spazi o trattini. Succede spesso con i clienti italiani di una società spagnola, che in un sistema hanno «IT» davanti alla partita IVA e nell'altro no.
- Email generiche: lo stesso indirizzo amministrativo usato per più società dello stesso gruppo.
- Persone di contatto: in Holded sono dentro la scheda dell'azienda, in HubSpot sono contatti associati all'azienda.
- Importazioni a mano o automazioni senza ricerca: un file CSV caricato due volte o uno Zap che crea senza cercare prima.
Un duplicato non è solo un fastidio estetico: le fatture finiscono su un record e le trattative sull'altro, il saldo del cliente risulta sbagliato e i report di vendita non tornano.
L'ordine di abbinamento: collegamento, codice fiscale, email
Per ogni azienda o contatto, Holded by Vexco cerca la corrispondenza nell'altro sistema in quest'ordine:
- Collegamento esistente: se i due record sono già collegati, vale il collegamento, anche se nel frattempo è cambiato il nome o l'email.
- Codice fiscale: il NIF/CIF o la partita IVA del cliente. È la chiave più affidabile per le aziende.
- Email: utile soprattutto per i privati e per le persone di contatto.
Se trova una corrispondenza chiara, collega. Se non trova nulla, applica quello che avete deciso nell'editor del flusso per i record che non esistono nell'altro sistema: crearli, non fare nulla o mandarli in revisione. Se il caso è dubbio, per esempio stessa email ma codice fiscale diverso o più candidati per lo stesso record, non fa nulla e manda il caso alla casella di revisione. Le chiavi di abbinamento si possono vedere e modificare nell'editor di ogni flusso.
La casella di revisione: casi e pulsanti
La casella di revisione raccoglie i casi che richiedono una decisione umana. Il numero di elementi in revisione è sempre visibile nella scheda Status.
| Tipo di caso | Esempio | Pulsanti |
|---|---|---|
| Possible duplicate | Un'azienda di HubSpot con la stessa email di un cliente di Holded ma con codice fiscale diverso | «Merge», «Create new», «Ignore» |
| Data conflict | Lo stesso campo è cambiato nei due sistemi e il flusso è impostato per chiedere a voi quale valore tenere | «Keep Holded», «Keep HubSpot» |
| Error | Un valore che il sistema di destinazione non accetta | «Retry», dopo aver corretto il dato |
«Merge» collega il record al candidato che scegliete, senza crearne un altro; «Create new» conferma che sono clienti diversi e crea quello mancante; «Ignore» lascia le cose come stanno. Ogni azione degli utenti resta nel registro attività, con chi l'ha fatta e quando.
Prima di attivare: «Analyze duplicates»
Il passaggio 5 della configurazione guidata, Duplicates, serve a sapere cosa succederà prima che succeda. Premendo «Analyze duplicates» l'app confronta i due sistemi in sola lettura, con un costo di circa una chiamata API di Holded ogni 100 record, e per ogni flusso vi dice quanti record sono «To be linked», quanti «To be created in HubSpot», quanti «To be created in Holded» e quanti sono «To review».
Se i numeri vi sorprendono, per esempio centinaia di aziende da creare in Holded quando vi aspettavate di trovarle già, fermatevi: di solito significa che il codice fiscale è scritto in formati diversi o manca in uno dei due sistemi. Sistemate i dati alla fonte e ripetete l'analisi, che non scrive nulla e si può rilanciare quante volte serve.
Al passaggio 6: scegliere la modalità di carico
Al passaggio 6, Initial load, decidete se e come trattare i dati esistenti. Le modalità sono tre:
| Modalità | Cosa fa | Quando sceglierla |
|---|---|---|
| Link only | Collega i record presenti in entrambi i sistemi; non crea e non modifica nulla | Per partire in sicurezza con dati già esistenti da entrambi i lati |
| Link and fill gaps | Collega e riempie i campi vuoti; non sovrascrive e non crea nulla | Quando un sistema ha dati che mancano nell'altro, come il codice fiscale in HubSpot |
| Full load | Collega, aggiorna secondo la regola del primo collegamento e crea quello che manca | Quando i dati sono puliti e volete due sistemi allineati |
Due opzioni riducono ancora il rischio. «Start with a sample» carica solo 5, 10, 25 o 50 record per flusso e poi si mette in pausa, così controllate il risultato in HubSpot prima del resto. «Simulate without writing» fa passare fino a 25 record per flusso nello stesso processo senza scrivere nulla da nessuna parte.
Consiglio: con dati già presenti nei due sistemi, partite con «Link only» e risolvete la casella di revisione. Solo dopo, se serve, rilanciate il carico con «Link and fill gaps» o «Full load» sui flussi che lo richiedono.
Igiene dei dati: cinque regole pratiche
- Un solo formato per il codice fiscale: decidete se la partita IVA dei clienti esteri va con o senza prefisso del paese e applicatelo in entrambi i sistemi. Togliete spazi, punti e trattini.
- Ragione sociale e nome commerciale separati: la ragione sociale nel nome dell'azienda in Holded, il nome commerciale nel campo dedicato. L'app sincronizza anche il nome commerciale, che compare sulla scheda dell'azienda in HubSpot.
- Persone di contatto come contatti: in HubSpot ogni persona deve essere un contatto associato all'azienda, con la sua email personale, non quella generica dell'ufficio.
- Privati e aziende distinti: i privati di Holded corrispondono ai contatti di HubSpot, le aziende alle aziende. Un privato registrato come azienda è un duplicato annunciato.
- Codice fiscale obbligatorio dove serve: nell'editor del flusso potete mettere una condizione come «solo clienti con codice fiscale», così i record incompleti non si sincronizzano finché qualcuno non li completa.
Se state ancora gestendo i dati con esportazioni e importazioni a mano, la pagina Holded by Vexco o esportazione manuale spiega quando ha ancora senso e quando no.
Dopo l'attivazione: tenere pulito nel tempo
Una volta attivata la sincronizzazione, i nuovi clienti seguono le stesse regole. Tre abitudini aiutano:
- guardate la casella di revisione una volta alla settimana, oppure affidatela a una persona;
- quando un abbinamento non vi convince, aprite il registro attività e usate «Show only this chain» per vedere tutta la sequenza di eventi di quel record, compresa la chiave con cui è stato abbinato;
- ricordate che, con l'impostazione predefinita dei flussi, eliminare un'azienda in HubSpot non la cancella in Holded: l'app registra l'eliminazione e decidete voi cosa farne. Le fatture restano sempre in Holded.
Le altre protezioni dell'app sono descritte nella pagina sulla sicurezza di Holded by Vexco, e la configurazione completa nella guida su come collegare Holded a HubSpot. Se i vostri dati richiedono una pulizia profonda prima del collegamento, per esempio dopo una migrazione da un altro CRM, il team di Vexco se ne occupa nei progetti di implementazione HubSpot.
Holded by Vexco
Installatela dal Marketplace di HubSpot, collegate la vostra società in Holded e partite in sola lettura. Non si sincronizza nulla finché non lo attivate voi.
Prova gratisDomande frequenti
L'app unisce da sola i record duplicati?
No. Holded by Vexco collega i record solo quando la corrispondenza è chiara, per collegamento, codice fiscale o email; nei casi dubbi manda il caso alla casella di revisione, dove scegliete voi tra «Merge», «Create new» e «Ignore».
Cosa succede se un cliente non ha codice fiscale?
L'app prova con l'email. Se non trova una corrispondenza, applica quello che avete deciso nell'editor del flusso: creare il record, non fare nulla o mandarlo in revisione. Potete anche aggiungere una condizione come «solo clienti con codice fiscale» per sincronizzare solo i record completi.
Se cancello un cliente in HubSpot, viene cancellato anche in Holded?
No, con l'impostazione predefinita. Quando un record viene eliminato in un sistema, l'app registra l'eliminazione ma non cancella nulla nell'altro; il comportamento si vede nell'editor di ogni flusso, alla voce «When a record is deleted». Le fatture e gli altri documenti restano comunque in Holded.
Quanta quota API di Holded consuma l'analisi dei duplicati?
Circa una chiamata ogni 100 record. L'analisi è in sola lettura e si può ripetere; prima del carico iniziale l'app mostra anche la stima delle chiamate rispetto alla quota mensile disponibile.
Posso usare la partita IVA italiana come chiave di abbinamento?
Sì. Il codice fiscale del cliente in Holded può essere una partita IVA italiana e l'app lo usa come chiave come qualsiasi altro codice fiscale. Conviene scriverlo nello stesso formato nei due sistemi, con o senza prefisso «IT», per evitare che lo stesso cliente sembri due clienti diversi.