Guida di configurazione

HubSpot Service Hub WhatsApp: trasforma le conversazioni in ticket HubSpot

Guida alla configurazione e workflow n8n importabileUltima verifica: Ottobre 2026

Ci sono due modi per usare WhatsApp con HubSpot Service Hub. HubSpot offre un suo canale WhatsApp nella sua casella tramite la WhatsApp Business API, il che significa un numero registrato sull'API, modelli approvati per i messaggi fuori dalla finestra di 24 ore e costi per messaggio. L'altro modo lascia WhatsApp sul numero che i tuoi clienti usano già, con Spun come spazio di lavoro WhatsApp, e crea ticket HubSpot tramite un workflow nel tuo n8n.

Questa pagina descrive la seconda strada, per i ticket HubSpot da WhatsApp: ogni conversazione individuale diventa un ticket nella pipeline che scegli, ogni messaggio viene registrato sul ticket e nella cronologia del contatto, e gli agenti rispondono su WhatsApp dal ticket. Funziona accanto alla sincronizzazione dei contatti di Spun con HubSpot CRM, che tiene allineati i contatti e non crea ticket.

Ticket HubSpot da WhatsApp: cosa fa il workflow

  • Ogni conversazione WhatsApp individuale diventa un ticket HubSpot nella pipeline e nella fase che sceglie il tuo amministratore. Le chat di gruppo vengono saltate.
  • Ogni messaggio viene registrato sul ticket come comunicazione WhatsApp e compare anche nella cronologia del contatto, con il nome di chi scrive nel testo.
  • Anche le risposte che il tuo team invia dalla Posta in arrivo di Spun vengono registrate sul ticket, così entrambe le parti possono rispondere.
  • Archiviare in Spun sposta il ticket nella fase chiusa, e toglierlo dall'archivio lo riporta nella fase aperta. Anche chiudere in HubSpot può archiviare la conversazione in Spun, un'opzione disattivata finché non la attivi.
Come vengono registrati i messaggi sul ticket (esempio)
[WhatsApp] Maria Lopez (+15550142233): Hi, my order has not arrived yet
[Sent from Spun] Alex: Sorry about that, checking now.
[Sent from HubSpot] It ships today, here is the tracking link.

Rispondere dal ticket con il campo Spun reply

Gli agenti rispondono scrivendo in una proprietà Spun reply sul ticket e salvando. In pochi secondi il testo arriva al cliente su WhatsApp, viene registrato sul ticket e il campo torna vuoto. Se una risposta non è stata inviata, una nota sul ticket spiega perché.

Le risposte sono solo testo; gli allegati del ticket non vengono inoltrati. Le note e le email di HubSpot restano interne. Tutto ciò che viene scritto in Spun reply viene inviato, chiunque lo scriva, quindi tieni quella proprietà fuori dalle modifiche in blocco, dalle importazioni e dai workflow di HubSpot.

Accanto alla sincronizzazione dei contatti con HubSpot CRM

La sincronizzazione dei contatti di Spun con HubSpot CRM si occupa dei contatti; questo workflow si occupa dei ticket. Il workflow usa una sua chiave HubSpot e non modifica mai un contatto. Con la sincronizzazione dei contatti collegata, non crea mai nemmeno un contatto: il ticket di un cliente nuovissimo viene collegato quando la sincronizzazione ha inviato il contatto, cosa che avviene con “Sincronizza ora” o con un'etichetta mappata, non a ogni messaggio.

Vedi anche: WhatsApp + HubSpot CRM: la sincronizzazione dei contatti

Configurazione, passo dopo passo

