Il modo migliore per collegare WhatsApp a HubSpot con cronologia delle conversazioni nella scheda Contatto

Collega WhatsApp a HubSpot con una scansione del codice QR e un'autorizzazione OAuth — senza Business API. I messaggi si sincronizzano con la sequenza temporale del Contatto in HubSpot in pochi secondi, mostrati come attività WhatsApp raggruppata per giorno e per conversazione. Le chiamate vengono registrate a parte come Call Engagement. La configurazione richiede circa due minuti.

Per un team commerciale, la scheda Contatto è dove un affare vive davvero — non la casella di posta, non il telefono di chi vende. Se la conversazione WhatsApp che ha chiuso, bloccato o fatto perdere un affare non è su quel Contatto, la scheda è incompleta, per quanto bene sia configurato tutto il resto in HubSpot.

Un innesco comune per verificarlo: qualcuno del team chiude un affare quasi interamente su WhatsApp, poi un responsabile apre l'Affare in HubSpot aspettandosi di vedere come è successo — e trova una scheda Contatto senza alcuna conversazione, perché non è mai stato collegato nulla.

Questa guida copre ciò che la maggior parte delle guide di configurazione tralascia: esattamente come appare la cronologia delle conversazioni una volta collegata — su quale oggetto atterra, come viene raggruppata e cosa controllare se non c'è. Se non hai ancora collegato WhatsApp a HubSpot, qui trovi la configurazione completa; se stai cercando di capire perché i messaggi non arrivano affatto a HubSpot, inizia da qui invece.

Cosa significa davvero «cronologia delle conversazioni nella scheda Contatto»

Una conversazione WhatsApp si risolve in tre punti di HubSpot: la Sequenza temporale del Contatto, un'associazione con l'Affare corrispondente e — solo per le chiamate — un Call Engagement separato.

• Sequenza temporale del Contatto — ogni messaggio WhatsApp, in entrata e in uscita, viene registrato qui come attività WhatsApp.
• Associazione con l'Affare — la stessa conversazione si aggancia anche all'Affare corrispondente, così chi consulta un Affare vede la cronologia WhatsApp senza passare al Contatto.
• Call Engagement — le chiamate vocali e video di WhatsApp vengono registrate come un proprio tipo di oggetto, il Call Engagement nativo di HubSpot, non come attività di messaggio nella Sequenza temporale.

I messaggi si sincronizzano con la Sequenza temporale entro pochi secondi dall'invio o dalla ricezione. Ciò che vedi lì, però, è raggruppato: la sequenza temporale di HubSpot comprime l'attività dello stesso giorno di una conversazione in un'unica voce, espandibile fino allo scambio completo — lo stesso schema visivo che HubSpot usa per altri tipi di attività aggiornati di frequente, nulla di specifico per WhatsApp. Un messaggio di dieci minuti fa e uno di stamattina possono comparire nella stessa scheda compressa, il che è una scelta di visualizzazione, non un ritardo nella sincronizzazione.

Perché è importante: questa distinzione risolve la confusione più comune con questa integrazione. I dati sono già arrivati — semplicemente non vengono mostrati come una riga separata per messaggio dentro la scheda della Sequenza temporale. Espandi la voce del giorno per vedere tutto.

I segnali di installazioni e recensioni lo confermano al di là di una semplice affermazione: la scheda dell'integrazione nel Marketplace di HubSpot mostra 4,4 stelle su 53 recensioni e circa 3.000 installazioni — una base decisamente più ampia rispetto alla stessa integrazione su Pipedrive o Bitrix24, e vale la pena verificarla direttamente sulla piattaforma di HubSpot invece di darla per scontata.

Perché il tipo di account conta più di quanto dicano la maggior parte delle guide di configurazione

La maggior parte degli strumenti WhatsApp-verso-HubSpot, comprese le due integrazioni più spesso messe a confronto con questa, si basa sulla WhatsApp Business API — il che significa che un numero dedicato, approvato da Meta, è un prerequisito prima che possa iniziare qualsiasi sincronizzazione dei Contatti.

• L'integrazione HubSpot di wati richiede l'accesso alla WhatsApp Business API, disponibile solo sui piani a pagamento di wati, insieme a un piano HubSpot Professional o superiore. È davvero capace — sincronizzazione bidirezionale nativa, riepiloghi di conversazione con IA, creazione automatica di attività a partire dalle promesse fatte in chat — ma niente di tutto ciò parte finché non c'è un numero Business API attivo.
• L'integrazione HubSpot di respond.io si basa anch'essa sulla Business API, ma offre WhatsApp Coexistence come via più morbida — un numero esistente può entrare in modalità coesistenza invece di essere completamente disconnesso. È una differenza reale rispetto a un requisito più rigido di sola API, ma implica comunque la verifica Meta Business, non una semplice connessione via QR.

