Panoramica dell'integrazione HubSpot

Article author
Apollo Team
Aggiornato

Panoramica

L'integrazione di HubSpot con Apollo ti consente di accedere ai tuoi dati e mantenerli sincronizzati su entrambe le piattaforme.

Prima di integrare HubSpot con Apollo, però, ci sono diversi dettagli importanti da ricordare che possono aiutarti a semplificare il processo di configurazione e ridurre il rischio di errori non necessari durante l'integrazione di HubSpot.

Esistono due versioni dell'integrazione. Puoi decidere quale usare quando integri HubSpot con Apollo.

HubSpot CRM Questa integrazione consente una sincronizzazione bidirezionale tra HubSpot e Apollo. Puoi inviare e importare contatti, account e trattative, oltre a inviare attività a HubSpot, inclusi i record di chiamate, email, riunioni, task e note creati in Apollo.
Arricchimento dati HubSpot Questa integrazione è solo per l'arricchimento. Usa il database di Apollo per arricchire i record HubSpot esistenti. Questa integrazione non include la sincronizzazione completa bidirezionale né l'invio di record per contatti, account, trattative o attività. Per sincronizzare o inviare dati, usa invece HubSpot CRM.

Consulta le sezioni seguenti per saperne di più sull'integrazione HubSpot in Apollo.

Torna all'inizio

Come funziona

Una volta collegato HubSpot CRM ad Apollo, l'integrazione mantiene allineati i tuoi dati importando e inviando continuamente record tra entrambe le piattaforme.

  • Tempistiche: la maggior parte delle sincronizzazioni di invio e importazione per contatti e aziende si completa entro 15-30 minuti dalla creazione o dall'aggiornamento di un record, soprattutto per piccoli lotti. Tuttavia, le sincronizzazioni in blocco di grandi dimensioni o la sincronizzazione iniziale possono richiedere più tempo. Inoltre, trattative e attività possono impiegare più tempo per comparire completamente e, in base al volume e ai limiti dell'API di HubSpot, potrebbero richiedere fino a 24 ore per essere completate.
  • Importazione da HubSpot: Apollo importa automaticamente contatti, account e trattative da HubSpot su base ricorrente. Questo garantisce che il tuo team possa vedere i record CRM esistenti durante la ricerca di potenziali clienti in Apollo e aiuta a evitare che il team contatti per errore record già esistenti in HubSpot. Apollo usa gli identificatori disponibili e i dettagli del profilo per associare ogni record HubSpot al record Apollo corretto. Apollo controlla prima l'ID del contatto, l'ID contatto HubSpot e gli ID CRM uniti in precedenza. Se non c'è una corrispondenza diretta, Apollo usa altri segnali come email verificata, URL LinkedIn e nome, oltre al contesto aziendale. Per le aziende, Apollo controlla prima gli ID diretti dell'azienda o dell'account, poi gli ID account CRM, l'ID organizzazione Apollo, il dominio aziendale e il nome dell'azienda.
  • Invio a HubSpot: le impostazioni di invio controllano come Apollo rimanda i dati a HubSpot. Puoi scegliere quando inviare contatti, account, trattative ed email in base a condizioni specifiche, come fase, stato di verifica dell'email o criteri dei campi personalizzati. Apollo invia automaticamente anche gli aggiornamenti ai record esistenti quando si verificano modifiche. È supportato anche l'invio in blocco e manuale, così puoi selezionare più contatti, account o trattative e inviarli a HubSpot. Per selezioni di grandi dimensioni, l'invio viene eseguito in background.
  • Attività: oltre ai record CRM, Apollo può inviare a HubSpot anche i dati delle attività. Sono incluse email, task, note, riepiloghi delle riunioni dalle conversazioni e chiamate telefoniche create in Apollo. La sincronizzazione delle attività è controllata separatamente nelle impostazioni di invio e richiede che il contatto, l'account o la trattativa correlati esistano in HubSpot.
  • Mappatura dei dati: la mappatura di campi e fasi definisce come i dati sono strutturati tra i due sistemi. La mappatura garantisce che i valori di Apollo corrispondano alle proprietà corrette in HubSpot, mentre le regole di scrittura dei dati determinano se Apollo compila i campi vuoti o sovrascrive i valori esistenti in HubSpot. Insieme, le impostazioni di sincronizzazione e la mappatura dei campi consentono ad Apollo di rispecchiare i tuoi dati HubSpot, dandoti al tempo stesso il controllo su quali dati vengono aggiornati e quando.