Ti servono HubSpot Service Hub, un utente che possa creare proprietà, chiavi e iscrizioni webhook, un'istanza n8n che HubSpot e Spun possano raggiungere via HTTPS, e un'app che porti il webhook di risposta: un'app privata legacy (creala prima del 26 ottobre 2026, quando HubSpot smette di consentirne di nuove per gli account esistenti) oppure un'app basata su progetto, che si crea con la HubSpot CLI e richiede uno sviluppatore.

  1. 1

    Crea due proprietà del ticket

    Spun chat id (testo a riga singola) e Spun reply (testo a più righe). Aggiungi Spun reply alla barra laterale del ticket così gli agenti lo vedono.

  2. 2

    Crea una chiave per le chiamate API

    Una service key o il token di accesso della tua app privata legacy, con gli ambiti per ticket e contatti indicati nella guida alla configurazione, salvata in n8n come credenziale Header Auth.

  3. 3

    Importa il workflow

    Esegui una volta il suo assistente di configurazione per elencare le pipeline e le fasi dei tuoi ticket, e copia gli id nel nodo Settings.

  4. 4

    Indicagli la sincronizzazione dei contatti

    Lascia attiva l'impostazione della sincronizzazione dei contatti se la sincronizzazione dei contatti di Spun con HubSpot è collegata, o se non sei sicuro.

  5. 5

    Iscrivi l'app alle modifiche dei ticket

    Punta il webhook dell'app all'URL di risposta del workflow con un'iscrizione sulla proprietà Spun reply, e incolla il client secret dell'app nel workflow.

  6. 6

    Crea una chiave API Spun

    “Impostazioni”, poi “Webhook”, poi “Gestisci Chiavi API”, con l'ambito “Invia messaggi”. Spunta anche “Chiudi e riapri le conversazioni” se chiudere in HubSpot deve archiviare la conversazione in Spun.

  7. 7

    Iscrivi Spun al workflow

    Aggiungi un webhook per messaggi in arrivo, messaggi in uscita, conversazione chiusa e conversazione riaperta, con il “Formato del payload” impostato su “Dati grezzi”, e incolla il suo segreto di firma nel workflow.

  8. 8

    Invia un messaggio di prova

    Scrivi alla linea da un altro telefono. In HubSpot compare un ticket; scrivi una risposta in Spun reply, salva, e la risposta arriva sul telefono.

Vedi anche: Documentazione: HubSpot Service Hub tramite n8n, la guida completa alla configurazione · WhatsApp + n8n: l'API e i webhook che ci stanno sotto

Cosa sapere prima di costruire

  • I webhook di HubSpot sono firmati e il workflow controlla la firma. Gli eventi di Spun sono firmati con HMAC.
  • I media arrivano sul ticket come link valido per 24 ore, non come file HubSpot.
  • I limiti API di HubSpot valgono per chiave (100 o 190 richieste ogni 10 secondi, più un limite giornaliero per account). Una nuova conversazione costa quattro o cinque chiamate e un messaggio successivo due.
  • Ogni evento consegnato consuma token IA del tuo piano Spun. Il modo in cui viene conteggiato per l'uso come helpdesk è ancora in fase di revisione.

Vedi anche: Tutte le integrazioni WhatsApp con un helpdesk · WhatsApp come helpdesk vero e proprio

Domande frequenti

HubSpot Service Hub può creare ticket da WhatsApp?

Sì. Con Spun e il workflow n8n, ogni conversazione WhatsApp individuale diventa un ticket nella pipeline e nella fase che scegli, e ogni messaggio viene registrato sul ticket e nella cronologia del contatto.

Come rispondono gli agenti su WhatsApp da un ticket HubSpot?

Scrivono la risposta nella proprietà Spun reply sul ticket e salvano. Il testo viene inviato al cliente su WhatsApp dal tuo numero, registrato sul ticket, e il campo si svuota.

In cosa è diverso dalla sincronizzazione dei contatti con HubSpot CRM?

La sincronizzazione dei contatti tiene allineati i contatti tra Spun e HubSpot e non crea ticket. Questo workflow crea e aggiorna i ticket e non modifica mai un contatto. Funzionano in parallelo.

Cosa mi serve lato HubSpot?

Service Hub, due proprietà personalizzate del ticket, una chiave per le chiamate API e un'app per il webhook di risposta: un'app privata legacy creata prima del 26 ottobre 2026, oppure un'app basata su progetto creata con la HubSpot CLI, che richiede uno sviluppatore.

È un'app del marketplace di HubSpot?

No. È un workflow n8n che importi nel tuo n8n, Cloud o self-hosted, con una guida alla configurazione nella documentazione di Spun.

Conversazioni WhatsApp come ticket HubSpot

Spun trasforma il tuo numero WhatsApp attuale in una casella condivisa del team con etichette, assegnazione e riepiloghi IA, più la sincronizzazione dei contatti con HubSpot e i webhook e l'API che questo workflow usa. Prova gratuita.

Inizia gratis: 7 giorni con tutto incluso

Vedi tutte le integrazioni