DM Champ Docs

GoHighLevel (GHL) Integration

Nutzen Sie bereits GoHighLevel (GHL) zur Verwaltung Ihres Unternehmens? Diese Integration ermöglicht es Ihnen, die KI-gestützte Nachrichtenfunktion von DM Champ zu Ihrem bestehenden GHL-Setup hinzuzufügen. Nachrichten, die in GHL eingehen, werden zur KI-gestützten Bearbeitung an DM Champ weitergeleitet, und Antworten von DM Champ werden über GHL auf dem ursprünglichen Kanal an den Kunden zurückgesendet.

Nutzen Sie ein anderes CRM? Es benötigt keinen eigenen Bildschirm, um mit DM Champ zu funktionieren: Informationen zu benutzerdefinierten Funktionen, der API und Webhooks finden Sie unter Verbinden eines Tools, das wir nicht auflisten.

Das bedeutet, dass Sie GHL weiterhin als Ihre zentrale Anlaufstelle nutzen können, während die KI die KI-gesteuerten Konversationen übernimmt.

Was dieses Setup nicht leistet: Es handelt sich um ein Zwei-Wege-Nachrichten-Relay, das Sie mit GHL-Workflows und Webhooks erstellen, nicht um eine Ein-Klick-Verbindung. Es synchronisiert keine Leads oder Kontakte aus dem GHL-CRM (ein Kontakt wird hier erstellt, wenn seine erste Nachricht weitergeleitet wird), und Sie können von DM Champ aus keine Nachrichten an GHL-Listen oder Smart Lists senden.

Hinweis: Dies ist eine technischere Integration, die das Einrichten automatisierter Workflows und das Verbinden von Systemen mittels Webhooks (automatische Benachrichtigungen zwischen Apps) und API-Aufrufen erfordert. Wenn Sie sich dabei nicht sicher fühlen, sollten Sie diese Seite an einen Entwickler oder ein technisch versiertes Teammitglied weitergeben.


Voraussetzungen

  • Ein aktives DM Champ-Konto mit Ihrem API-Schlüssel (zu finden unter Einstellungen → Integrationen → API-Schlüssel). Ein API-Schlüssel ist ein eindeutiger Code, der es GHL ermöglicht, sicher mit Ihrem Konto zu kommunizieren.
  • Ein GoHighLevel-Konto mit Berechtigungen zum Erstellen von Workflows und zum Verwalten von Webhooks (automatisierte Benachrichtigungen zwischen Systemen).

Funktionsweise

Richtung Was passiert
GHL an DM Champ Ein Kunde schreibt Ihnen eine Nachricht per SMS, E-Mail, Messenger, Instagram oder Live-Chat in GHL. Ein Workflow leitet diese Nachricht automatisch an DM Champ weiter. DM Champ verarbeitet sie (KI-Antwort, Tagging usw.).
DM Champ an GHL Wenn DM Champ eine Antwort sendet (manuell oder per KI), benachrichtigt dies automatisch GHL. Ein Workflow in GHL findet den Kontakt und sendet die Antwort über den korrekten Kanal.

Workflow 1: GHL an DM Champ

Dieser Workflow leitet eingehende Nachrichten von GHL an DM Champ weiter.

Schritt 1: Workflow erstellen

  1. Klicken Sie in GHL in der Seitenleiste auf Automation und öffnen Sie den Tab Workflows.
  2. Klicken Sie auf Create workflow und dann auf Start from Scratch.
  3. Klicken Sie auf den Stift neben dem Titel und geben Sie ihm einen aussagekräftigen Namen, wie z. B. “Nachricht senden an DM Champ.”

Schritt 2: Trigger hinzufügen

GHL verfügt über einen Customer replied-Trigger. Sie fügen ihn einmal pro Kanal hinzu und verwenden den Filter Reply channel, um den Kanal auszuwählen:

  1. Klicken Sie auf Add new trigger, suchen Sie nach “Customer replied” und wählen Sie ihn aus.
  2. Klicken Sie auf Add filters, wählen Sie Reply channel und wählen Sie einen Kanal aus (der Filter akzeptiert einen Kanal pro Trigger).
  3. Geben Sie dem Trigger einen eindeutigen Namen, zum Beispiel “Customer replied SMS”, und klicken Sie auf Save trigger.
  4. Wiederholen Sie dies für jeden Kanal, den Sie weiterleiten möchten.
