Intercom HITL

  # Intercom HITL-integratie

Met deze integratie kan Botpress  Intercom gebruiken als HITL (Human in the Loop) provider. Berichten van de bot verschijnen in Intercom en reacties van agenten worden teruggestuurd naar de bot.

## Functies

- Naadloze integratie tussen Botpress en Intercom

- Real-time synchronisatie van berichten
- Ondersteuning voor tekstberichten
- Automatisch beheer van conversatiesessies
- Webhook afhandeling van gebeurtenissen
- Agent toewijzing en conversatie beheer

## Configuratie

De integratie vereist de volgende configuratie:

- `accessToken`: Uw Intercom Toegangstoken (vereist voor API-authenticatie)

## Intercom App instellen voor Botpress integratie

Deze handleiding leidt je door de setup en configuratie van Intercom om integratie met je Botpress chatbot mogelijk te maken.

### Stap voor stap instructies

#### 1. Maak een Intercom App

* Navigeer naarintercomintercom
* Meld u aan bij uw Intercom 
* Ga naar **Apps** in de hub
 voor ontwikkelaars
* Klik op **"App maken"**
* Voer de naam van uw app in (bijv.Botpress HITL Integration").
* Klik op **"App maken"**

#### 2. Kopieer Toegangstoken

* Ga in het dashboard van uw app naar **Authenticatie**
* Kopieer het **Acces Token** dat wordt getoond in de sectie Toegangstoken
* Plak dit toegangskenmerk in je Botpress Intercom integratie configuratie**

#### 3. Webhooks configureren

##### a. Conversatiegebeurtenissen Webhook

* Ga naar **Webhooks** in het dashboard van uw app
* Klik op **" Webhook toevoegen"**
* Stel de Webhook URL** in op uw Botpress Intercom integratie webhook URL**.
* **Subscribe only to these events:**
  * `conversatie.admin.toegewezen`
  * `conversatie.admin.gesloten`
  * `conversatie.admin.beantwoord`
* Klik op **" Webhook opslaan"**

### Overzicht van vereiste Botpress 

* **Toegangstoken**: Van Intercom App Authenticatie
* Webhook URL**: Verstrekt door Botpress

## Gebruik

1. Configureer de integratie met je Intercom Access Token
2. Start een gesprekssessie met de `startHitl` actie
3. Berichten van de bot verschijnen in Intercom gesprekken
4. Antwoorden van agenten in Intercom worden teruggestuurd naar de bot
5. Conversatiestatus wordt automatisch beheerd tussen Botpress en Intercom

> Als het e-mailadres van de gebruiker niet bestaat als contactpersoon in Intercom, wordt automatisch een nieuw contactpersoon aangemaakt bij het starten van een HITL-sessie. Als het e-mailadres al bestaat, wordt het bestaande contact gebruikt voor het HITL-proces.

## Ondersteuning

Neem voor ondersteuning contact op met het Botpress of raadpleeg deIntercom API documentatie]intercom.

## Problemen oplossen

### Veelvoorkomende problemen

1. Webhook ontvangt geen gebeurtenissen**: Zorg ervoor dat uw webhook URL openbaar toegankelijk is en correct is geconfigureerd.
2. **Authenticatiefouten**: Controleer of uw Access Token correct is en de vereiste machtigingen heeft
3. **Berichten synchroniseren niet**: Controleer of de conversatie correct is aangemaakt en of het contact bestaat in Intercom

### Debugmodus

Schakel debugregistratie in je Botpress in om integratieproblemen op te lossen.