# Botpress HITL Integratie
Deze integratie maakt het mogelijk om je Botpress bot te verbinden met Brevo's conversatieplatform, waardoor een Human-in-the-Loop (HITL) setup mogelijk wordt. Dit betekent dat je Botpress bot de eerste gebruikersinteracties kan afhandelen en de conversaties naadloos kan laten escaleren naar menselijke agenten in Brevo wanneer dat nodig is.
## Hoe het werkt
Wanneer een gebruiker interactie heeft met je Botpress bot, kan de conversatie worden doorgestuurd naar een menselijke agent in Brevo. De agent kan dan het gesprek overnemen en persoonlijke ondersteuning bieden. Berichten van de Botpress gebruiker worden doorgestuurd naar de Brevo agent en vice versa.
## Belangrijkste beperkingen
Houd rekening met de volgende beperkingen bij het gebruik van deze integratie:
- **Bericht attributie:** Berichten verzonden door de Botpress gebruiker naar de Brevo agent zullen eruit zien alsof ze zijn verzonden door het Brevo agent account dat is geconfigureerd met de integratie. Echter, om deze berichten te onderscheiden, worden ze voorafgegaan doorBotpress User:". Bijvoorbeeld: Botpress Gebruiker: Hallo, ik heb hulp nodig met mijn bestelling.`
- **Statusupdates:** De Botpress ontvangt niet automatisch meldingen of statusupdates over de toewijzing van agenten (bijvoorbeeld: "Agent John heeft zich bij de chat gevoegd").
## Setup Handleiding
Om de Botpress HITL integratie te configureren, heb je het volgende nodig:
1. **Brevo API Sleutel:**
- Je kunt je Brevo API-sleutels aanmaken en beheren door de instructies op hun officiële helppagina te volgen: [Maak en beheer je API-sleutels](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2. **IP-blokkering uitschakelen:**
- Voor naadloze communicatie tussen Botpress en Brevo is het noodzakelijk om IP-blokkering uit te schakelen in je Brevo account.
- Navigeer naar [Brevo IP-autorisatie](https://app.brevo.com/security/authorised_ips) en zorg ervoor dat IP-blokkering is uitgeschakeld om aanvragen vanuit je Botpress toe te staan.
3. **Brevo Agent ID:**
- Je moet aangeven welk Brevo agent account door de integratie wordt gebruikt om berichten te verzenden en te ontvangen.
- Navigeer naar de Brevo agents instellingen pagina: [Instellingen Brevo-agenten] (https://conversations-app.brevo.com/settings/agents)
- Identificeer de agent die je wilt gebruiken voor de integratie en kopieer zijn Agent ID.
## Webhook instellen (vereist)
Om gebeurtenissen van Brevo te ontvangen in je Botpress , moet je een webhook instellen in Brevo:
1. Ga naar **Integraties > Webhooks** in je Brevo dashboard ([directe link](https://conversations-app.brevo.com/settings/integrations/webhooks)).
2. Klik op **Nieuwe webhook(of bewerk een bestaande).
3. Voer in het **URL** veld je Botpress Brevo integratie webhook eindpunt in. Voorbeeld:
```
https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
```
4. Selecteer onder **gebeurtenistypes**:
- `conversationStarted`
- `conversatieVerslag`
- `conversatieFragment`.
5. Klik op **Opslaan** om de webhook te activeren.
> Zorg ervoor dat de URL overeenkomt met het eindpunt van je Botpress en dat alle vereiste gebeurtenistypen zijn aangevinkt voor volledige functionaliteit.
Zodra dit is ingesteld, ontvangt je Botpress real-time gebeurtenissen van Brevo en kan deze dienovereenkomstig verwerken.
Zodra je deze gegevens hebt, kun je verder gaan met het configureren van de integratie in je Botpress volgens de specifieke installatie-instructies van de integratie.
