Come configurare HubSpot WhatsApp MCP con Claude o ChatGPT (testato)

La tua pipeline vive in HubSpot. Le conversazioni che la muovono avvengono su WhatsApp — sul telefono di ogni commerciale, nei gruppi con i clienti, a tarda sera. TimelinesAI sincronizza già quelle chat con il contatto e la trattativa giusti in HubSpot, quindi non si perde nulla quando un commerciale è assente o lascia l'azienda.

Questa guida copre il passo successivo: fare domande che richiedono entrambe le fonti insieme. Quali trattative sono rimaste in silenzio? Cosa ha detto davvero il cliente? Chi nel team deve ancora una risposta? Con il connettore ufficiale di HubSpot e il server MCP di TimelinesAI attivati nella stessa chat IA, puoi chiedere esattamente questo, in linguaggio naturale, e ottenere un'unica risposta.

Abbiamo configurato tutto questo sul nostro account HubSpot e nel nostro workspace WhatsApp prima di scrivere una parola. Tutto quello che segue è ciò che abbiamo visto, compreso ciò che non ha funzionato al primo tentativo.

Punti chiave

• Il connettore di HubSpot sa quando hai parlato l'ultima volta con un cliente su WhatsApp. Non può vedere cosa è stato detto. Il server MCP di TimelinesAI legge la conversazione.
• Attiva entrambi nella stessa chat — in Claude, ChatGPT o un altro assistente che accetta un server MCP remoto — e chiedi "quali trattative ci stanno aspettando" in linguaggio naturale. La configurazione richiede circa 10 minuti, senza codice.
• HubSpot può restare in sola lettura. Ogni domanda di questa guida funziona con i suoi permessi predefiniti.
• Abbina i clienti per numero di telefono, non per nome, e raggruppa "chi sta aspettando" per assegnatario WhatsApp, non per proprietario della trattativa.
• Nessun costo aggiuntivo da TimelinesAI o HubSpot. L'MCP di WhatsApp è incluso nel tuo piano TimelinesAI, e i connettori di HubSpot sono disponibili a ogni livello. Ti serve solo un piano IA a pagamento.

Cosa significa "HubSpot WhatsApp MCP"

MCP (Model Context Protocol) è lo standard aperto che gli assistenti IA usano per collegarsi ad altre app. Una configurazione HubSpot WhatsApp MCP significa che il tuo assistente IA — Claude, ChatGPT o un altro — è collegato a due server MCP allo stesso tempo:

• Il connettore ufficiale di HubSpot — la connessione di HubSpot stessa al tuo CRM, disponibile per Claude, ChatGPT, Microsoft 365 Copilot e Gemini.
• Il server MCP WhatsApp di TimelinesAI — la connessione alle conversazioni WhatsApp del tuo team, su tutti i numeri.

Non scrivi codice né esegui alcun server. Aggiungi due connettori al tuo assistente, ed è lui a decidere quale interpellare per ogni parte della tua domanda.

Non sostituisce la sincronizzazione. TimelinesAI continua a copiare ogni conversazione in HubSpot come fa oggi. L'MCP è il modo per fare domande che coprono entrambe.

Quali assistenti IA funzionano

Ti serve un assistente in grado di mantenere entrambe le connessioni contemporaneamente. HubSpot offre una connessione ufficiale per quattro assistenti. TimelinesAI si collega a qualsiasi assistente che accetti un server MCP remoto.

Abbiamo eseguito tutti i test di questa guida con Claude. Il connettore di HubSpot per ChatGPT funziona con lo stesso modello di permessi — un Super Admin lo approva e sceglie a cosa può accedere — quindi la configurazione, i prompt e le insidie valgono allo stesso modo.

Cosa può fare ogni connettore e cosa no

In una frase: il connettore di HubSpot sa quando hai parlato l'ultima volta con un cliente. TimelinesAI sa cosa è stato detto. Ti servono entrambi per rispondere a "chi ci sta aspettando".

Il connettore di HubSpot, in dettaglio

HubSpot elenca tutto ciò che il suo connettore può essere autorizzato a fare nella schermata che vedi quando lo colleghi.

