Intercom HITL

  # Intercom HITL Integration

Diese Integration ermöglicht es Botpress , Intercom als HITL (Human in the Loop)-Anbieter zu nutzen. Nachrichten vom Bot werden in Intercom angezeigt, und die Antworten der Agenten werden an den Bot zurückgesendet.

## Funktionen

- Nahtlose Integration zwischen Botpress und Intercom

- Synchronisierung von Nachrichten in Echtzeit
- Unterstützung für Textnachrichten
- Automatische Verwaltung von Gesprächssitzungen
- Webhook Ereignisbehandlung
- Agentenzuweisung und Gesprächsverwaltung

## Konfiguration

Die Integration erfordert die folgende Konfiguration:

- `accessToken`: Ihr Intercom Access Token (erforderlich für die API-Authentifizierung)

## Intercom für die Botpress 

Diese Anleitung führt Sie durch die Einrichtung und Konfiguration von Intercom , um die Integration mit Ihrem Botpress zu ermöglichen.

### Schritt-für-Schritt-Anleitung

#### 1. Erstellen Sie eine Intercom 

* Navigieren Sie zuintercomintercom
* Melden Sie sich bei Ihrem Intercom an.
* Gehen Sie im hub
 auf **Apps**.
* Klicken Sie auf **"App erstellen "**.
* Geben Sie den Namen Ihrer App ein (z.B.Botpress HITL Integration")
* Klicken Sie auf **"App erstellen "**.

#### 2. Kopieren Sie das Zugriffstoken

* Gehen Sie im Dashboard Ihrer App zu **Authentifizierung**.
* Kopieren Sie das **Zugangs-Token**, das im Abschnitt Zugangs-Token angezeigt wird.
* Fügen Sie in Ihrer Botpress Intercom dieses Zugriffstoken ein.

#### 3. Konfigurieren Sie Webhooks

##### a. Gesprächsereignisse Webhook

* Gehen Sie zu **Webhooks** in Ihrem App-Dashboard.
* Klicken Sie auf Webhook hinzufügen "**.
* Setzen Sie die Webhook auf Ihre Botpress  webhook .
**Abonnieren Sie nur diese Ereignisse:**
  * `conversation.admin.assigned`
  * `Konversation.admin.geschlossen`
  * `conversation.admin.replied`
* Klicken Sie auf **" Webhook speichern "**

### Zusammenfassung der erforderlichen Botpress 

* **Zugangs-Token**: Von Intercom App-Authentifizierung
* Webhook URL**: Wird von Botpress
bereitgestellt Botpress

## Verwendung

1. Konfigurieren Sie die Integration mit Ihrem Intercom Access Token
2. Starten Sie eine Gesprächssitzung mit der Aktion `startHitl`.
3. Nachrichten des Bots werden in Intercom angezeigt
4. Die Antworten der Agenten in Intercom werden an den Bot zurückgeschickt
5. Der Konversationsstatus wird automatisch zwischen Botpress und Intercom
verwaltet. Intercom

**Hinweis:** Wenn beim Start einer HITL-Sitzung die E-Mail des Benutzers nicht als Kontakt in Intercom vorhanden ist, wird automatisch ein neuer Kontakt erstellt. Wenn die E-Mail bereits vorhanden ist, wird der bestehende Kontakt für den HITL-Prozess verwendet.

## Unterstützung

Wenn Sie Unterstützung benötigen, wenden Sie sich bitte an das Botpress oder lesen Sie dieIntercom API-Dokumentation]intercom.

## Fehlersuche

### Allgemeine Probleme

1. Webhook empfängt keine Ereignisse**: Stellen Sie sicher, dass Ihre webhook öffentlich zugänglich und richtig konfiguriert ist.
2. **Authentifizierungsfehler**: Vergewissern Sie sich, dass Ihr Access Token korrekt ist und über die erforderlichen Berechtigungen verfügt.
3. **Nachrichten werden nicht synchronisiert**: Überprüfen Sie, ob die Konversation korrekt erstellt wurde und der Kontakt in Intercom
existiert. Intercom

### Debug-Modus

Aktivieren Sie die Debug-Protokollierung in Ihrer Botpress , um Probleme mit der Integration zu beheben.