Torna all'inizio

Per iniziare

  1. Collega l'integrazione: collega HubSpot in Apollo tramite le integrazioni. Scegli tra HubSpot CRM per la sincronizzazione completa o Arricchimento dati HubSpot solo per l'arricchimento.
  2. Mappatura dei dati: se usi la versione HubSpot CRM dell'integrazione, mappa prima i campi e le fasi in Apollo ai campi in HubSpot in modo che tutto fluisca correttamente. Puoi anche impostare regole di scrittura dei dati per sfruttare al massimo l'arricchimento CRM di Apollo e condividere i dati Apollo aggiornati con HubSpot.
  3. Impostazioni di sincronizzazione: successivamente, configura le impostazioni di sincronizzazione per determinare quando i dati passano tra HubSpot e Apollo.
Finestra di opportunità

Per i piani Apollo a pagamento, dopo aver abilitato l'integrazione HubSpot c'è una finestra di 6 ore per configurare le impostazioni di sincronizzazione e mappare i campi. Questo dà al tuo team il tempo necessario per configurare correttamente l'integrazione. Durante questo periodo, non puoi importare manualmente i record. Dopo sei ore, la sincronizzazione viene abilitata automaticamente.

Hai perso la finestra? Puoi comunque modificare le impostazioni di sincronizzazione in qualsiasi momento. Vai a Impostazioni > Integrazioni > HubSpot per rivedere o aggiornare le impostazioni di sincronizzazione. I Record già importati non vengono recuperati di nuovo automaticamente se restringi le condizioni. Usa invece Recupera tutto per recuperarli di nuovo con le nuove impostazioni.

Torna in alto

Evita Record duplicati

Quando integri HubSpot, Apollo rispecchia i dati presenti in HubSpot. Se hai contatti o account duplicati in HubSpot, questi duplicati si riflettono anche in Apollo. Per evitare Record duplicati, pulisci e rimuovi i duplicati dalla tua istanza HubSpot prima di integrarla con Apollo.

Se Apollo recupera un duplicato da HubSpot, mostra Potenziale duplicato sul contatto o sull'account e nel registro attività.

Quando crei manualmente un Record duplicato in HubSpot, Apollo crea automaticamente lo stesso Record. Allo stesso modo, se abiliti le impostazioni di push di HubSpot e crei un Record duplicato in Apollo, HubSpot crea lo stesso Record all'interno di HubSpot.

Apollo non elimina né unisce automaticamente i duplicati che crei manualmente. Se decidi di eliminare o unire uno qualsiasi di questi Record, devi unirli manualmente o eliminarli.

Quando Apollo recupera aziende da HubSpot, abbina ogni azienda HubSpot a un account Apollo esistente nel seguente ordine:

  • ID azienda HubSpot: se un account Apollo è già collegato a un'azienda HubSpot, Apollo aggiorna quell'account con i dati recuperati, inclusi eventuali campi personalizzati.
  • Dominio: se nessun account Apollo è collegato tramite ID azienda, Apollo cerca un account con un dominio che corrisponde esattamente. Il dominio viene preso dal sito web o dal campo dominio dell'azienda HubSpot, rimuovendo protocollo e percorso. I sottodomini vengono trattati come domini diversi, quindi corporate.sumware.com e sumware.com non corrispondono.
  • Nome: se non viene trovata alcuna corrispondenza né per ID azienda né per dominio, Apollo abbina in base al nome dell'azienda.

Quando non viene trovata alcuna corrispondenza, Apollo crea un nuovo account e applica a quel nuovo account i dati recuperati, inclusi i campi personalizzati. In questo caso, l'account che ti aspettavi potrebbe non ricevere l'aggiornamento.

