Integrazioni
GoHighLevel e WhatsApp
Collega GoHighLevel (HighLevel) a WbizTool e i tuoi workflow inviano messaggi WhatsApp dal tuo numero WhatsApp. Anche i messaggi WhatsApp in arrivo possono tornare in HighLevel, come nota, tag o attività sul contatto.
Tutto ciò che trovi in questa pagina usa funzioni che esistono già da entrambe le parti: i webhook dei workflow di HighLevel, e l'API Invia messaggio e i webhook dei messaggi in arrivo di WbizTool. Non devi installare nulla.
Chi può farlo: in WbizTool, un Proprietario crea la chiave API (Chiavi API) e un Proprietario o un Editor configura i webhook dei messaggi in arrivo. In HighLevel, li crea chi può modificare i workflow nel sub-account. L'agenzia deve attivare le funzioni premium dei workflow di HighLevel (vedi Prima di iniziare).
Cosa puoi fare#
| Direzione | Esempio | Come |
|---|---|---|
| HighLevel → WhatsApp | Viene inviato un modulo, viene aggiunto un tag o viene prenotato un appuntamento, e il contatto riceve un messaggio WhatsApp. | Un'azione Custom Webhook in un workflow di HighLevel chiama l'API Invia messaggio di WbizTool. |
| WhatsApp → HighLevel | Un cliente scrive al tuo numero WhatsApp e il messaggio viene aggiunto come nota sul suo contatto in HighLevel. Il contatto viene creato se non esiste ancora. | Un numero inbox di WbizTool invia ogni messaggio a un trigger Inbound Webhook di HighLevel. Serve il componente aggiuntivo Unibox. |
Prima di iniziare#
- Un numero WhatsApp collegato in Numeri WhatsApp, e il suo WhatsApp Client ID (l'ID mostrato per il numero), per esempio
678. - Una chiave API di WbizTool da Impostazioni → Chiavi API. In HighLevel va in un header
Authorization: Bearer, quindi non ti serve il Client ID. Vedi Inviare la chiave in un header. - Le funzioni premium dei workflow di HighLevel. HighLevel indica Custom Webhook e Inbound Webhook come funzioni premium dei workflow. Le agenzie con qualsiasi piano HighLevel possono attivarle: in Agency View, vai su Settings → Company e attiva Workflow - Premium Features. HighLevel addebita ogni esecuzione premium, e ogni sub-account ha 100 esecuzioni premium gratuite (una sola volta, non ogni mese). L'agenzia può riaddebitare il costo al sub-account. I prezzi di HighLevel sono sulla sua pagina di assistenza.
- Solo per i messaggi in arrivo: il componente aggiuntivo Unibox su un piano WbizTool a pagamento o a vita (non la prova gratuita). Costa $20 al mese o $200 all'anno ai prezzi di listino USA per ogni numero WhatsApp nell'inbox. Lo aggiunge un Proprietario in Fatturazione e piani (vedi Componenti aggiuntivi).
Scegli un percorso#
Il percorso con i workflow di HighLevel è il più breve: HighLevel chiama direttamente WbizTool, senza altri strumenti in mezzo. Usa uno strumento di automazione solo se i tuoi workflow girano già lì.
| Percorso | Invio (HighLevel → WhatsApp) | Ricezione (WhatsApp → HighLevel) | Piani necessari |
|---|---|---|---|
| Workflow di HighLevel (consigliato) | Azione Custom Webhook → API Invia messaggio | Webhook di WbizTool → trigger Inbound Webhook | Funzioni premium dei workflow di HighLevel. Ricezione: il componente aggiuntivo Unibox. |
| Zapier | LeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact o Add Task | Un account Zapier. Ricezione: il componente aggiuntivo Unibox. |
| Make | Azione Webhook di HighLevel → Make Webhooks → modulo HTTP | Webhook di WbizTool → Make Webhooks → API di HighLevel | Un account Make. Ricezione: il componente aggiuntivo Unibox. |
| n8n | Azione Webhook di HighLevel → n8n Webhook → WbizTool Send Message | Webhook di WbizTool → n8n Webhook → nodo HighLevel | n8n con il community node di WbizTool. Ricezione: il componente aggiuntivo Unibox. |
| Pabbly Connect | Azione Webhook di HighLevel → trigger webhook di Pabbly → richiesta API (Pabbly) | Webhook di WbizTool → trigger webhook di Pabbly → il tuo passaggio HighLevel | Un account Pabbly Connect. Ricezione: il componente aggiuntivo Unibox. |
Inviare messaggi WhatsApp da un workflow di HighLevel#
Apri o crea un workflow
Nel tuo sub-account HighLevel, apri Automation e crea un workflow, oppure modificane uno. Dagli il trigger che vuoi, come l'invio di un modulo, un nuovo tag o un appuntamento prenotato.
Aggiungi l'azione Custom Webhook
Fai clic su + nel punto in cui deve partire il messaggio, poi su Send Data → Custom Webhook (oppure cerca "webhook" tra le azioni e scegli Custom Webhook). L'azione Webhook semplice non può impostare l'header e il corpo che servono a questa API.
Imposta la richiesta
Imposta Event su CUSTOM e Method su POST. Imposta URL su
https://wbiztool.com/api/v1/send_msg/. In Authorization, scegli Bearer Token e incolla la tua chiave API di WbizTool, oppure scegli nessuna autenticazione e aggiungi l'headerAuthorizationcon il valoreBearer YOUR_API_KEY. Imposta Content-Type suapplication/json.Incolla il corpo
Incolla uno dei blocchi da copiare e incollare in Raw Body e sostituisci
678con il tuo WhatsApp Client ID. Usa l'icona dei tag di HighLevel per aggiungere altri campi del contatto al messaggio.Testa e pubblica
Salva l'azione e pubblica il workflow. Eseguilo su un contatto di prova con il tuo numero di telefono. Ogni esecuzione compare nei log di esecuzione del workflow. Quando WbizTool accetta il messaggio, risponde
"status": 1. Il messaggio parte poi dal tuo numero WhatsApp.
Il campo del numero di telefono#
Usa {{contact.phone_raw}}, non {{contact.phone}}. {{contact.phone}} di HighLevel è formattato per la lettura, come (515) 555-2345, senza il prefisso internazionale. {{contact.phone_raw}} è lo stesso numero in formato internazionale, come +15155552345.
WbizTool rimuove per te il +, gli spazi, i trattini e le parentesi. Un numero scritto con + include già il prefisso internazionale, quindi non devi inviare country_code. Se alcuni contatti sono stati salvati senza prefisso internazionale, aggiungi "country_code": "1" (il prefisso del tuo paese) al corpo. Viene aggiunto solo ai numeri scritti senza +. Vedi Invia messaggio → phone.
Blocchi da copiare e incollare#
URL: https://wbiztool.com/api/v1/send_msg/ · Metodo: POST · Header: Authorization: Bearer YOUR_API_KEY e Content-Type: application/json
{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, thanks for contacting {{location.name}}. We'll reply here on WhatsApp."
}{
"whatsapp_client": 678,
"msg_type": 1,
"phone": "{{contact.phone_raw}}",
"img_url": "https://example.com/images/welcome-offer.jpg",
"msg": "Hi {{contact.first_name}}, here is your welcome offer from {{location.name}}."
}{
"whatsapp_client": 678,
"msg_type": 2,
"phone": "{{contact.phone_raw}}",
"file_url": "https://example.com/files/price-list.pdf",
"file_name": "price-list.pdf",
"msg": "Hi {{contact.first_name}}, here is our price list."
}{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, a reminder of your appointment with {{location.name}} at {{appointment.start_time}}.",
"expire_after_seconds": 3600
}{
"whatsapp_client": 678,
"group_name": "Sales team",
"msg": "New lead: {{contact.name}}, {{contact.phone_raw}}, {{contact.email}}"
}whatsapp_client: l'ID del numero da cui inviare. Puoi ometterlo solo quando il tuo spazio di lavoro ha esattamente un numero collegato.msg: fino a 3.000 caratteri. La formattazione di WhatsApp funziona:*bold*,_italic_. Per andare a capo, scrivi\nnel testo. Un vero a capo rende il JSON non valido.- Immagini e file: i link devono essere pubblici.
msgdiventa la didascalia. Vedi Invio di immagini e file. expire_after_seconds: se il messaggio non è partito entro questo tempo, per esempio perché il numero era disconnesso, viene segnato come scaduto e non viene inviato.- Gruppi:
group_nameè il nome esatto di un gruppo WhatsApp di cui fa parte il tuo numero. Inviagroup_nameoppurephone, mai entrambi. Vedi Invia a un gruppo.
Registrare i messaggi WhatsApp in arrivo in HighLevel#
Questa direzione richiede il componente aggiuntivo Unibox. Ogni messaggio che il tuo numero WhatsApp riceve viene inviato al trigger Inbound Webhook di HighLevel. Il workflow trova o crea il contatto e aggiunge il messaggio come nota, tag o attività. I messaggi non compaiono in nessun altro punto di HighLevel.
Crea un workflow con un trigger Inbound Webhook
In HighLevel, crea un workflow e scegli il trigger Inbound Webhook. Copia l'URL del webhook che mostra.
Collega il tuo numero WhatsApp
In WbizTool, apri Numeri inbox. Fai clic su Aggiungi numero all'inbox, scegli il numero e incolla l'URL di HighLevel in URL del webhook (facoltativo). Per un numero che è già nell'inbox, incollalo nelle Impostazioni webhook del numero. In Messaggi da inviare, spunta solo Messaggi ricevuti. Ogni invio è un'esecuzione premium in HighLevel, quindi lascia Messaggi inviati non spuntato a meno che non ti servano.
Invia un messaggio di prova
Da un altro telefono, invia un messaggio al tuo numero WhatsApp. Viene inviato dopo il controllo successivo, di solito entro un paio di minuti. In HighLevel, fai clic su Test Trigger, scegli la richiesta in Mapping Reference e salva il trigger. I campi sono elencati in Payload.
Salta i gruppi e i numeri nascosti
Aggiungi un passaggio If/Else che prosegue solo quando
eventèmessage_received,contact.is_groupèfalseecontact.phonenon è vuoto. A volte WhatsApp nasconde il numero del mittente, e i messaggi di gruppo contengono l'ID del gruppo invece di un numero di telefono.Trova o crea il contatto
Nell'azione Create/Update Contact, imposta Phone su
+seguito da contact → phone dai valori dell'Inbound Webhook. WbizTool invia il numero senza+, e il+dice a HighLevel che include il prefisso internazionale. Puoi mappare anche contact → name. È il nome WhatsApp del mittente, e può sostituire un nome che hai modificato in HighLevel.Aggiungi il messaggio al contatto
Aggiungi un'azione Add to Notes. Scrivi una nota come "Messaggio WhatsApp:" e scegli message → content e message → timestamp dai valori dell'Inbound Webhook. Puoi aggiungere anche Add Contact Tag (per esempio
whatsapp), un'attività o una notifica interna per il tuo team.Pubblica
Pubblica il workflow e invia un altro messaggio di prova.
| Valore dell'Inbound Webhook | A cosa serve |
|---|---|
contact.phone | Il telefono del contatto. Aggiungi + davanti. |
contact.name | Il nome WhatsApp del mittente. Può essere vuoto. |
message.content | Il testo. Per foto, messaggi vocali e file è un'etichetta come 📸 Image, e le didascalie non sono incluse. |
message.timestamp | Quando il messaggio è stato inviato su WhatsApp (ISO 8601, UTC). |
message.media.url | Un link per scaricare una foto o un file. Scade dopo un periodo da 3 giorni e mezzo a 7 giorni, quindi non affidarti a esso in una nota. |
whatsapp_phone | Quale dei tuoi numeri l'ha ricevuto, se più numeri inviano allo stesso workflow. |
event | message_received o message_sent. |
- Solo i messaggi nuovi vengono inviati, dal momento in cui imposti il webhook. Le chat precedenti non vengono importate.
- Un webhook per numero. Ogni numero inbox invia a un solo URL. Se uno Zap di Zapier usa il trigger Incoming WhatsApp Message per lo stesso numero, lo Zap prende il controllo del webhook finché è attivo.
- Rispondere da HighLevel: per rispondere su WhatsApp dallo stesso workflow, aggiungi l'azione Custom Webhook con
"phone": "{{contact.phone_raw}}". - Tieni privato l'URL. L'Inbound Webhook di HighLevel non verifica la firma di WbizTool, quindi chiunque abbia l'URL può inviargli dati. Se l'URL viene diffuso, crea un nuovo trigger e incolla il suo URL in WbizTool.
Zapier#
L'app di HighLevel su Zapier si chiama LeadConnector. Ha un solo trigger, Pipeline Stage Changed. Tra le sue azioni ci sono Add/Update Contact e Add Task. Vedi Integrazione con Zapier per collegare WbizTool.
- Invio: trigger LeadConnector Pipeline Stage Changed, poi un passaggio Filter by Zapier per la fase che vuoi, poi WbizTool Send Text-Only WhatsApp Message. Scegli il numero in WhatsApp Number, mappa il telefono del contatto su Phone Number e scrivi il Message. Per altri eventi di HighLevel, usa invece l'azione Custom Webhook.
- Ricezione: trigger WbizTool Incoming WhatsApp Message (serve il componente aggiuntivo Unibox), poi un passaggio Filter by Zapier che prosegue solo quando Contact Phone Hidden e Is Group sono false. Poi LeadConnector Add/Update Contact con il telefono impostato su
+e Contact Phone, poi LeadConnector Add Task con Message Content.
Make#
L'app di HighLevel su Make si chiama GoHighLevel. Questi template usano solo i moduli generici Webhooks, JSON e HTTP di Make, quindi non ti serve una connessione GoHighLevel in Make. Il template di ricezione richiede invece un token Private Integration di HighLevel e il tuo location ID (vedi sotto).
Importa il blueprint
Scarica uno dei template qui sotto. In Make, crea uno scenario, apri il menu … e scegli Import blueprint.
Crea il webhook
Apri il modulo Webhooks, fai clic su Add per creare un webhook e copia il suo indirizzo.
Compila i segnaposto
Sostituisci ogni segnaposto in maiuscolo nei moduli HTTP, come
YOUR_WBIZTOOL_API_KEYeYOUR_WHATSAPP_CLIENT_ID.Collega il webhook
Invio: in HighLevel, aggiungi al tuo workflow un'azione Webhook con l'indirizzo di Make come URL. In Custom Data, aggiungi la chiave
phone_rawcon il valore{{contact.phone_raw}}. Ricezione: incolla l'indirizzo di Make come URL del webhook del numero in Numeri inbox, con solo Messaggi ricevuti spuntato.Eseguilo una volta
Fai clic su Run once in Make e avvia il workflow, oppure invia un messaggio WhatsApp al tuo numero.
Il template di ricezione scrive in HighLevel tramite la sua API con un token Private Integration preso dalle impostazioni del tuo sub-account, con lo scope contacts.write, e il location ID del tuo sub-account. In alternativa puoi usare i moduli Create a Contact e Add a Note to the Contact dell'app GoHighLevel.
n8n#
n8n ha un nodo HighLevel integrato. La sua operazione Contact → Create or Update trova un contatto per telefono o email, oppure ne crea uno, e può aggiungere una Note. Installa prima il community node di WbizTool: vedi Integrazione con n8n.
Importa il workflow
Scarica uno dei template qui sotto. In n8n, crea un workflow e importa il file (menu … → Import from File, oppure incolla il JSON sul canvas).
Aggiungi le credenziali
Apri il nodo WbizTool Send Message e scegli o crea una credenziale WbizTool API. Nel workflow di ricezione, apri il nodo HighLevel e scegli o crea una credenziale HighLevel.
Collega il webhook
Copia l'URL di produzione del nodo Webhook. Invio: usalo come URL di un'azione Webhook di HighLevel, con la chiave Custom Data
phone_rawimpostata su{{contact.phone_raw}}. Ricezione: incollalo come URL del webhook del numero in Numeri inbox, con solo Messaggi ricevuti spuntato.Attiva
Attiva il workflow ed esegui un test.
Pabbly Connect#
Usa il trigger webhook di Pabbly Connect e la sua azione API (Pabbly), configurata come in Inviare messaggi WhatsApp da qualsiasi strumento di automazione. Per la direzione di invio, punta un'azione Webhook di HighLevel all'URL del webhook di Pabbly e mappa phone_raw su phone. Per i messaggi in arrivo, incolla l'URL del webhook di Pabbly come URL del webhook del numero in Numeri inbox.
Template#
| File | Cosa fa |
|---|---|
| ghl-blocks.md | I blocchi da copiare e incollare di questa pagina, in un unico file. |
| gohighlevel-to-whatsapp.make.json | Make: webhook di HighLevel → messaggio WhatsApp. |
| whatsapp-to-gohighlevel.make.json | Make: messaggio WhatsApp in arrivo → contatto e nota in HighLevel. |
| gohighlevel-to-whatsapp.n8n.json | n8n: webhook di HighLevel → messaggio WhatsApp. |
| whatsapp-to-gohighlevel.n8n.json | n8n: messaggio WhatsApp in arrivo → contatto HighLevel con una nota. |
I template non contengono chiavi. Dopo l'importazione, aggiungi le tue nei segnaposto o nelle credenziali.
Risoluzione dei problemi#
| Problema | Cosa fare |
|---|---|
Il messaggio va al numero sbagliato, oppure Invalid phone number | Usa {{contact.phone_raw}}, non {{contact.phone}}. Se in HighLevel il numero del contatto non ha il prefisso internazionale, aggiungi country_code al corpo o correggi il contatto. |
Either phone or group_name parameter is required | Il contatto non ha un numero di telefono. Aggiungi un passaggio If/Else prima dell'azione. |
Auth Error: invalid api key | Controlla l'header Authorization: Bearer, uno spazio, poi la chiave, senza virgolette. La chiave potrebbe essere stata eliminata. Vedi Chiavi API. |
Invalid whatsapp client o Invalid whatsapp client id. | Usa il WhatsApp Client ID da Numeri WhatsApp. È obbligatorio quando hai più di un numero. |
Invalid JSON format: … | Il corpo non è un JSON valido: una virgola mancante, una virgola finale di troppo, un vero a capo in msg, o un valore inserito che contiene virgolette doppie. |
"status": 1, ma non arriva nulla | Il messaggio resta in coda finché il tuo numero WhatsApp non è collegato. Controlla Numeri WhatsApp e Stato del messaggio. |
| Manca l'azione Custom Webhook o Inbound Webhook | L'agenzia non ha attivato le funzioni premium dei workflow (Workflow - Premium Features), oppure il sub-account ha usato le esecuzioni gratuite e non viene riaddebitato. Chiedi alla tua agenzia. |
| Nessun messaggio in arrivo raggiunge HighLevel | Il numero deve mostrare In sincronizzazione in Numeri inbox, con l'URL giusto e Messaggi ricevuti spuntato. Il ricevitore deve rispondere 2xx entro 8 secondi. Le richieste arrivano con lo User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), nel caso in cui un firewall filtri in base a esso. Altre informazioni in Webhook dei messaggi in arrivo. |
| Componente aggiuntivo Unibox richiesto | I messaggi in arrivo richiedono il componente aggiuntivo Unibox su un piano a pagamento o a vita. Vedi Piani e fatturazione. |
| Viene creato un nuovo contatto per ogni messaggio | Mappa Phone con il + davanti, così HighLevel trova il contatto esistente. |
| Le chat di gruppo creano contatti strani | In un passaggio If/Else, salta i messaggi in cui contact.is_group è true. |
| I messaggi in arrivo si sono fermati dopo l'attivazione di uno Zap | Uno Zap con il trigger WbizTool Incoming WhatsApp Message prende il controllo del webhook del numero finché è attivo. Disattiva lo Zap oppure usa un altro numero. |
Pagine correlate#
- API Invia messaggio: tutti i campi e gli errori
- Webhook dei messaggi in arrivo: numeri inbox, consegna, payload
- Chiavi API e Client ID
- Integrazione con Zapier
- Integrazione con n8n
- Inviare da qualsiasi strumento di automazione: Make, Pabbly Connect e altri

