Brevo HITL

   https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b

  # 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 de Brevo agent account die 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 opgeven welk Brevo-agentaccount door de integratie zal worden gebruikt om berichten te verzenden en te ontvangen.
    * Navigeer naar de Brevo agents instellingenpagina: [Brevo Agents Settings](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.