Per la risoluzione dei problemi:

  1. Cerca in Apollo il nome dell'azienda o il dominio per verificare se esiste un account duplicato.
  2. Aggiorna il sito web o il campo dominio dell'azienda HubSpot in modo che corrisponda esattamente al dominio dell'account Apollo previsto, quindi recupera di nuovo i dati o attendi la prossima sincronizzazione.
  3. Conferma che il campo sia mappato in Impostazioni > Integrazioni > HubSpot > Account > Mappatura campi.
  4. Se è stato creato un account duplicato, uniscilo con l'account corretto in Apollo dopo aver corretto il dominio.

Torna all'inizio

Visualizza errori

Usa il log degli errori dell'integrazione HubSpot per visualizzare e risolvere i problemi di sincronizzazione. Il log degli errori mostra gli errori che Apollo riceve quando invia informazioni a HubSpot. Questi errori sono risposte di HubSpot che di solito indicano una limitazione di HubSpot, ad esempio il raggiungimento di una regola di convalida personalizzata o dei limiti di frequenza per la tua istanza connessa. Consulta alcune domande frequenti sugli errori di sincronizzazione.

Torna all'inizio

FAQ

Domande frequenti

Quali dati posso sincronizzare con HubSpot? Come funziona la proprietà di un contatto o di un account quando invii record a HubSpot? Perché le mie attività non vengono sincronizzate con HubSpot?
Come funziona invio vs recupero per HubSpot? Cosa significano gli errori di sincronizzazione HubSpot più comuni? Apollo controlla lo stato dei contatti marketing di HubSpot?
 
Hai altre domande?

Consulta Configura le impostazioni di sincronizzazione di HubSpot per trovare risposte ad altre FAQ.

Quali dati posso sincronizzare con HubSpot?

Dipende dall'integrazione HubSpot che usi.

Con HubSpot CRM, Apollo può sincronizzare contatti, account e trattative tra entrambe le piattaforme. Apollo invia anche attività, come Email, chiamate, riunioni, Task e note, da Apollo a HubSpot.

Apollo invia e recupera dati usando contatti e aziende, non Lead. Apollo non supporta i lead di HubSpot, le fasi di avanzamento dei lead o altre proprietà specifiche dei lead. Non vedrai l'oggetto Leads o le proprietà correlate durante la configurazione dell'integrazione in Apollo.

Con HubSpot Data Enrichment, Apollo arricchisce solo i record HubSpot esistenti. Questa versione non supporta la sincronizzazione o l'invio di contatti, account, trattative o attività.

Torna alle FAQ

Come funziona la proprietà di un contatto o di un account quando invii record a HubSpot?

Quando invii contatti o account a HubSpot, la proprietà dipende dal fatto che l'utente che invia il record abbia collegato le proprie credenziali HubSpot personali in Apollo. Per gli invii di singoli record, la proprietà può basarsi sull'account HubSpot collegato dell'utente che effettua l'invio. Per gli invii in blocco, la proprietà può dipendere anche dalla configurazione di autenticazione del tuo team.

Se il tuo team usa l'autenticazione di sincronizzazione del team, un utente funge da connessione principale tra Apollo e HubSpot. Poiché le autorizzazioni di HubSpot possono variare in base all'oggetto e al campo, l'utente autenticato deve avere le autorizzazioni di lettura e scrittura appropriate per tutto ciò che il tuo team sincronizza.

Torna alle FAQ

Perché le mie attività non vengono sincronizzate con HubSpot?

Le attività potrebbero non sincronizzarsi se le relative impostazioni di sincronizzazione non sono abilitate o se i record correlati non sono stati inviati prima. Per sincronizzare le attività con HubSpot, devi abilitare i tipi di attività specifici che vuoi inviare, come Email, Task, note, riepiloghi delle riunioni o chiamate telefoniche.