Trigger-Name Antwortkanal
Customer replied SMS SMS
Customer replied Email Email
Customer replied Facebook messenger Facebook messenger
Customer replied Instagram DM Instagram DM
Customer replied Live chat Live chat
Customer replied Chat widget Chat widget

Website-Chat kann entweder als Live chat oder Chat widget eingehen. Fügen Sie also für beides einen Trigger hinzu, wenn Sie den Website-Chat von GHL verwenden. Sie können alle diese Kanäle hinzufügen oder nur die für Ihr Setup relevanten.

Schritt 3: Tag-Filter hinzufügen (Optional)

Wenn Sie Nachrichten nur von bestimmten Kontakten weiterleiten möchten:

  1. Klicken Sie bei jedem Trigger auf Add filters.
  2. Setzen Sie die Bedingung auf “Contact has tag.”
  3. Wählen Sie Ihr(e) Tag(s) aus.
  4. Legen Sie fest, ob der Kontakt irgendeines oder alle der ausgewählten Tags haben soll.

Schritt 4: Einen Kanal-Split erstellen

Fügen Sie eine If / else-Aktion hinzu (wählen Sie Build your own), um jeden Kanal an seinen eigenen Webhook weiterzuleiten. Jeder Zweig prüft, welcher Trigger den Workflow gestartet hat: Setzen Sie das Feld auf Workflow trigger, den Operator auf Is und den Wert auf den Namen des Triggers aus Schritt 2.

Zweig Bedingung
Email Workflow trigger ist Customer replied Email
SMS Workflow trigger ist Customer replied SMS
Messenger Workflow trigger ist Customer replied Facebook messenger
Instagram Workflow trigger ist Customer replied Instagram DM
Live Chat Workflow trigger ist Customer replied Live chat ODER Customer replied Chat widget (zwei Bedingungen mit ODER verknüpft)

GHL fügt automatisch einen None-Zweig hinzu; lassen Sie diesen leer.

Schritt 5: Webhooks konfigurieren

Fügen Sie für jeden Zweig eine Webhook-Aktion hinzu (unter Send data; Sie benötigen nicht den kostenpflichtigen Custom webhook):

  • Methode: POST

  • URL:

    https://api.dmchamp.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
    
  • Custom Data fields (klicken Sie für jedes Feld auf Add item):

Feld Wert Hinweise
messageSid {{right_now.second}}{{contact.id}} Eindeutige Nachrichten-ID
fromId {{contact.id}} GHL-Kontakt-ID
toId {{user.id}} Ihre GHL-Benutzer-ID (kann leer sein, z. B. bei einem Live-Chat, dem niemand zugewiesen ist; das ist in Ordnung)
body {{message.body}} Der Nachrichteninhalt
channel Siehe Tabelle unten Muss mit dem Zweig übereinstimmen

Fügen Sie nur diese Felder hinzu. DM Champ lehnt jedes Feld ab, das es nicht erkennt, sodass die gesamte Nachricht fehlschlägt, wenn der Webhook ein zusätzliches Feld wie messageType oder status enthält (das Ausführungsprotokoll von GHL zeigt dann Unknown field: ... an). Die einzigen anderen Felder, die akzeptiert werden, sind optional: firstName, lastName und email für den Kontakt sowie mediaUrl mit mediaContentType für einen Anhang.

Tipp: Wenn Sie einen Wert wie {{contact.id}} in ein Wertfeld eingeben, wird dieser in einen Merge-Feld-Chip umgewandelt. Sie können Merge-Felder auch über das Tag-Symbol am Ende des Feldes auswählen.

Kanalwerte pro Zweig:

Zweig channel Wert
E-Mail email
SMS sms
Messenger messenger
Instagram ig
Live-Chat livechat

Wichtig: Stellen Sie sicher, dass der Wert channel exakt übereinstimmt. Bei diesen Werten wird zwischen Groß- und Kleinschreibung unterschieden.

