Vai al contenuto
WbizTool

Integrazioni

HubSpot e WhatsApp

Collega HubSpot al tuo numero WhatsApp in entrambe le direzioni:

  • HubSpot → WhatsApp: quando viene creato un contatto o un deal passa a una fase, invia a quella persona un messaggio WhatsApp dal tuo numero.
  • WhatsApp → HubSpot: quando qualcuno scrive al tuo numero WhatsApp, aggiungi il messaggio come nota sul suo contatto HubSpot, e crea il contatto se non esiste ancora.

WbizTool non ha un'app HubSpot. Queste ricette collegano i due servizi tramite Zapier, Make, n8n, Pabbly Connect o un workflow di HubSpot, con template pronti per Make e n8n.

Chi può farlo: in WbizTool, un Proprietario crea la chiave API in Impostazioni → Chiavi API (vedi Chiavi API); Proprietari ed Editor configurano i Numeri inbox per la direzione WhatsApp → HubSpot. In HubSpot, ti servono i permessi per collegare app o modificare i workflow; ogni percorso qui sotto indica cosa richiede.

Prima di iniziare#

  • Un numero WhatsApp collegato in Numeri WhatsApp. Vedi Collega il tuo numero WhatsApp.
  • La tua chiave API, e per alcuni strumenti il tuo Client ID, da Impostazioni → Chiavi API, e il WhatsApp Client ID del numero che invia (il suo ID in Numeri WhatsApp).
  • Solo per WhatsApp → HubSpot: il componente aggiuntivo Unibox. I messaggi in arrivo raggiungono HubSpot tramite il webhook dei Numeri inbox, che richiede il componente aggiuntivo Unibox: $20 al mese o $200 all'anno ai prezzi di listino USA per ogni numero inbox, su un piano a pagamento o a vita (non la prova gratuita). Per inviare messaggi non serve.

Scegli un percorso#

PercorsoHubSpot → WhatsAppWhatsApp → HubSpotCosa richiede
ZapierTrigger New Contact o Updated Deal Stage, poi un'azione di invio di WbizToolIl trigger WbizTool Incoming WhatsApp Message, poi HubSpot Find Contact e Create EngagementUn account Zapier. Nessun webhook da configurare.
MakeHubSpot CRM Watch Contacts, poi il modulo HTTPUn custom webhook di Make, poi richieste HTTP all'API di HubSpotUn account Make. Non esiste un'app WbizTool su Make: il modulo HTTP chiama l'API di WbizTool.
n8nHubSpot Trigger, poi WbizTool Send MessageUn nodo Webhook, poi il nodo HubSpot e richieste HTTP a HubSpotn8n con il community node di WbizTool. L'HubSpot Trigger richiede un account sviluppatore HubSpot e un'app.
Pabbly ConnectUn trigger HubSpot, poi API (Pabbly)Webhook by Pabbly, poi richieste API a HubSpotUn account Pabbly Connect. Funziona tramite i passaggi HTTP e webhook di Pabbly.
Workflow di HubSpotL'azione Send a webhook chiama direttamente l'API di WbizToolUsa un altro percorsoData Hub Professional o Enterprise. Nessun altro strumento necessario.

Numeri di telefono#

Le due direzioni scrivono i numeri in modo diverso, quindi controlla questa sezione prima di mappare i campi.

HubSpot → WhatsApp. Mappa il Phone number (o Mobile phone number) del contatto sul phone del destinatario. WbizTool rimuove per te spazi, trattini, punti e parentesi, quindi +1 (212) 555-0120 funziona. Un numero salvato con + o 00 contiene il suo prefisso internazionale. Un numero salvato senza, come 2125550120, ha bisogno del prefisso: compila Country Code in Zapier e n8n, oppure country_code in una richiesta HTTP, per esempio 1 o 91. Un numero salvato con il prefisso ma senza +, come 12125550120, funziona così com'è. Vedi phone e country_code in Invia messaggio.

