Livechat HITL

  chats.conversation--all:rw

  # Integratie van LiveChat HITL

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

## Functies

- Naadloze integratie tussen Botpress en LiveChat
- Real-time synchronisatie van berichten
- Ondersteuning voor tekstberichten
- Automatisch beheer van chatsessies
- Webhook afhandeling van gebeurtenissen

## Configuratie

De integratie vereist de volgende configuratie:

- `clientId`: Je LiveChat client ID
- `organizationId`: Uw LiveChat organisatie ID
- `webhookSecret`: Geheime sleutel voor webhook 

## LiveChat App instellen voor Botpress 

Deze handleiding leidt je door het maken en configureren van een LiveChat app via [platform.text.com](https://platform.text.com) om integratie met je Botpress chatbot mogelijk te maken.

> 📹 **Videohandleiding**: Bekijk onze stapsgewijze installatiegids op [Loom](https://www.loom.com/share/c291c86a10e3496791dd32f6c0b0c64c?sid=84100a6a-b699-4363-89f2-194458c4a8ad)

### Stap-voor-stap instructies

#### 1. Maak een nieuwe app

* Navigeer naar [https://platform.text.com/console/apps](https://platform.text.com/console/apps)
* Klik op **"App maken"**.
* Voer uw app-naam in
* Zorg ervoor dat **Livechat** is geselecteerd als het product
* Klik op **"App maken"**

#### 2. Voeg het App Autorisatieblok toe

* Ga naar **Blocks**
* Klik op **"Bouwblok toevoegen"**
* Kies **App Autorisatie → Server-kant App**
* Kopieer de **Client ID**
* Plak deze Client ID in uw Botpress LiveChat integratie configuratie**
* Voeg de volgende scope toe:

  ```
  chats.conversation--all:rw
  ```
* **Belangrijk:** Voeg uw Botpress webhook URL** toe aan het **Redirect URIs** veld in dit blok

#### 3. Uw organisatie-ID toevoegen

* Ga naar [https://platform.text.com/console/settings/account](https://platform.text.com/console/settings/account)
* Kopieer uw **Organisatie-ID**
* Plak deze in uw Botpress LiveChat integratie configuratie**

#### 4. Webhooks configureren

##### a. Inkomende gebeurtenis Webhook

* Voeg in de **Blokken** sectie een Chat Webhooks** blok toe
* Stel de Webhook URL** in op de Botpress LiveChat integratie webhook URL**.
* **Genereer een geheime sleutel** en gebruik dezelfde sleutel in je Botpress configuratie
* Stel het volgende in:

  * **Type**: `licentie`
  * **Trigger**: `incoming_event`
  * **Filter**: `author_type = agent`
* Klik op **Opslaan**

##### b. Chat gedeactiveerd Webhook

* Voeg nog een Chat Webhooks** blok toe
* Gebruik dezelfde webhook URL** en **geheime sleutel**
* Instellen:

  * **Trigger**: `chat_deactivated`
  * **Type**: `licentie`
* Klik op **Opslaan**

##### c. Chat overgedragen Webhook

* Voeg nog een Chat Webhooks** blok toe
* Gebruik dezelfde webhook URL** en **geheime sleutel**
* Instellen:

  * **trigger**: `chat_overgedragen`
  * **Type**: `licentie`
* Klik op **Opslaan**

#### 5. App Setup voltooien

##### a. Een pictogram toevoegen

* Ga naar de sectie **Listing Details**
* Upload een **willekeurig pictogram** voor uw app (elke afbeelding werkt)

##### b. Installeer de app

* Ga naar het tabblad **Privéinstallatie**
* Klik op **"App installeren"**

### Overzicht van vereiste Botpress 

* **Client ID**: Van App Autorisatie blok
* **Organisatie ID**: Van Account Instellingen
* **Secret Key**: Van webhook setup
* Webhook URL**: Aangeleverd door Botpress

* **Scopes**: `chats.conversation--all:rw`
* **Redirect URI**: Moet uw Botpress webhook URL opnemen in het App Auth-blok

## Gebruik

1. Configureer de integratie met je LiveChat referenties
2. Start een chatsessie met behulp van de `startHitl` actie
3. Berichten van de bot verschijnen in LiveChat
4. Antwoorden van de agent in LiveChat worden teruggestuurd naar de bot

## Gebeurtenissen

De integratie verwerkt de volgende LiveChat-gebeurtenissen:

- `incoming_event`: Nieuwe berichten van agents
- `chat_deactivated`: Chat beëindigd
- `chat_overgedragen`: Chat overgedragen aan een andere agent

## Beveiliging

- Webhook met behulp van een geheime sleutel
- OAuth2-authenticatie voor API-oproepen
- Veilig tokenbeheer

## Ondersteuning

Neem voor ondersteuning contact op met het Botpress of raadpleeg de [LiveChat API documentatie](https://developers.livechat.com/docs/).