Vai al contenuto
WbizTool

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#

DirezioneEsempioCome
HighLevel → WhatsAppViene 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 → HighLevelUn 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ì.

PercorsoInvio (HighLevel → WhatsApp)Ricezione (WhatsApp → HighLevel)Piani necessari
Workflow di HighLevel (consigliato)Azione Custom Webhook → API Invia messaggioWebhook di WbizTool → trigger Inbound WebhookFunzioni premium dei workflow di HighLevel. Ricezione: il componente aggiuntivo Unibox.
ZapierLeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp MessageWbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact o Add TaskUn account Zapier. Ricezione: il componente aggiuntivo Unibox.
MakeAzione Webhook di HighLevel → Make Webhooks → modulo HTTPWebhook di WbizTool → Make Webhooks → API di HighLevelUn account Make. Ricezione: il componente aggiuntivo Unibox.
n8nAzione Webhook di HighLevel → n8n Webhook → WbizTool Send MessageWebhook di WbizTool → n8n Webhook → nodo HighLeveln8n con il community node di WbizTool. Ricezione: il componente aggiuntivo Unibox.
Pabbly ConnectAzione Webhook di HighLevel → trigger webhook di Pabbly → richiesta API (Pabbly)Webhook di WbizTool → trigger webhook di Pabbly → il tuo passaggio HighLevelUn account Pabbly Connect. Ricezione: il componente aggiuntivo Unibox.

Inviare messaggi WhatsApp da un workflow di HighLevel#

  1. 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.

  2. 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.

  3. 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'header Authorization con il valore Bearer YOUR_API_KEY. Imposta Content-Type su application/json.

  4. Incolla il corpo

    Incolla uno dei blocchi da copiare e incollare in Raw Body e sostituisci 678 con il tuo WhatsApp Client ID. Usa l'icona dei tag di HighLevel per aggiungere altri campi del contatto al messaggio.

  5. 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

Raw Body per l'azione Custom Webhook
{
  "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: 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 \n nel testo. Un vero a capo rende il JSON non valido.
  • Immagini e file: i link devono essere pubblici. msg diventa 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. Invia group_name oppure phone, 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.

  1. 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.

  2. 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.

  3. 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.

  4. Salta i gruppi e i numeri nascosti

    Aggiungi un passaggio If/Else che prosegue solo quando event è message_received, contact.is_group è false e contact.phone non è 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.

  5. 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.

  6. 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.

  7. Pubblica

    Pubblica il workflow e invia un altro messaggio di prova.

Valore dell'Inbound WebhookA cosa serve
contact.phoneIl telefono del contatto. Aggiungi + davanti.
contact.nameIl nome WhatsApp del mittente. Può essere vuoto.
message.contentIl testo. Per foto, messaggi vocali e file è un'etichetta come 📸 Image, e le didascalie non sono incluse.
message.timestampQuando il messaggio è stato inviato su WhatsApp (ISO 8601, UTC).
message.media.urlUn 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_phoneQuale dei tuoi numeri l'ha ricevuto, se più numeri inviano allo stesso workflow.
eventmessage_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).

  1. Importa il blueprint

    Scarica uno dei template qui sotto. In Make, crea uno scenario, apri il menu … e scegli Import blueprint.

  2. Crea il webhook

    Apri il modulo Webhooks, fai clic su Add per creare un webhook e copia il suo indirizzo.

  3. Compila i segnaposto

    Sostituisci ogni segnaposto in maiuscolo nei moduli HTTP, come YOUR_WBIZTOOL_API_KEY e YOUR_WHATSAPP_CLIENT_ID.

  4. 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_raw con 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.

  5. 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.

  1. 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).

  2. 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.

  3. 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_raw impostata su {{contact.phone_raw}}. Ricezione: incollalo come URL del webhook del numero in Numeri inbox, con solo Messaggi ricevuti spuntato.

  4. 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#

FileCosa fa
ghl-blocks.mdI blocchi da copiare e incollare di questa pagina, in un unico file.
gohighlevel-to-whatsapp.make.jsonMake: webhook di HighLevel → messaggio WhatsApp.
whatsapp-to-gohighlevel.make.jsonMake: messaggio WhatsApp in arrivo → contatto e nota in HighLevel.
gohighlevel-to-whatsapp.n8n.jsonn8n: webhook di HighLevel → messaggio WhatsApp.
whatsapp-to-gohighlevel.n8n.jsonn8n: 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#

ProblemaCosa fare
Il messaggio va al numero sbagliato, oppure Invalid phone numberUsa {{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 requiredIl contatto non ha un numero di telefono. Aggiungi un passaggio If/Else prima dell'azione.
Auth Error: invalid api keyControlla 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 nullaIl 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 WebhookL'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 HighLevelIl 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 richiestoI 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 messaggioMappa Phone con il + davanti, così HighLevel trova il contatto esistente.
Le chat di gruppo creano contatti straniIn 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 ZapUno 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#