Perché è importante: se l'obiettivo è davvero vedere le conversazioni WhatsApp *esistenti* del tuo team — quelle che chi vende porta avanti da mesi sui propri numeri —, un requisito di Business API è un muro, non un passaggio di configurazione. Collegarsi via codice QR, come descritto più avanti, è ciò che rende raggiungibili quelle conversazioni esistenti fin dall'inizio.

Prima di iniziare

• Diritti di amministratore su HubSpot — per autorizzare l'app via OAuth.
• Qualsiasi account WhatsApp — WhatsApp normale, l'app Business o la Business API. Non serve alcuna approvazione Business API per collegarsi.
• Circa due minuti — una scansione QR più un'autorizzazione OAuth.

Passaggio 1: Collega il tuo account WhatsApp

Scansiona un codice QR dallo spazio di lavoro TimelinesAI, allo stesso modo in cui collegheresti WhatsApp Web. Passaggi completi di configurazione qui se vuoi il percorso completo — questa guida riprende da una connessione già effettuata.

Perché è importante: questo passaggio determina quali conversazioni esistono per essere sincronizzate. Collegare il tuo numero porta le sue conversazioni esistenti nell'ambito; un numero condiviso o senza titolare fisso richiede una connessione propria, trattata separatamente nella nostra guida sulle caselle condivise per i team HubSpot.

Passaggio 2: Autorizza HubSpot via OAuth

Autorizza l'app del Marketplace di HubSpot con un account amministratore. È un flusso OAuth standard — nessuna chiave API da generare, nessuna configurazione da sviluppatore.

Perché è importante: l'ambito OAuth determina su cosa l'integrazione può scrivere. Un'autorizzazione da amministratore è ciò che rende raggiungibili gli oggetti Contatto, Affare e Call Engagement — un utente autorizzante con restrizioni può ridurre silenziosamente cosa si sincronizza davvero.

Passaggio 3: Conferma che la corrispondenza dei contatti si risolva correttamente

Ogni messaggio viene associato a un Contatto tramite numero di telefono, e un nuovo Contatto viene creato automaticamente quando non c'è corrispondenza — la stessa logica di corrispondenza documentata per Pipedrive, che funziona qui sullo stesso meccanismo sottostante.

Perché è importante: corrispondenza e visualizzazione sono due meccanismi distinti. Un messaggio può essere correttamente associato al Contatto giusto nell'istante in cui arriva, pur comparendo ancora dentro una scheda giornaliera raggruppata della Sequenza temporale — cercare di risolvere un problema di «messaggio mancante» mettendo in dubbio la corrispondenza, quando il vero problema è solo il raggruppamento di visualizzazione del Passaggio 1, è un vicolo cieco comune.

Passaggio 4: Decidi cosa succede sugli Affari, non solo sui Contatti

Verifica che la conversazione si associ davvero all'Affare giusto, non solo al Contatto — merita uno sguardo deliberato invece di una supposizione, specialmente per un Contatto con più di un Affare aperto.

Perché è importante: una scheda Contatto con più Affari può lasciare ambiguità su a quale appartenga un thread WhatsApp. Confermarlo ora evita che chi vende controlli l'Affare sbagliato e perda proprio il contesto che lo spiega. Questo conta soprattutto nelle vendite basate su account, dove un Contatto può avere contemporaneamente un rinnovo, un upsell e una conversazione su un nuovo prodotto aperti — tre thread WhatsApp distinti che devono atterrare su tre Affari distinti, non fondersi in uno solo.

Passaggio 5: Attiva le azioni Workflow se vuoi l'automazione

I Workflow di HubSpot possono inviare un messaggio WhatsApp come azione nativa all'interno di qualsiasi automazione — una nuova fase dell'Affare, l'invio di un modulo, un follow-up programmato. È una funzione separata dalla cronologia delle conversazioni, da attivare solo se hai in mente un'automazione concreta, trattata in dettaglio altrove.

Perché è importante: le azioni Workflow e la sincronizzazione della Sequenza temporale sono sistemi indipendenti. Attivarne uno non influisce sull'altro, e trattarli come se fossero la stessa cosa in fase di risoluzione dei problemi fa perdere tempo.

Passaggio 6: Conferma che la cronologia arrivi davvero sulla scheda Contatto

Invia un messaggio di prova e conferma esattamente dove compare — è l'unico modo per sapere che la configurazione funziona davvero end-to-end, invece di darlo per scontato da uno stato di connessione verde.