• Per impostazione predefinita: leggere contatti, aziende, trattative e ticket.
• Con permessi di lettura opzionali: note, chiamate, riunioni, attività, email singole, conversazioni della posta in arrivo, utenti e team, lead, liste, preventivi, fatture e altro ancora.
• Con permessi di scrittura opzionali: creare e aggiornare contatti, aziende, trattative, ticket, note, attività e altro ancora. L'accesso in scrittura deve essere concesso da un Super Admin di HubSpot.
• Non disponibile a nessun livello di permesso: inviare un messaggio su qualsiasi canale, rispondere o assegnare una conversazione della posta in arrivo, e il tipo di record che HubSpot usa per i messaggi WhatsApp registrati.

Il server MCP di TimelinesAI, in dettaglio

34 strumenti, che coprono i numeri dell'app WhatsApp Business e i numeri dell'API WhatsApp Business per tutto il tuo team:

• Trovare e leggere: cercare chat per telefono, nome, etichetta, membro del team o stato di lettura; leggere lo storico completo, incluse le chat di gruppo; vedere se la finestra di 24 ore di una chat API è ancora aperta.
• Organizzare: assegnare o rimuovere un membro del team, aggiungere o rimuovere etichette, chiudere o riaprire una chat.
• Agire (impostale per chiedere prima l'approvazione): inviare un messaggio, rispondere a un messaggio specifico, reagire, inviare un modello approvato, avviare una nuova chat API.
• Workspace: elencare i tuoi numeri, il tuo team e il tuo utilizzo.

Come funzionano insieme i due connettori

Prendi la domanda "quali delle mie trattative sono rimaste in silenzio, e perché". Il tuo assistente risponde in quattro mosse:

1. Tu fai la domanda in linguaggio naturale, in una chat normale.
2. HubSpot trova le trattative senza attività recente, i loro contatti e numeri di telefono.
3. TimelinesAI trova la chat di ogni cliente in base al numero di telefono e legge gli ultimi messaggi.
4. Il tuo assistente combina entrambe le fonti in un'unica risposta: chi sta aspettando, da quando e su cosa.

Se poi chiedi una risposta, l'assistente la redige, tu la approvi, e TimelinesAI la invia dal numero del tuo team. Il messaggio arriva nella tua posta in arrivo condivisa e nel record di HubSpot, come qualsiasi altro messaggio WhatsApp.

Quattro modi per collegare HubSpot, WhatsApp e IA

Se stai scegliendo una configurazione, ecco come si differenziano le opzioni.

Se il tuo team usa già WhatsApp tramite il canale di posta in arrivo proprio di HubSpot, il connettore di HubSpot può leggere quei thread — ma non può ancora rispondere. Se sei su qualsiasi altro livello HubSpot, usi numeri dell'app WhatsApp Business, o vuoi che il tuo assistente agisca su una conversazione, ti serve un connettore WhatsApp in più.

Prima di iniziare

• Un assistente IA che supporti entrambi i connettori: Claude su un piano a pagamento (Pro, Max, Team o Enterprise), o ChatGPT su Plus, Pro, Business, Enterprise o Education.
• HubSpot a qualsiasi livello, incluso Free e Starter, e un account utente HubSpot.
• TimelinesAI con l'integrazione HubSpot attivata, e i numeri del tuo team collegati. L'MCP di WhatsApp è incluso nel tuo piano. Sei alle prime armi? Inizia da sincronizzare WhatsApp con HubSpot.
• Permesso di collegare app in HubSpot. Gli utenti con accesso all'App Marketplace possono collegarsi direttamente; tutti gli altri hanno bisogno che un Super Admin approvi prima il connettore.
• Un piano IA adatto al tuo volume. Le domande occasionali funzionano bene con i piani a pagamento standard. Un team che lo fa ogni mattina su una casella grande consuma molto di più — la nostra guida alla configurazione di WhatsApp MCP ha numeri misurati.

Configuralo in Claude (circa 10 minuti)

Passo 1: Collega HubSpot

In Claude, vai su Personalizza → Connettori, cerca HubSpot e clicca su Collega. Accedi a HubSpot e scegli il tuo account.

HubSpot ti mostra quindi a cosa può accedere Claude. Le impostazioni predefinite — leggere contatti, aziende, trattative e ticket — bastano per tutte le domande di questa guida. Se vuoi di più, seleziona solo i permessi di Visualizzazione:

• Note, chiamate, riunioni e attività — per "cosa è successo su questa trattativa"
• Utenti e team — così "le mie trattative" funziona senza digitare il tuo nome
• Eseguire query — per totali e ripartizioni su tutta la pipeline

Non ti serve nulla che dica crea, modifica o pubblica. Se queste opzioni sono in grigio, un Super Admin di HubSpot deve abilitarle.

Passo 2: Collega TimelinesAI

Sempre in Personalizza → Connettori, clicca su +, poi su Aggiungi connettore personalizzato. Chiamalo TimelinesAI e incolla l'URL del server: https://mcp.services.timelines.ai/mcp. Clicca su Aggiungi, poi su Collega, accedi a TimelinesAI e approva. Non c'è nessuna chiave API da copiare.

Su un piano Team o Enterprise, un Owner aggiunge il connettore una sola volta in Impostazioni organizzazione → Connettori; poi ogni persona collega il proprio account (la guida di Claude).

Infine, apri le impostazioni degli strumenti di ogni connettore e imposta tutto ciò che invia, aggiorna o assegna su richiesta di approvazione. HubSpot consiglia lo stesso per il proprio connettore.

Passo 3: Attiva entrambi nella stessa chat

In una nuova chat, clicca su + in basso a sinistra, apri Connettori, e assicurati che HubSpot e TimelinesAI siano entrambi attivi. I connettori si attivano per ogni conversazione.

Passo 4: Verifica che funzioni

Fai due domande rapide. Se rispondono entrambe, sei pronto:

Quante trattative aperte abbiamo in HubSpot, per fase?

Elenca i nostri numeri WhatsApp in TimelinesAI e indica se ognuno è collegato.

La prima domanda è di HubSpot; la seconda, di TimelinesAI.

Configuralo in ChatGPT

1. Collega HubSpot. Aggiungi il connettore HubSpot per ChatGPT e accedi. Si applicano la stessa approvazione del Super Admin e gli stessi permessi sui dati di Claude.
2. Attiva la modalità sviluppatore. In ChatGPT sul web, apri Impostazioni → Sicurezza e accesso e attiva la Modalità sviluppatore. È disponibile su Plus, Pro, Business, Enterprise ed Education; su un account aziendale, il tuo amministratore potrebbe doverla abilitare (la guida di OpenAI).
3. Aggiungi TimelinesAI. Crea un'app in modalità sviluppatore con l'URL del server https://mcp.services.timelines.ai/mcp, poi accedi a TimelinesAI.
4. Fai domande con entrambi attivi. Attiva TimelinesAI per la chat e includi la parola "HubSpot" nella tua domanda — è il consiglio di HubSpot stessa per far intervenire il suo connettore.
5. Mantieni le azioni soggette ad approvazione. Imposta il connettore di HubSpot in modo che chieda l'approvazione prima degli aggiornamenti, come consiglia HubSpot, e rivedi ogni invio proposto prima di confermarlo.

Configuralo in Claude Code, Cursor o Codex

Per analisti e team tecnici. TimelinesAI richiede una sola riga di configurazione in ogni strumento — gli snippet sono nella nostra guida alla configurazione di WhatsApp MCP. Sul lato HubSpot, gli sviluppatori si collegano al server MCP remoto di HubSpot, che richiede un'app di autenticazione MCP di HubSpot. Abbiamo eseguito i test di questa guida da Claude Code con entrambi i connettori collegati.

Una revisione della pipeline del lunedì, dall'inizio alla fine

Questa è la domanda che giustifica tutta la configurazione. Chiedi:

Mostrami le mie trattative aperte senza attività negli ultimi 7 giorni. Per ognuna, trova la conversazione WhatsApp del cliente in TimelinesAI e dimmi cosa ha detto per ultimo e se abbiamo risposto.

Dietro le quinte, HubSpot trova le trattative silenziose e il numero di telefono di ogni contatto; TimelinesAI trova la chat di ciascuno in base a quel numero e legge gli ultimi messaggi. La risposta torna come un'unica tabella: quali trattative ti stanno aspettando, da quando e su cosa.

Poi chiedi i follow-up, senza inviare nulla:

Redigi un breve follow-up per i tre che ci stanno aspettando, nella lingua in cui hanno scritto. Non inviare nulla.

Il tuo assistente redige ogni risposta nella lingua del cliente. Quando dici "invia la prima", chiede l'approvazione prima che TimelinesAI invii qualcosa. Niente raggiunge un cliente finché non lo autorizzi.

Libreria di prompt

Copiali così come sono, o sostituisci con le tue fasi, nomi e intervalli di tempo. Altre idee nei casi d'uso di WhatsApp MCP.

Pipeline

• "Quali trattative nella fase Contratto inviato si chiudono questo mese e non hanno avuto attività per 7 giorni? Per ognuna, cosa ha detto per ultimo il cliente su WhatsApp?"
• "Prima della mia chiamata con [azienda]: riassumi la trattativa in HubSpot e i nostri ultimi 30 messaggi WhatsApp con loro."
• "Quali trattative sono andate avanti questa settimana su WhatsApp ma restano nella stessa fase in HubSpot?"

Team

• "Quali clienti ci hanno scritto per ultimi e non hanno ancora ricevuto risposta? Dal più vecchio al più recente, con il membro del team assegnato."
• "A quanti clienti ogni membro del team deve ancora una risposta in questo momento?"
• "Quali chat WhatsApp di questa settimana non sono assegnate a nessuno?"

Cliente

• "Cosa abbiamo promesso a [azienda] su WhatsApp questo mese, e l'abbiamo mantenuto?"
• "Nel gruppo WhatsApp con [cliente], chi ha chiesto cosa, e cosa è ancora in sospeso?"
• "Traduci gli ultimi 10 messaggi di [cliente] in italiano e dimmi di cosa ha bisogno."

Azione (chiedere prima l'approvazione)

• "Redigi risposte per tutti quelli che aspettano da più di 24 ore, nella loro lingua. Non inviare nulla."
• "Assegna le chat non assegnate di questa settimana a [collega]."
• "Quali delle nostre chat API WhatsApp Business hanno ancora la finestra di 24 ore aperta?"

Preferisci il terminale? Gli stessi dati WhatsApp funzionano in Claude Code — guarda l'analisi di WhatsApp con Claude Code.

Cosa abbiamo imparato configurandolo

1. La connessione predefinita di HubSpot è più limitata di quanto sembri. Copre quattro tipi di record: contatti, aziende, trattative e ticket. Chiedi note, chiamate, il tuo utente o un conteggio della pipeline, e Claude risponde: "Questo connettore richiede permessi aggiuntivi". Riconnettersi da solo non ha risolto il problema nel nostro caso: un Super Admin deve prima autorizzare i permessi extra, poi ogni utente si riconnette.
2. Abbina per numero di telefono, non per nome. Un contatto HubSpot nel nostro test aveva quattro chat WhatsApp — una per ogni collega che gli aveva parlato — e nessuna aveva lo stesso nome del contatto in HubSpot. Anche le trattative create da WhatsApp mantengono il nome della chat del giorno in cui sono state create. Chiedi all'assistente di abbinare per telefono e usare la chat con il messaggio più recente.
3. Il proprietario della trattativa non è sempre chi risponde su WhatsApp. Nel nostro account, ogni trattativa creata da WhatsApp apparteneva a un unico proprietario HubSpot, mentre le chat erano assegnate a colleghi diversi. Per sapere "chi deve una risposta a chi", segui l'assegnatario WhatsApp.
4. La sincronizzazione è molto precisa. L'orario di "ultimo contatto" di HubSpot e l'ultimo messaggio di TimelinesAI erano distanti 14 secondi. Fidati delle date di HubSpot per "chi è rimasto in silenzio" e di TimelinesAI per "cosa è stato detto".
5. I numeri disconnessi contano comunque. Il tuo assistente può leggere lo storico di un numero che è stato disconnesso, ma non può inviare da esso — utile quando un commerciale lascia l'azienda.

Risoluzione dei problemi

• "Questo connettore richiede permessi aggiuntivi." La connessione predefinita di HubSpot copre quattro tipi di record. Chiedi a un Super Admin di abilitare i permessi di Visualizzazione che ti servono, poi riconnetti HubSpot.
• Le opzioni dei permessi sono in grigio. Il tuo account limita a cosa può accedere il connettore. Un Super Admin approva il connettore e i suoi permessi sui dati.
• L'assistente risponde usando solo una delle due app. L'altro connettore non è attivo per questa chat. In Claude: + → Connettori, attiva entrambi. In ChatGPT: attiva l'app TimelinesAI e includi "HubSpot" nella tua domanda. Nominare l'app ("in TimelinesAI") aiuta in ogni caso.
• Non trova la chat di un cliente. I nomi delle chat non corrispondono ai nomi in HubSpot, oppure il formato del telefono è diverso. Chiedigli di abbinare per telefono in formato internazionale (+prefisso internazionale), e controlla il campo telefono del contatto in HubSpot.
• Ha scelto una conversazione vecchia. Un cliente può avere più chat, una per ogni numero di un collega. Chiedi la chat con il messaggio più recente.
• I conteggi "in attesa" per commerciale sembrano sbagliati. Il proprietario della trattativa in HubSpot non è l'assegnatario WhatsApp. Raggruppa per assegnatario WhatsApp.
• La risposta si blocca o rallenta su domande grandi. Leggere mesi di storico raggiunge i limiti di utilizzo. Restringi a un solo intervallo di date, un numero o un'etichetta alla volta.
• TimelinesAI ti chiede di accedere di nuovo. La sessione è scaduta. Riconnetti TimelinesAI nelle impostazioni dei connettori del tuo assistente.
• Un messaggio non si invia. Il numero è disconnesso, oppure la finestra di 24 ore di una chat API si è chiusa. Riconnetti il numero, o invia un modello approvato.
• Nessun dato di attività o conversazione da HubSpot. I Dati sensibili sono attivi nel tuo account HubSpot, e HubSpot li blocca di proposito — guarda le impostazioni dei Dati sensibili di HubSpot.

Permessi e sicurezza

• HubSpot resta in sola lettura a meno che un Super Admin non autorizzi i permessi di scrittura. Niente in questa guida ne ha bisogno.
• Niente raggiunge un cliente senza la tua approvazione quando gli strumenti di invio di TimelinesAI sono impostati per chiedere conferma. L'assistente redige; tu decidi.
• In Claude, attenzione alla modalità Research. Claude può richiamare automaticamente gli strumenti dei connettori durante Research, senza chiedere ogni volta. Disattiva TimelinesAI, o tieni bloccati i suoi strumenti di invio, prima di eseguire Research.
• In ChatGPT, la modalità sviluppatore è per i server di cui ti fidi. Il consiglio di OpenAI è di collegare solo server MCP di cui ti fidi, e quello di HubSpot è di rivedere ogni modifica proposta da ChatGPT prima di confermarla.
• Solo risposte e follow-up, mai invii di massa. WhatsApp limita i numeri che inviano messaggi non richiesti in volume. Usa questo con persone che già ti stanno scrivendo — guarda la nostra guida sulle buone pratiche WhatsApp per i team HubSpot.
• Tutto è tracciato. Le modifiche fatte tramite il connettore di HubSpot sono registrate sia a nome dell'utente sia del connettore.
• Dati sensibili di HubSpot: se sono attivi, HubSpot blocca i dati di attività e conversazione dal proprio connettore.

Domande frequenti

Cos'è HubSpot WhatsApp MCP?

È una configurazione in cui un assistente IA come Claude o ChatGPT si collega a HubSpot tramite il connettore ufficiale di HubSpot e al WhatsApp del tuo team tramite il server MCP di TimelinesAI, allo stesso tempo. Puoi quindi fare un'unica domanda che richiede entrambe le fonti — per esempio, quali trattative aspettano una risposta su WhatsApp — senza codice.

Con quali assistenti IA funziona?

Claude e ChatGPT per la routine completa, più Claude Code, Cursor e Codex per i team tecnici. Le connessioni di HubSpot con Copilot e Gemini coprono solo domande sul CRM.

L'IA propria di HubSpot può leggere i nostri messaggi WhatsApp?

Non quelli sincronizzati da TimelinesAI. Nel nostro test, il connettore di HubSpot mostrava quando un cliente era stato contattato l'ultima volta e quante volte, ma non i messaggi. Se usi il canale di posta in arrivo WhatsApp proprio di HubSpot, il suo connettore può leggere quei thread — ma non può rispondere.

Mi serve l'integrazione WhatsApp propria di HubSpot?

No. Il canale WhatsApp di HubSpot richiede Marketing Hub o Service Hub Professional o Enterprise e non accetta account personali. TimelinesAI funziona su ogni livello di HubSpot, con numeri dell'app e dell'API WhatsApp Business.

È la stessa cosa dei riepiloghi IA dentro HubSpot?

No. I riepiloghi sul record sono l'IA propria di HubSpot. Questo è per i team che già lavorano in Claude o ChatGPT e vogliono fare un'unica domanda che copra HubSpot e il WhatsApp di ogni commerciale.

Devo dare all'IA l'accesso in scrittura a HubSpot?

No. Tutte le domande di questa guida funzionano con la connessione predefinita in sola lettura di HubSpot.

L'assistente può aggiornare trattative, note e attività in HubSpot?

Sì, in Claude e ChatGPT, se un Super Admin autorizza i permessi di scrittura. Il connettore di ChatGPT aggiorna fino a 10 record alla volta. HubSpot consiglia di impostare il connettore in modo che chieda l'approvazione prima di ogni aggiornamento.

Qual è la differenza tra il server MCP di HubSpot e il connettore di HubSpot per Claude?

Il connettore è l'app già pronta che aggiungi dentro Claude o ChatGPT — è quella da usare per questa guida. Il server MCP remoto di HubSpot è ciò a cui gli sviluppatori collegano i propri strumenti IA.

Funziona con i numeri dell'app WhatsApp Business, o solo con l'API?

Con entrambi, su tutto il tuo team.

Funziona con HubSpot Free o Starter?

Sì. Sia il connettore di HubSpot sia TimelinesAI funzionano su ogni livello di HubSpot.

Può leggere le chat di gruppo?

Sì, incluso chi ha inviato ogni messaggio.

Ha un costo aggiuntivo?

Non da parte di TimelinesAI: l'MCP di WhatsApp è incluso nel tuo piano TimelinesAI. Nemmeno HubSpot elenca un costo separato per i suoi connettori — sono disponibili a ogni livello di HubSpot, incluso Free. Ciò che ti serve è un piano IA a pagamento, e un team che lo fa ogni mattina su una casella grande dovrebbe considerare un livello superiore.

Posso usare ChatGPT al posto di Claude?

Sì. Il connettore ufficiale di HubSpot per ChatGPT legge il tuo CRM e, se autorizzato, lo aggiorna. TimelinesAI si collega tramite la modalità sviluppatore di ChatGPT sui piani Plus, Pro, Business, Enterprise ed Education.

Funziona con Microsoft Copilot o Gemini?

Per le domande sul CRM, sì: HubSpot ha un agente per Microsoft 365 Copilot e un connettore in sola lettura per Gemini. Non abbiamo verificato un modo per aggiungere TimelinesAI a nessuno dei due, quindi per le domande che richiedono WhatsApp, usa Claude o ChatGPT.

Guide correlate

• Come funziona la sincronizzazione di WhatsApp con HubSpot
• Guida alla configurazione di WhatsApp MCP
• Posta in arrivo WhatsApp condivisa per i team HubSpot
• Buone pratiche WhatsApp e HubSpot
• Casi d'uso di WhatsApp MCP
• Analisi di WhatsApp con Claude Code

Pronto a provarlo sulla tua pipeline? Inizia gratis con TimelinesAI, collega il WhatsApp del tuo team a HubSpot, poi fai la tua prima domanda.