Zum Inhalt springen
WbizTool

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#

RichtungBeispielWie
HighLevel → WhatsAppEin 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 → HighLevelEin 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.

WegSenden (HighLevel → WhatsApp)Empfangen (WhatsApp → HighLevel)Was Sie brauchen
HighLevel-Workflows (empfohlen)Aktion Custom Webhook → API „Nachricht senden“WbizTool-Webhook → Trigger Inbound WebhookPremium-Workflow-Funktionen von HighLevel. Empfangen: das Unibox-Add-on.
ZapierLeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp MessageWbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact oder Add TaskEin Zapier-Konto. Empfangen: das Unibox-Add-on.
MakeHighLevel-Aktion Webhook → Make Webhooks → Modul HTTPWbizTool-Webhook → Make Webhooks → HighLevel-APIEin Make-Konto. Empfangen: das Unibox-Add-on.
n8nHighLevel-Aktion Webhook → n8n Webhook → WbizTool Send MessageWbizTool-Webhook → n8n Webhook → Node HighLeveln8n mit der WbizTool-Community-Node. Empfangen: das Unibox-Add-on.
Pabbly ConnectHighLevel-Aktion Webhook → Pabbly-Webhook-Trigger → Anfrage API (Pabbly)WbizTool-Webhook → Pabbly-Webhook-Trigger → Ihr HighLevel-SchrittEin Pabbly-Connect-Konto. Empfangen: das Unibox-Add-on.

WhatsApp-Nachrichten aus einem HighLevel-Workflow senden#

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

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

  3. 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 Header Authorization mit dem Wert Bearer YOUR_API_KEY hinzu. Setzen Sie Content-Type auf application/json.

  4. Body einfügen

    Fügen Sie einen der Blöcke zum Kopieren unter Raw Body ein und ersetzen Sie 678 durch Ihre WhatsApp-Client-ID. Mit dem Tag-Symbol von HighLevel fügen Sie der Nachricht weitere Kontaktfelder hinzu.

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

Raw Body für die Aktion 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: 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 \n in den Text. Ein echter Zeilenumbruch macht das JSON ungültig.
  • Bilder und Dateien: Die Links müssen öffentlich sein. msg wird 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_name ist der genaue Name einer WhatsApp-Gruppe, in der Ihre Nummer Mitglied ist. Senden Sie group_name oder phone, 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.

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

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

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

  4. Gruppen und verborgene Nummern überspringen

    Fügen Sie einen If/Else-Schritt hinzu, der nur weitermacht, wenn event gleich message_received ist, contact.is_group gleich false und contact.phone nicht leer ist. WhatsApp verbirgt manchmal die Nummer eines Absenders, und Gruppennachrichten tragen statt einer Telefonnummer die ID der Gruppe.

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

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

  7. Veröffentlichen

    Veröffentlichen Sie den Workflow und senden Sie noch eine Testnachricht.

Wert des Inbound WebhookWofür
contact.phoneDie Telefonnummer des Kontakts. Stellen Sie + voran.
contact.nameDer WhatsApp-Name des Absenders. Kann leer sein.
message.contentDer Text. Bei Fotos, Sprachnachrichten und Dateien ist es ein Label wie 📸 Image, Bildunterschriften sind nicht enthalten.
message.timestampWann die Nachricht auf WhatsApp gesendet wurde (ISO 8601, UTC).
message.media.urlEin 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_phoneWelche Ihrer Nummern sie empfangen hat, falls mehrere Nummern an denselben Workflow senden.
eventmessage_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).

  1. Blueprint importieren

    Laden Sie unten eine Vorlage herunter. Erstellen Sie in Make ein Szenario, öffnen Sie das Menü … und wählen Sie Import blueprint.

  2. Webhook erstellen

    Öffnen Sie das Modul Webhooks, klicken Sie auf Add, um einen Webhook zu erstellen, und kopieren Sie seine Adresse.

  3. Platzhalter ausfüllen

    Ersetzen Sie in den HTTP-Modulen jeden Platzhalter in Großbuchstaben, etwa YOUR_WBIZTOOL_API_KEY und YOUR_WHATSAPP_CLIENT_ID.

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

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

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

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

  3. 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_raw auf {{contact.phone_raw}}. Empfangen: Fügen Sie sie unter Posteingangsnummern als Webhook-URL der Nummer ein, nur mit Empfangene Nachrichten angehakt.

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

DateiWas sie tut
ghl-blocks.mdDie Blöcke zum Kopieren von dieser Seite, in einer Datei.
gohighlevel-to-whatsapp.make.jsonMake: HighLevel-Webhook → WhatsApp-Nachricht.
whatsapp-to-gohighlevel.make.jsonMake: eingehende WhatsApp-Nachricht → HighLevel-Kontakt und Notiz.
gohighlevel-to-whatsapp.n8n.jsonn8n: HighLevel-Webhook → WhatsApp-Nachricht.
whatsapp-to-gohighlevel.n8n.jsonn8n: 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#

ProblemWas zu tun ist
Die Nachricht geht an die falsche Nummer, oder Invalid phone numberVerwenden 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 requiredDer Kontakt hat keine Telefonnummer. Fügen Sie vor der Aktion einen If/Else-Schritt hinzu.
Auth Error: invalid api keyPrü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 anDie 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 fehltDie 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 HighLevelDie 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 erforderlichEingehende 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 angelegtOrdnen 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 wurdeEin 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#