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#
| Percorso | HubSpot → WhatsApp | WhatsApp → HubSpot | Cosa richiede |
|---|---|---|---|
| Zapier | Trigger New Contact o Updated Deal Stage, poi un'azione di invio di WbizTool | Il trigger WbizTool Incoming WhatsApp Message, poi HubSpot Find Contact e Create Engagement | Un account Zapier. Nessun webhook da configurare. |
| Make | HubSpot CRM Watch Contacts, poi il modulo HTTP | Un custom webhook di Make, poi richieste HTTP all'API di HubSpot | Un account Make. Non esiste un'app WbizTool su Make: il modulo HTTP chiama l'API di WbizTool. |
| n8n | HubSpot Trigger, poi WbizTool Send Message | Un nodo Webhook, poi il nodo HubSpot e richieste HTTP a HubSpot | n8n con il community node di WbizTool. L'HubSpot Trigger richiede un account sviluppatore HubSpot e un'app. |
| Pabbly Connect | Un trigger HubSpot, poi API (Pabbly) | Webhook by Pabbly, poi richieste API a HubSpot | Un account Pabbly Connect. Funziona tramite i passaggi HTTP e webhook di Pabbly. |
| Workflow di HubSpot | L'azione Send a webhook chiama direttamente l'API di WbizTool | Usa un altro percorso | Data 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:
Trigger: HubSpot, New Contact
Scegli HubSpot e il trigger New Contact, e collega il tuo account HubSpot.
Filter by Zapier
Prosegui solo quando il numero di telefono del contatto exists (esiste). I contatti senza numero farebbero fallire il passaggio successivo.
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.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:
Trigger: HubSpot, Updated Deal Stage
Scegli Updated Deal Stage e seleziona la pipeline e la fase, come Closed won.
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.
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.
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.
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.
HTTP, Make a request
Metodo
POST, URLhttps://wbiztool.com/api/v1/send_msg/. Aggiungi un headerAuthorizationcon il valoreBearer YOUR_API_KEY. Tipo di corpo application/x-www-form-urlencoded, con questi campi:Campo Valore whatsapp_clientIl tuo WhatsApp Client ID, come 678phoneIl Phone number del contatto dal modulo HubSpot country_codeSolo se i tuoi numeri sono salvati senza prefisso, come 1msgIl tuo testo, con campi come il nome mappati al suo interno 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": 1significa 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.
Installa il nodo WbizTool
Installa
n8n-nodes-wbiztoole crea una credenziale WbizTool API. Vedi Integrazione con n8n.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.
Importa il workflow
In n8n, importa il file e scegli le tue credenziali in ogni nodo HubSpot, HTTP Request e WbizTool.
Imposta la fase e il messaggio
Nel nodo Deal stage is, sostituisci
closedwoncon 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.Attiva
Il trigger registra quindi il suo webhook in HubSpot.
Cosa fa il workflow:
- HubSpot Trigger con due eventi: Contact Created, e Deal Property Changed per la proprietà Deal Stage.
- Un nodo IF manda gli eventi dei contatti da una parte e quelli dei deal dall'altra.
- Per un deal, controlla la nuova fase, poi legge il deal e i contatti associati con una HTTP Request a HubSpot.
- HubSpot → Search Contacts legge il nome e i numeri di telefono del contatto.
- 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.
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.
Aggiungi Send a webhook
Fai clic su + e, in Data ops, scegli Send a webhook. Metodo
POST, URL del webhookhttps://wbiztool.com/api/v1/send_msg/.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 suAuthorizatione la posizione su Request header.Personalizza il corpo della richiesta
Scegli Customize request body e aggiungi:
Chiave Valore phoneProprietà: Phone number whatsapp_clientValore statico: il tuo WhatsApp Client ID, come 678msgValore statico: il tuo messaggio country_codeValore statico, solo se i tuoi numeri sono salvati senza prefisso 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
4xxtranne429, quindi un messaggio rifiutato, per esempio conInvalid phone number, non viene inviato di nuovo. Per evitare che un nuovo tentativo dopo un timeout invii un messaggio due volte, aggiungi una chiaveidempotency_keycon 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:
- Salta le chat di gruppo (
contact.is_groupètrue) e i contatti di cui WhatsApp nasconde il numero (contact.phone_hiddenètrue). - Togli il tuo prefisso internazionale dall'inizio di
contact.phone(vedi Numeri di telefono). - Cerca i contatti HubSpot il cui Phone number o Mobile phone number è uguale a quel numero.
- Se non ce n'è nessuno, crea un contatto con Phone number
+econtact.phone, e First namecontact.name. - Crea una nota sul contatto con il messaggio:
message.content, all'oramessage.timestamp.
Con Zapier#
Non devi impostare un URL webhook da nessuna parte: il trigger di WbizTool si collega a Zapier quando pubblichi lo Zap.
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.
Filter by Zapier
Prosegui solo quando Contact Phone Hidden è false e Is Group è false.
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ì+12125550120diventa2125550120.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.HubSpot, Create Engagement
Tipo Note, associata all'ID del contatto del passaggio Find Contact. Corpo:
WhatsApp fromContact Name: Message Content.
Con Make#
Importa il template
Importa hubspot-whatsapp-to-note.make.json in un nuovo scenario.
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_KEYnell'headerAuthorizationcon quella chiave.Crea il webhook
Nel modulo Webhooks → Custom webhook, fai clic su Add, dagli un nome e copia il suo indirizzo.
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.
Imposta il tuo prefisso internazionale
Nel modulo Search the contact by phone, il template toglie
1dall'inizio del numero (/^1/, due volte). Sostituisci1con il tuo prefisso internazionale, come91.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#
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.
Imposta il tuo prefisso internazionale
Nel nodo National number, imposta
countryCodesul tuo, come91.Attiva e copia l'indirizzo
Attiva il workflow e copia la Production URL del nodo WbizTool webhook.
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
| Passaggio | Richiesta | Corpo |
|---|---|---|
| Trovare il contatto | POST https://api.hubapi.com/crm/objects/2026-09/contacts/search | filterGroups con phone EQ il numero senza prefisso internazionale, e un secondo gruppo con mobilephone; limit 1 |
| Crearlo se manca | POST https://api.hubapi.com/crm/objects/2026-09/contacts | properties: phone +12125550120, firstname da contact.name |
| Aggiungere la nota | POST https://api.hubapi.com/crm/objects/2026-09/notes | properties: 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#
| File | Strumento | Cosa fa |
|---|---|---|
| hubspot-new-contact-to-whatsapp.make.json | Make | Nuovo contatto HubSpot → messaggio WhatsApp |
| hubspot-whatsapp-to-note.make.json | Make | WhatsApp in arrivo → nota sul contatto (richiede il componente aggiuntivo Unibox) |
| hubspot-to-whatsapp.n8n.json | n8n | Nuovo contatto o fase del deal → messaggio WhatsApp |
| hubspot-whatsapp-to-note.n8n.json | n8n | WhatsApp 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#
| Problema | Cosa controllare |
|---|---|
Invalid phone number | Il 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 sbagliato | Il 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 key | La 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 client | Usa l'ID del numero da Numeri WhatsApp. |
| Send a webhook non è tra le azioni del workflow | Richiede Data Hub Professional o Enterprise. Usa invece Zapier, Make, n8n o Pabbly Connect. |
| Make non riesce a collegarsi a HubSpot | Prima un Super Admin dell'account HubSpot deve approvare l'app di Make. |
| In HubSpot non compare nessuna nota | Controlla 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 rifiuta | Il 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 HubSpot | HubSpot 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 volte | WbizTool può, raramente, inviare un messaggio due volte. Salta un message.id che hai già registrato. |
| Manca la nota per alcuni messaggi | Le 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. |