WhatsApp → HubSpot. Il webhook indica il mittente in cifre internazionali senza +, in contact.phone, come 12125550120. HubSpot cerca i numeri di telefono solo per prefisso locale e numero, senza il prefisso internazionale. Quindi, prima di cercare, togli il tuo prefisso internazionale dall'inizio: 12125550120 diventa 2125550120. I template lo fanno per un prefisso internazionale che imposti tu. Quando crei un contatto, salva il numero come + seguito dalle cifre, come +12125550120, così HubSpot ne conosce il paese.

Inviare un messaggio WhatsApp da HubSpot#

Con Zapier#

Usa il trigger HubSpot che ti serve, poi un'azione di WbizTool. Collega WbizTool con il tuo Client ID e la tua chiave API (vedi Integrazione con Zapier).

Quando viene creato un contatto:

  1. Trigger: HubSpot, New Contact

    Scegli HubSpot e il trigger New Contact, e collega il tuo account HubSpot.

  2. Filter by Zapier

    Prosegui solo quando il numero di telefono del contatto exists (esiste). I contatti senza numero farebbero fallire il passaggio successivo.

  3. Azione: WbizTool, Send Text-Only WhatsApp Message

    Scegli il numero che invia in WhatsApp Number. Mappa Phone Number sul numero di telefono del contatto. Compila Country Code solo se i tuoi numeri in HubSpot sono salvati senza prefisso. Scrivi il Message, per esempio Hi {first name}, thanks for getting in touch. You can reach us here on WhatsApp.

  4. Testa e pubblica

    Un passaggio riuscito significa che il messaggio è stato messo in coda. WbizTool lo invia poi dal tuo numero.

Quando un deal passa a una fase:

  1. Trigger: HubSpot, Updated Deal Stage

    Scegli Updated Deal Stage e seleziona la pipeline e la fase, come Closed won.

  2. Trova il contatto del deal

    Un deal non contiene un numero di telefono: lo contiene il suo contatto. Aggiungi HubSpot Get Contact con l'ID del contatto associato al deal. Se i dati del trigger non hanno un ID contatto, aggiungi prima HubSpot Find Associations per ottenere i contatti del deal.

  3. Filtra, poi invia

    Aggiungi un passaggio Filter by Zapier che prosegue quando il numero di telefono esiste, poi Send Text-Only WhatsApp Message come sopra. Nel testo puoi usare i campi del deal, come il nome del deal.

Con Make#

Non esiste un'app WbizTool su Make. Il modulo HTTP di Make chiama l'API Invia messaggio. Dei due template per Make, questo usa una connessione HubSpot in Make (Watch Contacts); quello WhatsApp → HubSpot usa solo i moduli integrati di Make e una service key di HubSpot.

  1. Importa il template o avvia uno scenario

    Importa hubspot-new-contact-to-whatsapp.make.json (⋯ → Import Blueprint in un nuovo scenario), oppure costruiscilo con i passaggi qui sotto.

  2. HubSpot CRM, Watch Contacts

    Aggiungi il modulo HubSpot CRM Watch Contacts e collega HubSpot. Prima un Super Admin del tuo account HubSpot deve approvare l'app di Make. Make chiede da dove iniziare: scegli From now on per scrivere solo ai nuovi contatti.

  3. HTTP, Make a request

    Metodo POST, URL https://wbiztool.com/api/v1/send_msg/. Aggiungi un header Authorization con il valore Bearer YOUR_API_KEY. Tipo di corpo application/x-www-form-urlencoded, con questi campi:

    CampoValore
    whatsapp_clientIl tuo WhatsApp Client ID, come 678
    phoneIl Phone number del contatto dal modulo HubSpot
    country_codeSolo se i tuoi numeri sono salvati senza prefisso, come 1
    msgIl tuo testo, con campi come il nome mappati al suo interno
  4. Aggiungi un filtro ed eseguilo una volta

    Sul collegamento tra i due moduli, aggiungi un filtro che lascia passare solo quando il numero di telefono esiste. Esegui lo scenario una volta: una risposta con "status": 1 significa che il messaggio è stato messo in coda.

