# GoHighLevel (GHL) Integration

Nutzen Sie bereits GoHighLevel (GHL) zur Verwaltung Ihres Unternehmens? Diese Integration ermöglicht es Ihnen, die KI-gestützte Nachrichtenfunktion von <span data-t="appName">Your AI Connector</span> zu Ihrem bestehenden GHL-Setup hinzuzufügen. Nachrichten, die in GHL eingehen, werden zur KI-gestützten Bearbeitung an <span data-t="appName">Your AI Connector</span> weitergeleitet, und Antworten von <span data-t="appName">Your AI Connector</span> 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 <span data-t="appName">Your AI Connector</span> zu funktionieren: Informationen zu benutzerdefinierten Funktionen, der API und Webhooks finden Sie unter [Verbinden eines Tools, das wir nicht auflisten](connecting-other-tools.md).

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

::: note
**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 **<span data-t="appName">Your AI Connector</span>-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 <span data-t="appName">Your AI Connector</span>** | Ein Kunde schreibt Ihnen eine Nachricht per SMS, E-Mail, Messenger, Instagram oder Live-Chat in GHL. Ein Workflow leitet diese Nachricht automatisch an <span data-t="appName">Your AI Connector</span> weiter. <span data-t="appName">Your AI Connector</span> verarbeitet sie (KI-Antwort, Tagging usw.). |
| **<span data-t="appName">Your AI Connector</span> an GHL** | Wenn <span data-t="appName">Your AI Connector</span> 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 <span data-t="appName">Your AI Connector</span>

Dieser Workflow leitet eingehende Nachrichten von GHL an <span data-t="appName">Your AI Connector</span> 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 <span data-t="appName">Your AI Connector</span> 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:

| Zweig | Bedingung |
|---|---|
| Zweig 1 | Nachrichtenquelle entspricht `Email` |
| Zweig 2 | Nachrichtenquelle entspricht `SMS` |
| Zweig 3 | Nachrichtenquelle entspricht `Messenger` |
| Zweig 4 | Nachrichtenquelle entspricht `Instagram` |
| Zweig 5 | Nachrichtenquelle entspricht `Live Chat` |

### 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:**

| 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 |
| `body` | `{{message.body}}` | Der Nachrichteninhalt |
| `channel` | Siehe Tabelle unten | Muss mit dem Zweig übereinstimmen |
| `status` | `created` | Immer auf `created` setzen |
| `messageType` | `text` | Nachrichtentyp |

**Kanalwerte pro Zweig:**

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

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


### 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:

```json
{
  "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](webhooks.md), 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:

| Zweig | Bedingung | Aktion |
|---|---|---|
| Zweig 1 | entspricht `email` | E-Mail senden |
| Zweig 2 | entspricht `sms` | SMS senden |
| Zweig 3 | entspricht `messenger` | Facebook-Nachricht senden |
| Zweig 4 | entspricht `ig` | Instagram-Nachricht senden |
| Zweig 5 | entspricht `livechat` | Chat-Nachricht senden |

### 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 <span data-t="appName">Your AI Connector</span> (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 <span data-t="appName">Your AI Connector</span> 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 <span data-t="appName">Your AI Connector</span> an GHL (Workflow 2)

1. Senden Sie in <span data-t="appName">Your AI Connector</span> 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 <span data-t="appName">Your AI Connector</span> nicht | Überprüfen Sie, ob Ihr API-Schlüssel in der Webhook-URL korrekt ist. Prüfen Sie, ob die Workflow-Trigger ausgelöst werden (GHL-Workflow-Protokolle). Bestätigen Sie, dass „Allow Re-entry“ aktiviert ist. |
| Nachrichten erreichen GHL nicht | Überprüfen Sie, ob die GHL-Inbound-Webhook-URL korrekt in das Feld **Webhook URL** auf der Karte **Custom channel** am Ende von **Settings → Channels** eingefügt wurde (nicht auf der Seite Settings → Integrations → Webhooks, da dies eine andere Funktion ist). Prüfen Sie, ob der GHL-Inbound-Webhook aktiv ist. Überprüfen Sie die GHL-Workflow-Ausführungsprotokolle. |
| Kontakt in GHL nicht gefunden | Die `toId` in den Webhook-Daten muss mit einer existierenden 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 **Allow Re-entry** in beiden Workflow-Einstellungen. |

---

## Nächste Schritte

- [Webhooks](webhooks.md) — Richten Sie Webhooks für andere <span data-t="appName">Your AI Connector</span>-Ereignisse ein.
- [API-Zugriff](api-access.md) — Verwenden Sie die API für benutzerdefinierte Integrationen über GHL hinaus.
- [Benutzerdefinierte Kanäle](../messaging-channels/custom-channels.md) — Erfahren Sie mehr über Nachrichten über benutzerdefinierte Kanäle.