GoHighLevel (GHL) Integration #

Nutzen Sie bereits GoHighLevel (GHL) zur Verwaltung Ihres Unternehmens? Diese Integration ermöglicht es Ihnen, die KI-gestützte Nachrichtenfunktion von Your AI Connector zu Ihrem bestehenden GHL-Setup hinzuzufügen. Nachrichten, die in GHL eingehen, werden zur KI-gestützten Bearbeitung an Your AI Connector weitergeleitet, und Antworten von Your AI Connector 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 Your AI Connector 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.

Voraussetzungen #

• Ein aktives Your AI Connector-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 #

Workflow 1: GHL an Your AI Connector #

Dieser Workflow leitet eingehende Nachrichten von GHL an Your AI Connector weiter.

Schritt 1: Workflow erstellen #

1. Gehen Sie in GHL zu Automatisierung > Workflows.
2. Klicken Sie auf Neuen Workflow erstellen.
3. Geben Sie ihm einen aussagekräftigen Namen, wie z. B. „Nachricht an Your AI Connector senden“.

Schritt 2: Trigger hinzufügen #

Fügen Sie für jeden Kanal, den Sie weiterleiten möchten, einen Trigger hinzu:

• Kunde hat geantwortet - SMS
• Kunde hat geantwortet - E-Mail
• Kunde hat geantwortet - Facebook-Nachricht
• Kunde hat geantwortet - Instagram DM
• Kunde hat geantwortet - Live-Chat

Sie können alle oder nur die für Ihr Setup relevanten Kanäle hinzufügen.

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

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

1. Klicken Sie beim Trigger auf Filter hinzufügen.
2. Setzen Sie die Bedingung auf „Kontakt hat Tag“.
3. Wählen Sie Ihr(e) Tag(s) aus.
4. Wählen Sie aus, ob der Kontakt irgendeines oder alle der ausgewählten Tags haben soll.

Schritt 4: Einen Kanal-Split erstellen #

Fügen Sie eine Bedingung-Aktion hinzu, um jeden Kanal an seinen eigenen Webhook weiterzuleiten:

Schritt 5: Webhooks konfigurieren #

Fügen Sie für jeden Zweig eine Webhook / HTTP-Anfrage-Aktion hinzu:

• Methode: POST

• URL:

  https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
  

• Benutzerdefinierte Datenfelder:

Kanalwerte pro Zweig:

Schritt 6: Wiedereintritt aktivieren #

Stellen Sie in den Workflow-Einstellungen sicher, dass Wiedereintritt erlauben aktiviert ist. Ohne diese Einstellung wird nur die erste Nachricht von jedem Kontakt weitergeleitet.

Workflow 2: Your AI Connector an GHL #

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

Schritt 1: Erstellen eines Inbound-Webhooks in GHL #

1. Gehen Sie in GHL zu Einstellungen > Entwickler / API.
2. Klicken Sie auf Neuen Webhook erstellen (oder “Eingehender Webhook”).
3. Nennen Sie ihn “Nachrichten.”
4. Speichern und kopieren Sie die Webhook-URL – Sie werden sie im nächsten Schritt benötigen.

Schritt 2: Your AI Connector konfigurieren #

1. Klicken Sie in Your AI Connector in der Seitenleiste auf Settings.
2. Klicken Sie unter Channels auf Channels.
3. Scrollen Sie ganz nach unten auf der Seite zur Karte Custom channel.
4. Fügen Sie die GHL-Inbound-Webhook-URL, die Sie gerade kopiert haben, in das Feld Webhook URL ein (es muss eine öffentliche HTTPS-Adresse sein) und klicken Sie auf Save.

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.

Your AI Connector 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 Custom channel, die Sie hier nutzen, befinden sich an unterschiedlichen Stellen — Settings → Integrations → API Key für den Schlüssel und die Karte Custom channel am Ende von Settings → Channels für dieses Relay. Die separate Seite Settings → Integrations → Webhooks ist für Ereignisbenachrichtigungen gedacht und sendet eine andere Payload; siehe Webhooks, falls Sie stattdessen dies benötigen.

Schritt 3: Erstellen des Antwort-Workflows #

1. Gehen Sie in GHL zu Automatisierung > Workflows.
2. Erstellen Sie einen neuen Workflow mit dem Namen “Nachricht an Kontakt senden.”
3. Setzen Sie den Auslöser auf Inbound Webhook und wählen Sie den Webhook aus, den Sie in Schritt 1 erstellt haben.

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

1. Fügen Sie eine Kontakt finden-Aktion hinzu.
2. Setzen Sie das Suchfeld auf Kontakt-ID.
3. Verwenden Sie den Wert: {{inboundWebhookRequest.toId}}

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

Wenn Sie einschränken möchten, welche Kontakte Nachrichten von Your AI Connector erhalten:

1. Fügen Sie eine Bedingungs-Aktion hinzu.
2. Prü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 falschen Zweig hinzu).

Schritt 6: Hinzufügen einer Kanal-Aufteilung #

Fügen Sie eine Bedingung-Aktion hinzu, die die Nachricht basierend auf {{inboundWebhookRequest.channel}} weiterleitet:

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 Wiedereintritt erlauben in den Workflow-Einstellungen aktiviert ist.

Testen der Integration #

Testen von GHL an Your AI Connector (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 Your AI Connector 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 Your AI Connector an GHL (Workflow 2) #

1. Senden Sie in Your AI Connector 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 #

Nächste Schritte #

• Webhooks — Richten Sie Webhooks für andere Your AI Connector-Ereignisse ein.
• API-Zugriff — Verwenden Sie die API für benutzerdefinierte Integrationen über GHL hinaus.
• Benutzerdefinierte Kanäle — Erfahren Sie mehr über Nachrichten über benutzerdefinierte Kanäle.