Per far funzionare in modo affidabile la sincronizzazione delle attività, assicurati di inviare anche i contatti, gli account o le trattative correlati. Apollo consiglia di inviare prima i contatti, gli account o le trattative correlati, perché la sincronizzazione delle attività può non riuscire se i record associati non esistono in HubSpot. In particolare, per i riepiloghi delle riunioni devi anche abilitare e usare le trattative in Apollo, perché Apollo invia i riepiloghi delle riunioni come attività o nota a una trattativa associata in HubSpot.

Se le attività Email continuano a non sincronizzarsi, controlla se i filtri di esclusione le stanno bloccando oppure se il mittente o il destinatario non esiste in HubSpot e l'impostazione per inviare quelle Email non è abilitata.

Torna alle FAQ

Come funziona push vs pull per HubSpot?

Push invia i dati da Apollo a HubSpot quando le regole sono soddisfatte. Pull importa i dati da HubSpot in Apollo.

Torna alle FAQ

Cosa significano i comuni errori di sincronizzazione di HubSpot?

Ecco gli errori più comuni e come risolverli:

account_upsert_failed In genere, questo indica un'incompatibilità del tipo di mappatura del campo settore tra Apollo e HubSpot.

Soluzione:
  • Aggiorna il campo settore di HubSpot in modo che includa tutti i valori di Apollo esattamente, quindi mappa i campi.
  • Oppure mappa i settori di Apollo a un campo di testo su singola riga in HubSpot per evitare restrizioni di convalida.
Authorization failed In genere, questo indica che tu, o l'utente che ha collegato l'integrazione, non avete autorizzazioni sufficienti per eseguire l'azione in HubSpot.

Soluzione: Aggiorna le tue autorizzazioni in HubSpot oppure ricollega l'integrazione usando un account con autorizzazioni complete.
Property values were not valid Questo errore si verifica comunemente durante la sincronizzazione del campo settore tra Apollo e HubSpot.

Se HubSpot usa una proprietà a discesa, richiede corrispondenze esatte con i suoi valori interni, incluse maiuscole/minuscole e ortografia. Se Apollo invia un valore che non corrisponde, HubSpot lo rifiuta.

Soluzione: Usa uno dei seguenti approcci:

  • Aggiorna il menu a discesa del settore in HubSpot in modo che includa tutti i valori di Apollo esattamente, quindi mappa i campi.
  • Oppure mappa i settori di Apollo a un campo di testo su singola riga in HubSpot per evitare restrizioni di convalida.
Dopo l'aggiornamento, sincronizza di nuovo un Record di test e controlla il log degli errori dell'integrazione, se necessario.

Per istruzioni dettagliate sulla mappatura, vedi Configurare la mappatura dei dati di HubSpot.

Torna alle FAQ

Apollo controlla lo stato del contatto marketing in HubSpot?

No, Apollo non imposta né gestisce lo stato del contatto marketing in HubSpot.

Apollo sincronizza i dati di contatti e account, ma è HubSpot a controllare come vengono classificati i contatti, incluso lo stato del contatto marketing.

Se devi gestire la designazione del contatto marketing, ad esempio per la conformità al GDPR o per la fatturazione, configurala direttamente nelle impostazioni di HubSpot.

Torna alle FAQ

Torna in alto

Passaggi successivi

Ecco alcune risorse utili per guidarti nella configurazione dell'integrazione:

Integra HubSpot con Apollo Configura il Integrazione HubSpot per iniziare a sincronizzare i tuoi Record CRM con Apollo.
Configura le impostazioni di sincronizzazione di HubSpot Configura le tue impostazioni di sincronizzazione di HubSpot per avere più controllo sul flusso dei dati.
Configura la mappatura dei dati di HubSpot Configura le regole di mappatura dei dati per l'integrazione HubSpot, così i campi si sincronizzano esattamente come serve al tuo team.
Segui la mappatura predefinita dei campi consigliata Valuta di mappare i campi consigliati di Apollo al tuo CRM per evitare discrepanze nei dati: in futuro ti ringrazierai quando le sincronizzazioni funzioneranno senza problemi.

Torna in alto