Weitere GHL-Kanäle (TikTok, WhatsApp usw.): Die fünf oben genannten sind Beispiele, keine feste Liste. DM Champ sendet exakt den channel-Wert zurück, den es empfangen hat. Das Relay funktioniert für einen Kanal also nur, wenn GHL selbst sowohl einen „Kunde hat geantwortet“-Trigger dafür (einen Wert im Filter „Antwortkanal“ des Triggers) als auch eine Workflow-Aktion besitzt, die über diesen Kanal sendet. Wo GHL beides hat: Fügen Sie einen „Kunde hat geantwortet“-Trigger dafür hinzu und hier einen Zweig mit Ihrem eigenen Wert (zum Beispiel tiktok), gefolgt von einem passenden Zweig in Workflow 2, der die GHL-Sendeaktion für diesen Kanal verwendet. Der Wert wird gespeichert, wenn ein Kontakt zum ersten Mal DM Champ erreicht. Ein Kontakt, der zuerst über Instagram geschrieben hat, erhält also weiterhin Antworten mit dem Tag ig, selbst wenn er Ihnen später über TikTok schreibt. Ein Kanal, über den GHL in einem Workflow nicht auslösen oder senden kann, kann nicht weitergeleitet werden.

Schritt 6: Wiedereintritt aktivieren

Stellen Sie auf der Registerkarte Einstellungen des Workflows sicher, dass Erneuter Eintritt erlaubt aktiviert ist. Bei neuen GHL-Workflows ist dies standardmäßig eingeschaltet, aber überprüfen Sie es: Ohne diese Einstellung wird nur die erste Nachricht jedes Kontakts weitergeleitet.

Stellen Sie den Workflow anschließend von Entwurf auf Veröffentlicht um. Wenn Sie einen veröffentlichten Workflow später bearbeiten, klicken Sie oben rechts auf Speichern, da die automatische Speicherung nur für Entwürfe gilt.


Workflow 2: DM Champ an GHL

Dieser Workflow empfängt Antworten von DM Champ und sendet sie über den korrekten GHL-Kanal an den Kunden.

Schritt 1: Erstellen Sie den Workflow und dessen Inbound-Webhook-Trigger

In GHL ist der Inbound-Webhook ein Workflow-Trigger, keine Seite unter Einstellungen. Es handelt sich um einen Premium-Trigger, daher kann GHL je nach Ihrem Plan Gebühren pro Ausführung erheben.

  1. Klicken Sie in GHL in der Seitenleiste auf Automatisierung, öffnen Sie Workflows, klicken Sie auf Workflow erstellen und dann auf Von Grund auf neu starten.
  2. Nennen Sie den Workflow „Nachricht an Kontakt senden“.
  3. Klicken Sie auf Neuen Trigger hinzufügen, suchen Sie nach „Webhook“ und wählen Sie Inbound-Webhook. Geben Sie dem Trigger einen Namen, zum Beispiel „Nachrichten von DM Champ“.
  4. Kopieren Sie die URL, die im Feld URL (POST/GET/PUT) angezeigt wird. Sie benötigen diese in Schritt 2.
  5. Der Trigger wird erst gespeichert, wenn GHL eine Beispielanfrage erhalten hat. Schließen Sie zuerst Schritt 2 ab, klicken Sie dann auf Beispielanfragen abrufen (oder Auf neue Anfragen prüfen), wählen Sie die Anfrage unter Mapping-Referenz aus und klicken Sie auf Trigger speichern.

Die URL ändert sich, wenn Sie den Trigger erneut auswählen. GHL generiert jedes Mal eine neue URL, wenn Inbound-Webhook erneut ausgewählt wird. Falls dies geschieht, kopieren Sie die neue URL und fügen Sie sie erneut in die Karte „Benutzerdefinierter Kanal“ ein (Schritt 2), da sonst keine Antworten mehr in GHL ankommen.

Schritt 2: DM Champ konfigurieren

  1. Klicken Sie in DM Champ in der Seitenleiste auf Einstellungen.
  2. Klicken Sie unter Kanäle auf Kanäle.
  3. Scrollen Sie ganz nach unten zur Karte Benutzerdefinierter Kanal.
  4. Fügen Sie die GHL-Inbound-Webhook-URL, die Sie gerade kopiert haben, in Webhook-URL ein (es muss eine öffentliche HTTPS-Adresse sein) und klicken Sie auf Speichern.
  5. Geben Sie GHL die Beispielanfrage: Senden Sie das unten gezeigte Beispiel-JSON einmal mit einem beliebigen HTTP-Tool (zum Beispiel curl -X POST -H "Content-Type: application/json" -d '<the JSON>' <the GHL URL>) an die GHL-URL. Wenn Sie bereits einen Kontakt auf dem benutzerdefinierten Kanal haben, funktioniert es auch, wenn Sie diesem Kontakt eine Nachricht von DM Champ senden. Kehren Sie dann zum Trigger zurück und schließen Sie Schritt 1, Punkt 5 ab.

