Integrationen
GoHighLevel und WhatsApp
Verbinden Sie GoHighLevel (HighLevel) mit WbizTool, und Ihre Workflows senden WhatsApp-Nachrichten von Ihrer eigenen WhatsApp-Nummer. Eingehende WhatsApp-Nachrichten können auch zurück in HighLevel gelangen, als Notiz, Tag oder Aufgabe beim Kontakt.
Alles auf dieser Seite nutzt Funktionen, die es auf beiden Seiten schon gibt: die Workflow-Webhooks von HighLevel sowie die WbizTool-API Nachricht senden und die Webhooks für eingehende Nachrichten. Sie installieren nichts.
Wer darf das: In WbizTool erstellt ein Inhaber den API-Schlüssel (API-Schlüssel), und ein Inhaber oder Bearbeiter richtet die Webhooks für eingehende Nachrichten ein. In HighLevel baut sie jemand, der im Unterkonto (Sub-Account) Workflows bearbeiten darf. Die Agentur muss die Premium-Workflow-Funktionen von HighLevel einschalten (siehe Bevor Sie beginnen).
Was Sie tun können#
| Richtung | Beispiel | Wie |
|---|---|---|
| HighLevel → WhatsApp | Ein Formular wird abgeschickt, ein Tag hinzugefügt oder ein Termin gebucht, und der Kontakt erhält eine WhatsApp-Nachricht. | Eine Custom Webhook-Aktion in einem HighLevel-Workflow ruft die WbizTool-API „Nachricht senden“ auf. |
| WhatsApp → HighLevel | Ein Kunde schreibt an Ihre WhatsApp-Nummer, und die Nachricht wird als Notiz bei seinem HighLevel-Kontakt hinzugefügt. Gibt es den Kontakt noch nicht, wird er angelegt. | Eine WbizTool-Posteingangsnummer sendet jede Nachricht an einen HighLevel-Trigger Inbound Webhook. Dafür ist das Unibox-Add-on nötig. |
Bevor Sie beginnen#
- Eine verbundene WhatsApp-Nummer unter WhatsApp-Nummern und ihre WhatsApp-Client-ID (die bei der Nummer angezeigte ID), zum Beispiel
678. - Ein WbizTool-API-Schlüssel von Einstellungen → API-Schlüssel. In HighLevel steht er in einem
Authorization: Bearer-Header, Sie brauchen also keine Client-ID. Siehe Schlüssel im Header senden. - Die Premium-Workflow-Funktionen von HighLevel. HighLevel führt Custom Webhook und Inbound Webhook als Premium-Workflow-Funktionen. Agenturen mit jedem HighLevel-Plan können sie einschalten: Gehen Sie in der Agency View zu Settings → Company und aktivieren Sie Workflow - Premium Features. HighLevel berechnet jede Premium-Ausführung, und jedes Unterkonto erhält 100 kostenlose Premium-Ausführungen (einmalig, nicht jeden Monat). Die Agentur kann die Kosten an das Unterkonto weiterberechnen (Rebilling). Die Preise von HighLevel stehen auf dessen eigener Hilfeseite.
- Nur für eingehende Nachrichten: das Unibox-Add-on zu einem bezahlten Plan oder Lifetime-Plan von WbizTool (nicht in der kostenlosen Testphase). Es kostet 20 $ pro Monat oder 200 $ pro Jahr zum US-Listenpreis für jede WhatsApp-Nummer im Posteingang. Ein Inhaber fügt es unter Abrechnung & Pläne hinzu (siehe Add-ons).
Einen Weg wählen#
Der Weg über HighLevel-Workflows ist der kürzeste: HighLevel ruft WbizTool direkt auf, ohne ein anderes Tool dazwischen. Nutzen Sie ein Automatisierungstool nur, wenn Ihre Workflows schon dort laufen.
| Weg | Senden (HighLevel → WhatsApp) | Empfangen (WhatsApp → HighLevel) | Was Sie brauchen |
|---|---|---|---|
| HighLevel-Workflows (empfohlen) | Aktion Custom Webhook → API „Nachricht senden“ | WbizTool-Webhook → Trigger Inbound Webhook | Premium-Workflow-Funktionen von HighLevel. Empfangen: das Unibox-Add-on. |
| Zapier | LeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact oder Add Task | Ein Zapier-Konto. Empfangen: das Unibox-Add-on. |
| Make | HighLevel-Aktion Webhook → Make Webhooks → Modul HTTP | WbizTool-Webhook → Make Webhooks → HighLevel-API | Ein Make-Konto. Empfangen: das Unibox-Add-on. |
| n8n | HighLevel-Aktion Webhook → n8n Webhook → WbizTool Send Message | WbizTool-Webhook → n8n Webhook → Node HighLevel | n8n mit der WbizTool-Community-Node. Empfangen: das Unibox-Add-on. |
| Pabbly Connect | HighLevel-Aktion Webhook → Pabbly-Webhook-Trigger → Anfrage API (Pabbly) | WbizTool-Webhook → Pabbly-Webhook-Trigger → Ihr HighLevel-Schritt | Ein Pabbly-Connect-Konto. Empfangen: das Unibox-Add-on. |
WhatsApp-Nachrichten aus einem HighLevel-Workflow senden#
Workflow öffnen oder erstellen
Öffnen Sie in Ihrem HighLevel-Unterkonto Automation und erstellen Sie einen Workflow oder bearbeiten Sie einen bestehenden. Geben Sie ihm den gewünschten Trigger, etwa ein abgeschicktes Formular, ein neues Tag oder einen gebuchten Termin.
Aktion Custom Webhook hinzufügen
Klicken Sie an der Stelle, an der die Nachricht rausgehen soll, auf + und dann auf Send Data → Custom Webhook (oder suchen Sie in den Aktionen nach „webhook“ und wählen Sie Custom Webhook). Die einfache Aktion Webhook kann den Header und den Body, die diese API braucht, nicht setzen.
Anfrage einstellen
Setzen Sie Event auf CUSTOM und Method auf POST. Setzen Sie die URL auf
https://wbiztool.com/api/v1/send_msg/. Wählen Sie bei Authorization die Option Bearer Token und fügen Sie Ihren WbizTool-API-Schlüssel ein, oder wählen Sie keine Authentifizierung und fügen Sie den HeaderAuthorizationmit dem WertBearer YOUR_API_KEYhinzu. Setzen Sie Content-Type aufapplication/json.Body einfügen
Fügen Sie einen der Blöcke zum Kopieren unter Raw Body ein und ersetzen Sie
678durch Ihre WhatsApp-Client-ID. Mit dem Tag-Symbol von HighLevel fügen Sie der Nachricht weitere Kontaktfelder hinzu.Testen und veröffentlichen
Speichern Sie die Aktion und veröffentlichen Sie den Workflow. Führen Sie ihn für einen Testkontakt mit Ihrer eigenen Telefonnummer aus. Jede Ausführung erscheint in den Ausführungsprotokollen (Execution Logs) des Workflows. Nimmt WbizTool die Nachricht an, antwortet es mit
"status": 1. Die Nachricht geht dann von Ihrer WhatsApp-Nummer raus.
Das Feld für die Telefonnummer#
Verwenden Sie {{contact.phone_raw}}, nicht {{contact.phone}}. HighLevels {{contact.phone}} ist zum Lesen formatiert, etwa (515) 555-2345, ohne Ländervorwahl. {{contact.phone_raw}} ist dieselbe Nummer im internationalen Format, etwa +15155552345.
WbizTool entfernt das +, Leerzeichen, Bindestriche und Klammern für Sie. Eine mit + geschriebene Nummer enthält ihre Ländervorwahl schon, Sie müssen also kein country_code senden. Wurden einige Ihrer Kontakte ohne Ländervorwahl gespeichert, fügen Sie dem Body "country_code": "1" hinzu (die Vorwahl Ihres Landes). Sie wird nur Nummern ohne + vorangestellt. Siehe Nachricht senden → phone.
Blöcke zum Kopieren#
URL: https://wbiztool.com/api/v1/send_msg/ · Method: POST · Headers: Authorization: Bearer YOUR_API_KEY und 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: die ID der Nummer, von der gesendet wird. Sie können sie nur weglassen, wenn Ihr Arbeitsbereich genau eine verbundene Nummer hat.msg: bis zu 3.000 Zeichen. WhatsApp-Formatierung funktioniert:*bold*,_italic_. Für eine neue Zeile tippen Sie\nin den Text. Ein echter Zeilenumbruch macht das JSON ungültig.- Bilder und Dateien: Die Links müssen öffentlich sein.
msgwird zur Bildunterschrift. Siehe Bilder und Dateien senden. expire_after_seconds: Ist die Nachricht innerhalb dieser Zeit nicht rausgegangen, etwa weil die Nummer getrennt war, wird sie als abgelaufen markiert und nicht gesendet.- Gruppen:
group_nameist der genaue Name einer WhatsApp-Gruppe, in der Ihre Nummer Mitglied ist. Senden Siegroup_nameoderphone, nie beides. Siehe An Gruppe senden.
Eingehende WhatsApp-Nachrichten in HighLevel protokollieren#
Diese Richtung braucht das Unibox-Add-on. Jede Nachricht, die Ihre WhatsApp-Nummer empfängt, wird an den HighLevel-Trigger Inbound Webhook gesendet. Der Workflow sucht oder erstellt dann den Kontakt und fügt die Nachricht als Notiz, Tag oder Aufgabe hinzu. An anderen Stellen in HighLevel erscheinen die Nachrichten nicht.
Workflow mit dem Trigger Inbound Webhook erstellen
Erstellen Sie in HighLevel einen Workflow und wählen Sie den Trigger Inbound Webhook. Kopieren Sie die angezeigte Webhook-URL.
Ihre WhatsApp-Nummer darauf richten
Öffnen Sie in WbizTool die Posteingangsnummern. Klicken Sie auf Nummer zum Posteingang hinzufügen, wählen Sie die Nummer und fügen Sie die HighLevel-URL unter Webhook-URL (optional) ein. Bei einer Nummer, die schon im Posteingang ist, fügen Sie sie in den Webhook-Einstellungen der Nummer ein. Haken Sie unter Zu sendende Nachrichten nur Empfangene Nachrichten an. Jede Zustellung ist in HighLevel eine Premium-Ausführung, lassen Sie Gesendete Nachrichten also aus, wenn Sie sie nicht brauchen.
Testnachricht senden
Schicken Sie Ihrer WhatsApp-Nummer von einem anderen Telefon eine Nachricht. Sie wird nach der nächsten Prüfung gesendet, meist innerhalb von ein, zwei Minuten. Klicken Sie in HighLevel auf Test Trigger, wählen Sie die Anfrage unter Mapping Reference und speichern Sie den Trigger. Die Felder stehen unter Payload.
Gruppen und verborgene Nummern überspringen
Fügen Sie einen If/Else-Schritt hinzu, der nur weitermacht, wenn
eventgleichmessage_receivedist,contact.is_groupgleichfalseundcontact.phonenicht leer ist. WhatsApp verbirgt manchmal die Nummer eines Absenders, und Gruppennachrichten tragen statt einer Telefonnummer die ID der Gruppe.Kontakt suchen oder erstellen
Setzen Sie in der Aktion Create/Update Contact das Feld Phone auf
+gefolgt von contact → phone aus den Werten des Inbound Webhook. WbizTool sendet die Nummer ohne+, und das+sagt HighLevel, dass sie die Ländervorwahl enthält. Sie können auch contact → name zuordnen. Das ist der WhatsApp-Name des Absenders, und er kann einen Namen ersetzen, den Sie in HighLevel geändert haben.Nachricht zum Kontakt hinzufügen
Fügen Sie eine Aktion Add to Notes hinzu. Schreiben Sie eine Notiz wie „WhatsApp-Nachricht:“ und wählen Sie message → content und message → timestamp aus den Werten des Inbound Webhook. Sie können auch Add Contact Tag (zum Beispiel
whatsapp), eine Aufgabe oder eine interne Benachrichtigung für Ihr Team hinzufügen.Veröffentlichen
Veröffentlichen Sie den Workflow und senden Sie noch eine Testnachricht.
| Wert des Inbound Webhook | Wofür |
|---|---|
contact.phone | Die Telefonnummer des Kontakts. Stellen Sie + voran. |
contact.name | Der WhatsApp-Name des Absenders. Kann leer sein. |
message.content | Der Text. Bei Fotos, Sprachnachrichten und Dateien ist es ein Label wie 📸 Image, Bildunterschriften sind nicht enthalten. |
message.timestamp | Wann die Nachricht auf WhatsApp gesendet wurde (ISO 8601, UTC). |
message.media.url | Ein Download-Link für ein Foto oder eine Datei. Er läuft nach 3½ bis 7 Tagen ab, verlassen Sie sich in einer Notiz also nicht darauf. |
whatsapp_phone | Welche Ihrer Nummern sie empfangen hat, falls mehrere Nummern an denselben Workflow senden. |
event | message_received oder message_sent. |
- Nur neue Nachrichten werden gesendet, ab dem Moment, in dem der Webhook eingerichtet ist. Ältere Chats werden nicht importiert.
- Ein Webhook pro Nummer. Jede Posteingangsnummer sendet an eine URL. Nutzt ein Zapier-Zap den Trigger Incoming WhatsApp Message für dieselbe Nummer, übernimmt der Zap den Webhook, solange er eingeschaltet ist.
- Aus HighLevel antworten: Um aus demselben Workflow auf WhatsApp zu antworten, fügen Sie die Aktion Custom Webhook mit
"phone": "{{contact.phone_raw}}"hinzu. - Halten Sie die URL geheim. HighLevels Inbound Webhook prüft die Signatur von WbizTool nicht, jeder mit der URL kann also daran senden. Gelangt sie nach außen, erstellen Sie einen neuen Trigger und fügen dessen URL in WbizTool ein.
Zapier#
Die HighLevel-App auf Zapier heißt LeadConnector. Sie hat einen Trigger, Pipeline Stage Changed. Zu ihren Aktionen gehören Add/Update Contact und Add Task. Wie Sie WbizTool verbinden, steht unter Zapier-Integration.
- Senden: Trigger LeadConnector Pipeline Stage Changed, dann ein Schritt Filter by Zapier für die gewünschte Phase, dann WbizTool Send Text-Only WhatsApp Message. Wählen Sie die Nummer unter WhatsApp Number, ordnen Sie die Telefonnummer des Kontakts Phone Number zu und schreiben Sie die Message. Für andere HighLevel-Ereignisse nutzen Sie stattdessen die Aktion Custom Webhook.
- Empfangen: Trigger WbizTool Incoming WhatsApp Message (braucht das Unibox-Add-on), dann ein Schritt Filter by Zapier, der nur weitermacht, wenn Contact Phone Hidden und Is Group false sind. Dann LeadConnector Add/Update Contact mit der Telefonnummer
+und Contact Phone, dann LeadConnector Add Task mit Message Content.
Make#
Die HighLevel-App auf Make heißt GoHighLevel. Diese Vorlagen nutzen nur die allgemeinen Make-Module Webhooks, JSON und HTTP, Sie brauchen in Make also keine GoHighLevel-Verbindung. Die Vorlage zum Empfangen braucht stattdessen ein HighLevel-Private-Integration-Token und Ihre Location-ID (siehe unten).
Blueprint importieren
Laden Sie unten eine Vorlage herunter. Erstellen Sie in Make ein Szenario, öffnen Sie das Menü … und wählen Sie Import blueprint.
Webhook erstellen
Öffnen Sie das Modul Webhooks, klicken Sie auf Add, um einen Webhook zu erstellen, und kopieren Sie seine Adresse.
Platzhalter ausfüllen
Ersetzen Sie in den HTTP-Modulen jeden Platzhalter in Großbuchstaben, etwa
YOUR_WBIZTOOL_API_KEYundYOUR_WHATSAPP_CLIENT_ID.Webhook verbinden
Senden: Fügen Sie in HighLevel Ihrem Workflow eine Aktion Webhook mit der Make-Adresse als URL hinzu. Fügen Sie unter Custom Data den Schlüssel
phone_rawmit dem Wert{{contact.phone_raw}}hinzu. Empfangen: Fügen Sie die Make-Adresse unter Posteingangsnummern als Webhook-URL der Nummer ein, nur mit Empfangene Nachrichten angehakt.Einmal ausführen
Klicken Sie in Make auf Run once und lösen Sie den Workflow aus, oder senden Sie eine WhatsApp-Nachricht an Ihre Nummer.
Die Vorlage zum Empfangen schreibt über die HighLevel-API in HighLevel, mit einem Private Integration-Token aus den Einstellungen Ihres Unterkontos mit dem Scope contacts.write und der Location-ID Ihres Unterkontos. Sie können stattdessen auch die Module Create a Contact und Add a Note to the Contact der GoHighLevel-App nutzen.
n8n#
n8n hat eine eingebaute Node HighLevel. Ihre Operation Contact → Create or Update sucht einen Kontakt per Telefonnummer oder E-Mail oder legt einen an und kann eine Note hinzufügen. Installieren Sie zuerst die WbizTool-Community-Node: siehe n8n-Integration.
Workflow importieren
Laden Sie unten eine Vorlage herunter. Erstellen Sie in n8n einen Workflow und importieren Sie die Datei (Menü … → Import from File, oder fügen Sie das JSON auf der Arbeitsfläche ein).
Zugangsdaten hinzufügen
Öffnen Sie die Node WbizTool Send Message und wählen oder erstellen Sie ein Credential WbizTool API. Öffnen Sie im Workflow zum Empfangen die Node HighLevel und wählen oder erstellen Sie ein HighLevel-Credential.
Webhook verbinden
Kopieren Sie die Production URL der Node Webhook. Senden: Nutzen Sie sie als URL einer HighLevel-Aktion Webhook, mit dem Custom-Data-Schlüssel
phone_rawauf{{contact.phone_raw}}. Empfangen: Fügen Sie sie unter Posteingangsnummern als Webhook-URL der Nummer ein, nur mit Empfangene Nachrichten angehakt.Aktivieren
Aktivieren Sie den Workflow und führen Sie einen Test aus.
Pabbly Connect#
Nutzen Sie den eigenen Webhook-Trigger von Pabbly Connect und seine Aktion API (Pabbly), eingerichtet wie unter WhatsApp-Nachrichten aus jedem Automatisierungstool senden. Für die Senderichtung richten Sie eine HighLevel-Aktion Webhook auf die Pabbly-Webhook-URL und ordnen phone_raw dem Feld phone zu. Für eingehende Nachrichten fügen Sie die Pabbly-Webhook-URL unter Posteingangsnummern als Webhook-URL der Nummer ein.
Vorlagen#
| Datei | Was sie tut |
|---|---|
| ghl-blocks.md | Die Blöcke zum Kopieren von dieser Seite, in einer Datei. |
| gohighlevel-to-whatsapp.make.json | Make: HighLevel-Webhook → WhatsApp-Nachricht. |
| whatsapp-to-gohighlevel.make.json | Make: eingehende WhatsApp-Nachricht → HighLevel-Kontakt und Notiz. |
| gohighlevel-to-whatsapp.n8n.json | n8n: HighLevel-Webhook → WhatsApp-Nachricht. |
| whatsapp-to-gohighlevel.n8n.json | n8n: eingehende WhatsApp-Nachricht → HighLevel-Kontakt mit Notiz. |
Die Vorlagen enthalten keine Schlüssel. Tragen Sie nach dem Import Ihre eigenen in die Platzhalter oder Credentials ein.
Fehlerbehebung#
| Problem | Was zu tun ist |
|---|---|
Die Nachricht geht an die falsche Nummer, oder Invalid phone number | Verwenden Sie {{contact.phone_raw}}, nicht {{contact.phone}}. Hat die Nummer des Kontakts in HighLevel keine Ländervorwahl, fügen Sie dem Body country_code hinzu oder korrigieren Sie den Kontakt. |
Either phone or group_name parameter is required | Der Kontakt hat keine Telefonnummer. Fügen Sie vor der Aktion einen If/Else-Schritt hinzu. |
Auth Error: invalid api key | Prüfen Sie den Header Authorization: Bearer, ein Leerzeichen, dann der Schlüssel, ohne Anführungszeichen. Der Schlüssel wurde vielleicht gelöscht. Siehe API-Schlüssel. |
Invalid whatsapp client oder Invalid whatsapp client id. | Verwenden Sie die WhatsApp-Client-ID von WhatsApp-Nummern. Sie ist Pflicht, wenn Sie mehr als eine Nummer haben. |
Invalid JSON format: … | Der Body ist kein gültiges JSON: ein fehlendes Komma, ein Komma zu viel am Ende, ein echter Zeilenumbruch in msg oder ein eingesetzter Wert mit doppeltem Anführungszeichen. |
"status": 1, aber nichts kommt an | Die Nachricht wartet in der Warteschlange, bis Ihre WhatsApp-Nummer verbunden ist. Prüfen Sie WhatsApp-Nummern und den Nachrichtenstatus. |
| Die Aktion Custom Webhook oder Inbound Webhook fehlt | Die Agentur hat die Premium-Workflow-Funktionen (Workflow - Premium Features) nicht eingeschaltet, oder das Unterkonto hat seine kostenlosen Ausführungen verbraucht und wird nicht weiterberechnet. Fragen Sie Ihre Agentur. |
| Keine eingehenden Nachrichten erreichen HighLevel | Die Nummer muss unter Posteingangsnummern Synchronisiert zeigen, mit der richtigen URL und angehaktem Empfangene Nachrichten. Der Empfänger muss innerhalb von 8 Sekunden mit 2xx antworten. Die Anfragen kommen mit dem User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), falls eine Firewall danach filtert. Mehr unter Webhooks für eingehende Nachrichten. |
| Unibox-Add-on erforderlich | Eingehende Nachrichten brauchen das Unibox-Add-on zu einem bezahlten Plan oder Lifetime-Plan. Siehe Pläne und Abrechnung. |
| Für jede Nachricht wird ein neuer Kontakt angelegt | Ordnen Sie Phone mit dem + davor zu, damit HighLevel den bestehenden Kontakt findet. |
| Gruppenchats erzeugen seltsame Kontakte | Überspringen Sie in einem If/Else-Schritt Nachrichten, bei denen contact.is_group gleich true ist. |
| Eingehende Nachrichten hörten auf, nachdem ein Zap eingeschaltet wurde | Ein Zap mit dem WbizTool-Trigger Incoming WhatsApp Message übernimmt den Webhook der Nummer, solange er eingeschaltet ist. Schalten Sie den Zap aus oder nutzen Sie eine andere Nummer. |
Verwandte Themen#
- Nachricht senden: alle Felder und Fehler
- Webhooks für eingehende Nachrichten: Posteingangsnummern, Zustellung, Payload
- API-Schlüssel und Client-ID
- Zapier-Integration
- n8n-Integration
- Aus jedem Automatisierungstool senden: Make, Pabbly Connect und andere