I campi del modulo continuano a funzionare quando un valore mappato contiene virgolette o a capo, che possono rompere un corpo JSON grezzo. Funziona anche il JSON; vedi Campi del corpo. Per una fase del deal in Make, usa un workflow di HubSpot che invia a un custom webhook di Make, oppure il percorso Zapier o n8n.

Con n8n#

Il template hubspot-to-whatsapp.n8n.json gestisce entrambi gli eventi in un unico workflow: un nuovo contatto e un deal che passa a una fase.

  1. Installa il nodo WbizTool

    Installa n8n-nodes-wbiztool e crea una credenziale WbizTool API. Vedi Integrazione con n8n.

  2. Crea le credenziali HubSpot

    L'HubSpot Trigger richiede una credenziale HubSpot Developer API: un account sviluppatore HubSpot, un'app con scope di lettura per contatti e deal, e l'URL di reindirizzamento di n8n in quell'app (vedi la pagina delle credenziali HubSpot di n8n). Gli altri passaggi HubSpot usano una credenziale HubSpot Service Key: in HubSpot, vai su Development → Keys → Service keys, fai clic su Create service key e aggiungi gli scope di lettura per contatti e deal.

  3. Importa il workflow

    In n8n, importa il file e scegli le tue credenziali in ogni nodo HubSpot, HTTP Request e WbizTool.

  4. Imposta la fase e il messaggio

    Nel nodo Deal stage is, sostituisci closedwon con il valore interno della tua fase. Modifica il testo nei due nodi WbizTool Send Message, e imposta lì Country Code solo se i tuoi numeri sono salvati senza prefisso.

  5. Attiva

    Il trigger registra quindi il suo webhook in HubSpot.

Cosa fa il workflow:

  1. HubSpot Trigger con due eventi: Contact Created, e Deal Property Changed per la proprietà Deal Stage.
  2. Un nodo IF manda gli eventi dei contatti da una parte e quelli dei deal dall'altra.
  3. Per un deal, controlla la nuova fase, poi legge il deal e i contatti associati con una HTTP Request a HubSpot.
  4. HubSpot → Search Contacts legge il nome e i numeri di telefono del contatto.
  5. WbizTool Send Message invia il testo al numero di telefono, oppure al numero di cellulare quando il telefono è vuoto.

Con un workflow di HubSpot#

Con Data Hub Professional o Enterprise, un workflow può chiamare da solo l'API di WbizTool con l'azione Send a webhook. Non serve nessun altro strumento.

  1. Crea un workflow basato sui contatti

    In HubSpot, vai su Automation → Workflows e crea un workflow sui contatti, con il trigger che vuoi, come la creazione di un contatto o il cambio della sua fase del ciclo di vita.

  2. Aggiungi Send a webhook

    Fai clic su + e, in Data ops, scegli Send a webhook. Metodo POST, URL del webhook https://wbiztool.com/api/v1/send_msg/.

  3. Imposta l'autenticazione

    Scegli API key come tipo di autenticazione. Aggiungi un secret il cui valore è Bearer YOUR_API_KEY (con la tua chiave WbizTool), imposta il nome della chiave API su Authorization e la posizione su Request header.

  4. Personalizza il corpo della richiesta

    Scegli Customize request body e aggiungi:

    ChiaveValore
    phoneProprietà: Phone number
    whatsapp_clientValore statico: il tuo WhatsApp Client ID, come 678
    msgValore statico: il tuo messaggio
    country_codeValore statico, solo se i tuoi numeri sono salvati senza prefisso
  5. Testalo

    Testa l'azione con un contatto che ha il tuo numero. WbizTool risponde {"status": 1, "message": "Created", "msg_id": …} quando ha messo il messaggio in coda.

  • Il messaggio non può includere il nome del contatto. In Customize request body, ogni chiave accetta una sola proprietà HubSpot o un solo valore statico, quindi msg è un testo fisso, uguale per ogni contatto. Per un saluto personalizzato, usa il percorso Zapier, Make o n8n.
  • Nuovi tentativi: HubSpot ritenta un webhook non riuscito per un massimo di tre giorni. Non ritenta le risposte 4xx tranne 429, quindi un messaggio rifiutato, per esempio con Invalid phone number, non viene inviato di nuovo. Per evitare che un nuovo tentativo dopo un timeout invii un messaggio due volte, aggiungi una chiave idempotency_key con la proprietà Record ID, se il workflow scrive a ogni contatto al massimo una volta al giorno. Vedi Riprovare in sicurezza.
  • Deal: questi passaggi usano un workflow basato sui contatti, perché il numero di telefono è sul contatto, non sul deal. Per i messaggi legati a una fase del deal, usa il percorso Zapier o n8n.