Dies ist nicht die Seite Settings → Integrations → Webhooks. Diese Seite ist für Ereignisbenachrichtigungen gedacht und sendet eine andere Payload. Das GHL-Outbound-Relay wird auf der Karte Custom channel unter Settings → Channels konfiguriert.

DM Champ sendet nun automatisch eine Benachrichtigung an GHL, jedes Mal wenn eine Nachricht an einen Kontakt gesendet wird. Die gesendeten Daten sehen wie folgt aus:

{
  "contactId": "NtL97bwnhITrfIq8lWFi",
  "messageId": "s28dtg13qNuhXLoKpcLs",
  "userId": "wpDZRvaw4Hgh4whUBpwlKPRftOi2",
  "body": "Message content here",
  "toId": "qtpBsc6fiqkXTnSOeze3",
  "channel": "email"
}

Navigationshinweis: Der API-Schlüssel, den Sie für Workflow 1 verwenden, und die Karte „Benutzerdefinierter Kanal“, die Sie hier nutzen, befinden sich an unterschiedlichen Orten: Einstellungen → Integrationen → API-Schlüssel für den Schlüssel und die Karte Benutzerdefinierter Kanal ganz unten unter Einstellungen → Kanäle für dieses Relay. Die separate Seite Einstellungen → Integrationen → Webhooks ist für Ereignisbenachrichtigungen gedacht und sendet eine andere Payload; siehe Webhooks, falls Sie stattdessen dies benötigen.

Schritt 3: Überprüfen Sie, ob der Trigger gespeichert wurde

Kehren Sie zum Workflow „Nachricht an Kontakt senden“ zurück und bestätigen Sie, dass der Inbound-Webhook-Trigger nun eine Mapping-Referenz anzeigt und gespeichert ist. Die Felder, die DM Champ sendet (body, toId, channel und die übrigen), sind nun als Platzhalter unter Inbound-Webhook-Trigger verfügbar.

Schritt 4: Hinzufügen einer Aktion zum Finden eines Kontakts

  1. Fügen Sie eine Kontakt finden-Aktion hinzu (in der Kategorie Kontakt, nicht eine App-Aktion mit demselben Namen weiter unten in der Liste).
  2. Klicken Sie auf Feld hinzufügen und wählen Sie Kontakt-ID.
  3. Verwenden Sie den Wert: {{inboundWebhookRequest.toId}}. Dies ist die GHL-Kontakt-ID, die Workflow 1 als fromId gesendet hat, sodass sie mit dem Kontakt in GHL übereinstimmt.

„Kontakt finden“ fügt zwei Zweige hinzu: Kontakt gefunden und Kontakt nicht gefunden. Erstellen Sie die nächsten Schritte unter Kontakt gefunden.

Schritt 5: Hinzufügen einer optionalen Tag-Prüfung

Wenn Sie einschränken möchten, welche Kontakte Nachrichten von DM Champ erhalten:

  1. Fügen Sie eine Wenn / sonst-Aktion hinzu.
  2. Überprüfen Sie, ob der Kontakt ein bestimmtes Tag hat.
  3. Wenn das Tag fehlt, beenden Sie den Workflow (fügen Sie eine „Stopp“-Aktion im „sonst“-Zweig hinzu).

Schritt 6: Hinzufügen einer Kanal-Aufteilung

Fügen Sie eine Wenn / sonst-Aktion hinzu, die die Nachricht basierend auf dem Feld Kanal (Kategorie Inbound-Webhook-Trigger) mit dem Operator Ist weiterleitet:

Branch Bedingung Aktion
E-Mail Kanal ist email E-Mail senden (erfordert auch einen Betreff)
SMS Kanal ist sms SMS senden
Messenger Kanal ist messenger Messenger
Instagram Kanal ist ig Instagram DM
Live-Chat Kanal ist livechat Live-Chat-Nachricht senden

Messenger und Instagram erfordern ein verbundenes Konto in GHL. GHL veröffentlicht keinen Workflow, der die Aktion „Messenger“ oder „Instagram DM“ enthält, es sei denn, eine Facebook-Seite oder ein Instagram-Konto ist mit diesem GHL-Unterkonto verbunden. Wenn Sie diese Kanäle nicht nutzen, lassen Sie diese Zweige weg.