1. Invia un messaggio WhatsApp da un numero con corrispondenza esistente in HubSpot.
2. Apri quella scheda Contatto in HubSpot.
3. Conferma che il messaggio compare nella Sequenza temporale, espandendo la voce del giorno se è compressa.
4. Apri l'Affare associato e conferma che la stessa conversazione sia visibile anche lì.
5. Se era una chiamata, conferma che compaia separatamente come Call Engagement, non dentro l'attività di messaggio della Sequenza temporale.

Questo video mostra la sincronizzazione end-to-end, incluso come messaggi, allegati e reazioni arrivano sul Contatto e sull'Affare.

Problemi comuni e risoluzione

Un messaggio sembra non esserci. Quasi sempre è dentro una scheda giornaliera compressa della Sequenza temporale, non mancante. Espandi la voce di quel giorno prima di supporre che la sincronizzazione sia fallita.

I messaggi finiscono sul Contatto sbagliato, o ne duplicano uno. È il meccanismo di corrispondenza, non un problema di visualizzazione — la stessa causa radice documentata per Pipedrive: record Contatto già duplicati in HubSpot confondono la corrispondenza per numero di telefono. Prima elimina i duplicati in HubSpot.

Una chiamata non compare dove te l'aspettavi. Le chiamate vengono registrate come Call Engagement, un oggetto diverso dall'attività di messaggio della Sequenza temporale usata per i testi. Controlla la sezione Chiamate della scheda Contatto, non la Sequenza temporale dei messaggi.

Le azioni Workflow non si attivano. È un sottosistema separato dalla sincronizzazione delle conversazioni. Conferma che il Workflow stesso sia attivo e che le condizioni di attivazione siano effettivamente soddisfatte prima di supporre un problema di connessione.

Non si sincronizza assolutamente nulla con HubSpot. Controlla prima la connessione WhatsApp, non il lato HubSpot — una connessione WhatsApp caduta appare identica a un errore di sincronizzazione di HubSpot visto dall'interno del CRM.

Domande frequenti

Serve la WhatsApp Business API per collegarsi a HubSpot?

No. Funzionano WhatsApp normale, l'app WhatsApp Business e la Business API. Non serve alcuna approvazione Business API per iniziare.

Il mio numero WhatsApp attuale funzionerà, o me ne serve uno nuovo?

Il tuo numero attuale funziona così com'è, collegato tramite codice QR — non serve disconnetterlo né migrarlo prima.

I messaggi compaiono sugli Affari, o solo sui Contatti?

Entrambi. La stessa conversazione viene registrata nella Sequenza temporale del Contatto e associata all'Affare corrispondente, così chi consulta l'una o l'altra scheda vede la cronologia.

Quanto velocemente si sincronizza davvero WhatsApp con HubSpot?

I messaggi si sincronizzano entro pochi secondi dall'invio o dalla ricezione. Ciò che compare nella Sequenza temporale è raggruppato per giorno e per conversazione ai fini della visualizzazione — uno schema dell'interfaccia HubSpot, non un ritardo nella sincronizzazione reale.

Le chiamate WhatsApp compaiono allo stesso modo dei messaggi?

No — le chiamate vengono registrate come Call Engagement di HubSpot, un oggetto separato dall'attività di messaggio della Sequenza temporale usata per le conversazioni testuali.

C'è un modo per verificare se questa integrazione è davvero affidabile?

La scheda del Marketplace di HubSpot mostra il numero di installazioni e la valutazione direttamente dalla piattaforma di HubSpot stessa — una fonte viva che si aggiorna da sola, a differenza di qualsiasi riepilogo di terze parti, incluso questo.

Più membri del team possono vedere la stessa cronologia di conversazione WhatsApp?

Sì, una volta sulla scheda Contatto, chiunque abbia accesso HubSpot a quel Contatto vede la cronologia sincronizzata completa — allo stesso modo in cui vedrebbe qualsiasi altra attività della Sequenza temporale. Gestire chi può rispondere da quale numero è una questione separata, di casella condivisa, non di visibilità della cronologia.

Un'agenzia può usarlo su più portali HubSpot?

Ogni portale HubSpot viene autorizzato separatamente tramite la propria connessione OAuth, quindi un'agenzia che gestisce più portali clienti ne collega ciascuno individualmente invece di condividere un'unica autorizzazione tra account.

Inizia ora

Collega WhatsApp a HubSpot e dai alle tue schede Contatto la cronologia delle conversazioni che manca loro. Inizia una prova gratuita — senza carta di credito.