Con Pabbly Connect#

Pabbly Connect avvia un workflow da eventi HubSpot come New Contact Added o Deal Updated. Poi aggiungi API (Pabbly) → Execute API Request con POST verso https://wbiztool.com/api/v1/send_msg/, come in Inviare messaggi WhatsApp da qualsiasi strumento di automazione, e mappa il numero di telefono del contatto su phone.

Registrare i messaggi WhatsApp in arrivo in HubSpot#

Ogni messaggio che qualcuno invia al tuo numero diventa una nota sul suo contatto HubSpot. Questa direzione richiede il componente aggiuntivo Unibox ($20 al mese o $200 all'anno ai prezzi di listino USA per ogni numero inbox, su un piano a pagamento o a vita), perché i messaggi escono da WbizTool tramite il webhook dei Numeri inbox.

La ricetta è la stessa in ogni strumento:

  1. Salta le chat di gruppo (contact.is_group è true) e i contatti di cui WhatsApp nasconde il numero (contact.phone_hidden è true).
  2. Togli il tuo prefisso internazionale dall'inizio di contact.phone (vedi Numeri di telefono).
  3. Cerca i contatti HubSpot il cui Phone number o Mobile phone number è uguale a quel numero.
  4. Se non ce n'è nessuno, crea un contatto con Phone number + e contact.phone, e First name contact.name.
  5. Crea una nota sul contatto con il messaggio: message.content, all'ora message.timestamp.

Con Zapier#

Non devi impostare un URL webhook da nessuna parte: il trigger di WbizTool si collega a Zapier quando pubblichi lo Zap.

  1. Trigger: WbizTool, Incoming WhatsApp Message

    Scegli il numero in WhatsApp Number. Lo Zap occupa uno dei tuoi numeri inbox (vedi Requisiti del trigger). Lo avviano solo i messaggi che le persone ti inviano.

  2. Filter by Zapier

    Prosegui solo quando Contact Phone Hidden è false e Is Group è false.

  3. Formatter by Zapier: togli il prefisso internazionale

    Scegli Formatter, action event Numbers, transform Format Phone Number. Input: + seguito da Contact Phone. In To Format scegli un formato nazionale senza simboli, così +12125550120 diventa 2125550120.

  4. HubSpot, Find Contact

    Cerca per Phone Number con l'output del Formatter. Spunta l'opzione per creare il contatto se non viene trovato, con Phone Number + e Contact Phone, e First Name da Contact Name.

  5. HubSpot, Create Engagement

    Tipo Note, associata all'ID del contatto del passaggio Find Contact. Corpo: WhatsApp from Contact Name: Message Content.

Con Make#

  1. Importa il template

    Importa hubspot-whatsapp-to-note.make.json in un nuovo scenario.

  2. Aggiungi la tua service key di HubSpot

    In HubSpot, vai su Development → Keys → Service keys, fai clic su Create service key e aggiungi gli scope di lettura e scrittura per i contatti. In ogni modulo HTTP dello scenario, sostituisci YOUR_HUBSPOT_SERVICE_KEY nell'header Authorization con quella chiave.

  3. Crea il webhook

    Nel modulo Webhooks → Custom webhook, fai clic su Add, dagli un nome e copia il suo indirizzo.

  4. Aggiungi l'indirizzo al tuo numero inbox

    In WbizTool, apri Numeri inbox, fai clic su Impostazioni webhook nella scheda del numero (oppure su Aggiungi numero all'inbox), incolla l'indirizzo in URL del webhook (facoltativo) e fai clic su Salva. Lascia spuntato Messaggi ricevuti; spunta anche Messaggi inviati se vuoi le tue risposte in HubSpot.

  5. Imposta il tuo prefisso internazionale

    Nel modulo Search the contact by phone, il template toglie 1 dall'inizio del numero (/^1/, due volte). Sostituisci 1 con il tuo prefisso internazionale, come 91.

  6. Attiva lo scenario

    Invia un messaggio al tuo numero WhatsApp da un altro telefono. Arriva entro un paio di minuti, e Make impara da esso i campi del webhook: controlla una volta le mappature.

Lo scenario: Custom webhook → una richiesta HTTP alla ricerca contatti di HubSpot → un router. Quando trova un contatto, una richiesta HTTP gli aggiunge la nota. Quando non lo trova, una richiesta crea il contatto e un'altra aggiunge la nota. I passaggi JSON → Transform to JSON trasformano il messaggio e il nome in testo JSON, così virgolette e a capo non rompono le richieste.

Con n8n#

  1. Importa il workflow

    Importa hubspot-whatsapp-to-note.n8n.json e scegli una credenziale HubSpot Service Key nei nodi HubSpot e HTTP Request. La chiave richiede gli scope di lettura e scrittura per i contatti.

  2. Imposta il tuo prefisso internazionale

    Nel nodo National number, imposta countryCode sul tuo, come 91.

  3. Attiva e copia l'indirizzo

    Attiva il workflow e copia la Production URL del nodo WbizTool webhook.

  4. Aggiungi l'indirizzo al tuo numero inbox

    Incollalo come webhook del numero in Numeri inbox, come nei passaggi per Make qui sopra.

Il nodo HubSpot di n8n non ha un'azione per le note, quindi il workflow crea il contatto e la nota con nodi HTTP Request che usano la stessa credenziale HubSpot. Il nodo Webhook risponde subito, ben entro gli 8 secondi che WbizTool attende.

Con Pabbly Connect#

Inizia con Webhook by Pabbly e incolla il suo URL come webhook del numero in Numeri inbox. Poi chiama l'API di HubSpot con API (Pabbly) → Execute API Request, con una service key di HubSpot come token Bearer: POST https://api.hubapi.com/crm/objects/2026-09/contacts/search per trovare il contatto, POST …/contacts per crearne uno e POST …/notes per aggiungere la nota (vedi Le richieste che fa il tuo server).

Sul tuo server#

Ricevi il webhook come descritto in Webhook dei messaggi in arrivo, verifica la sua firma, rispondi subito 200, e poi fai queste chiamate all'API di HubSpot con una service key.

Le richieste che fa il tuo server

PassaggioRichiestaCorpo
Trovare il contattoPOST https://api.hubapi.com/crm/objects/2026-09/contacts/searchfilterGroups con phone EQ il numero senza prefisso internazionale, e un secondo gruppo con mobilephone; limit 1
Crearlo se mancaPOST https://api.hubapi.com/crm/objects/2026-09/contactsproperties: phone +12125550120, firstname da contact.name
Aggiungere la notaPOST https://api.hubapi.com/crm/objects/2026-09/notesproperties: hs_timestamp da message.timestamp, hs_note_body con il testo; associations al contatto con associationCategory HUBSPOT_DEFINED e associationTypeId 202 (nota a contatto)
{
  "properties": {
    "hs_timestamp": "2026-10-15T10:30:04+00:00",
    "hs_note_body": "WhatsApp from Emma Thompson (+12125550120): Can I add a gift note to it?"
  },
  "associations": [
    {
      "to": { "id": "CONTACT_ID" },
      "types": [{ "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 202 }]
    }
  ]
}

Gli endpoint di ricerca di HubSpot consentono cinque richieste al secondo per account. Salta un message.id che hai già registrato: WbizTool può, raramente, inviare un messaggio due volte.

Template#

FileStrumentoCosa fa
hubspot-new-contact-to-whatsapp.make.jsonMakeNuovo contatto HubSpot → messaggio WhatsApp
hubspot-whatsapp-to-note.make.jsonMakeWhatsApp in arrivo → nota sul contatto (richiede il componente aggiuntivo Unibox)
hubspot-to-whatsapp.n8n.jsonn8nNuovo contatto o fase del deal → messaggio WhatsApp
hubspot-whatsapp-to-note.n8n.jsonn8nWhatsApp in arrivo → nota sul contatto (richiede il componente aggiuntivo Unibox)

I template non contengono chiavi. Dopo l'importazione, scegli le tue connessioni o credenziali in ogni passaggio, e sostituisci YOUR_API_KEY, YOUR_HUBSPOT_SERVICE_KEY, il WhatsApp Client ID 678 e il prefisso internazionale con i tuoi.

Risoluzione dei problemi#

ProblemaCosa controllare
Invalid phone numberIl telefono del contatto è vuoto, contiene lettere, oppure ha meno di 6 o più di 17 cifre. Aggiungi un filtro che salti i contatti senza numero.
Il messaggio va al numero sbagliatoIl numero è salvato senza prefisso internazionale e non ne è stato inviato nessuno. Compila Country Code o country_code, oppure salva i numeri in HubSpot con +.
Auth Error: invalid api keyLa chiave è stata eliminata o scritta male. In un workflow di HubSpot, il valore del secret deve essere Bearer seguito dalla chiave, e il nome della chiave API Authorization.
Invalid whatsapp clientUsa l'ID del numero da Numeri WhatsApp.
Send a webhook non è tra le azioni del workflowRichiede Data Hub Professional o Enterprise. Usa invece Zapier, Make, n8n o Pabbly Connect.
Make non riesce a collegarsi a HubSpotPrima un Super Admin dell'account HubSpot deve approvare l'app di Make.
In HubSpot non compare nessuna notaControlla che il numero mostri In sincronizzazione in Numeri inbox, che l'URL del webhook sia quello del tuo strumento e che Messaggi ricevuti sia spuntato. Invia un messaggio da un altro telefono: le risposte dall'inbox Unibox non vengono inviate.
I webhook non arrivano, oppure il tuo hosting li rifiutaIl tuo ricevitore deve rispondere 2xx entro 8 secondi e non deve fare redirect. Alcuni firewall degli hosting bloccano i client sconosciuti: i webhook di WbizTool arrivano con lo User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), quindi consentilo.
Viene creato un nuovo contatto per qualcuno che è già in HubSpotHubSpot non ha trovato il numero. Controlla che il prefisso internazionale che togli sia giusto e che il numero del contatto sia in Phone number o Mobile phone number. Per clienti in molti paesi, vedi Numeri di telefono.
Un messaggio viene registrato due volteWbizTool può, raramente, inviare un messaggio due volte. Salta un message.id che hai già registrato.
Manca la nota per alcuni messaggiLe chat di gruppo e i contatti di cui WhatsApp nasconde il numero vengono saltati di proposito. I messaggi del periodo in cui il numero era fermo non vengono inviati.

Pagine correlate#