Integrazione HubSpot

Importa contatti e aziende da HubSpot in BladeCRM.

Cosa Puoi Fare

• ✅ Importare contatti da HubSpot
• ✅ Importare aziende (companies)
• ✅ Mappare i campi personalizzati
• ✅ Gestire duplicati automaticamente
• ✅ Importazioni selettive o complete

Connettere HubSpot

Prerequisiti

• Account HubSpot (Free, Starter, Professional, Enterprise)
• Accesso admin al tuo account HubSpot

Processo

1. Vai su Importa nella dashboard BladeCRM
2. Sezione Integrazioni CRM
3. Clicca Connetti HubSpot
4. Accedi al tuo account HubSpot
5. Autorizza BladeCRM a:
   • Leggere i contatti
   • Leggere le aziende
6. Verrai reindirizzato a BladeCRM

Verifica Connessione

Dopo la connessione:

• La card HubSpot mostra "Connesso"
• Vedi il nome del tuo portale HubSpot
• Puoi iniziare ad importare

Importare Contatti

Processo

1. Clicca sulla card HubSpot connessa
2. Seleziona Contatti
3. Attendi il caricamento dei record
4. Usa la ricerca per trovare contatti specifici
5. Seleziona i contatti da importare:
   • Checkbox singole
   • "Seleziona tutti" per tutti
6. Configura gestione duplicati:
   • Salta: Mantieni esistenti
   • Aggiorna: Sovrascrivi con dati HubSpot
7. Clicca Importa selezionati

Campi Importati

Campo HubSpot	Campo BladeCRM
firstname	Nome
lastname	Cognome
email	Email
phone	Telefono
mobilephone	Cellulare
company	Azienda
jobtitle	Titolo
website	Sito Web

Ricerca

La ricerca funziona su:

• Nome e cognome
• Email
• Azienda

Clicca Cerca su HubSpot per una ricerca più approfondita via API.

Importare Aziende

Processo

1. Nella pagina import HubSpot
2. Seleziona Aziende (invece di Contatti)
3. Visualizza le aziende disponibili
4. Seleziona e importa

Campi Importati

Campo HubSpot	Campo BladeCRM
name	Nome
domain	Sito Web
phone	Telefono
industry	Settore
numberofemployees	Dipendenti
city	Città
country	Paese

Gestione Duplicati

Come Funziona

BladeCRM identifica i duplicati basandosi su:

• Email per i contatti
• Dominio/Nome per le aziende

Opzioni

Opzione	Comportamento
Salta	Il record BladeCRM esistente non viene modificato
Aggiorna	I campi vengono sovrascritti con i dati HubSpot

Sincronizzazione

Nota

L'integrazione HubSpot è attualmente solo import. I dati non vengono sincronizzati automaticamente o esportati verso HubSpot.

Per aggiornare i dati:

1. Ripeti l'import
2. Seleziona "Aggiorna" per i duplicati
3. I record vengono aggiornati

Troubleshooting

Token Scaduto

Se vedi "Token scaduto":

1. Disconnetti l'integrazione
2. Riconnetti HubSpot
3. Riautorizza

Pochi Record Trovati

Se non vedi tutti i contatti:

• Verifica i permessi del tuo utente HubSpot
• Usa la funzione "Cerca su HubSpot" per ricerche specifiche

Errore 403

Se ricevi errori di permesso:

1. Disconnetti
2. Riconnetti
3. Assicurati di autorizzare tutti i permessi richiesti

Best Practices

• ✅ Fai un backup dei dati BladeCRM prima di import grandi
• ✅ Testa con pochi record prima di import massivi
• ✅ Verifica la mappatura campi
• ✅ Pulisci i duplicati in HubSpot prima di importare

---

Suggerimento

Importa prima le aziende, poi i contatti. Così i contatti si collegheranno automaticamente alle aziende esistenti.