Schritt 7: Konfigurieren Sie jede Sendeaktion

Legen Sie in jeder Sendeaktion den Nachrichtentext wie folgt fest:

{{inboundWebhookRequest.body}}

Schritt 8: Wiedereintritt aktivieren

Stellen Sie wie bei Workflow 1 sicher, dass Erneuter Eintritt erlaubt (Allow re-entry) auf der Registerkarte Einstellungen (Settings) des Workflows aktiviert ist, und veröffentlichen Sie dann den Workflow.


Testen der Integration

Testen von GHL an DM Champ (Workflow 1)

  1. Senden Sie eine Nachricht an Ihre GHL-Nummer oder einen verbundenen Kanal (senden Sie sich zum Beispiel selbst eine SMS).
  2. Öffnen Sie DM Champ und überprüfen Sie, ob die Nachricht unter Chats erscheint.
  3. Prüfen Sie, ob die Kanalbezeichnung korrekt ist (SMS, E-Mail usw.).
  4. Wiederholen Sie dies für jeden Kanal, den Sie konfiguriert haben.

Testen von DM Champ an GHL (Workflow 2)

  1. Senden Sie in DM Champ eine Antwort an einen Kontakt (manuell oder lassen Sie die KI antworten).
  2. Öffnen Sie GHL und überprüfen Sie, ob der Kontakt die Nachricht erhalten hat.
  3. Bestätigen Sie, dass sie über den korrekten Kanal gesendet wurde.
  4. Überprüfen Sie, ob der Nachrichteninhalt übereinstimmt.

Fehlerbehebung

Problem Was zu prüfen ist
Nachrichten erreichen DM Champ nicht Öffnen Sie die Ausführungsprotokolle (Execution logs) des Workflows in GHL. Unknown field: ... bedeutet, dass der Webhook ein Feld enthält, das DM Champ nicht akzeptiert: Entfernen Sie es (nur die Felder in Workflow 1, Schritt 5 werden benötigt). Überprüfen Sie andernfalls, ob Ihr API-Schlüssel in der Webhook-URL korrekt ist, ob die Trigger ausgelöst werden und ob „Erneuter Eintritt erlaubt“ aktiviert ist.
Nachrichten erreichen GHL nicht Überprüfen Sie, ob die eingehende GHL-Webhook-URL korrekt in die Webhook-URL auf der Karte Benutzerdefinierter Kanal (Custom channel) unten unter Einstellungen → Kanäle (Settings → Channels) eingefügt wurde (nicht auf der Seite „Einstellungen → Integrationen → Webhooks“, da dies eine andere Funktion ist). Wenn Sie den Trigger für eingehende Webhooks erneut ausgewählt haben, hat sich dessen URL geändert: Fügen Sie die neue URL in die Karte ein. Überprüfen Sie die GHL-Workflow-Ausführungsprotokolle.
Kontakt in GHL nicht gefunden Die toId in den Webhook-Daten muss mit einer vorhandenen GHL-Kontakt-ID übereinstimmen. Stellen Sie sicher, dass Kontakte in beiden Systemen mit übereinstimmenden IDs vorhanden sind.
Falscher Kanal für Antwort verwendet Überprüfen Sie die Kanalwerte in Ihren Bedingungszweigen. Sie müssen exakt übereinstimmen: email, sms, messenger, ig, livechat.
Nur die erste Nachricht wird weitergeleitet Aktivieren Sie Erneuter Eintritt erlaubt (Allow re-entry) in den Einstellungen beider Workflows.
Workflow 2 lässt sich nicht veröffentlichen Entfernen Sie die Aktion „Messenger“ oder „Instagram DM“ oder verbinden Sie zuerst das entsprechende Facebook- oder Instagram-Konto in GHL.
Trigger für eingehende Webhooks lässt sich nicht speichern GHL benötigt eine Beispielanfrage als Referenz für die Zuordnung. Senden Sie eine Nachricht (oder ein Beispiel-JSON) an die URL, rufen Sie sie ab, wählen Sie sie aus und speichern Sie dann.

Nächste Schritte

  • Webhooks: Richten Sie Webhooks für andere DM Champ-Ereignisse ein.
  • API-Zugriff: Nutzen Sie die API für benutzerdefinierte Integrationen über GHL hinaus.
  • Benutzerdefinierte Kanäle: Erfahren Sie mehr über Nachrichten für benutzerdefinierte Kanäle.