Brevo HITL

  # Intégration Botpress HITL

Cette intégration vous permet de connecter votre bot Botpress avec la plateforme de conversations Brevo, permettant une configuration Human-in-the-Loop (HITL). Cela signifie que votre bot Botpress peut gérer les interactions initiales avec les utilisateurs et escalader les conversations vers des agents humains de Brevo si nécessaire.

## Comment ça marche

Lorsqu'un utilisateur interagit avec votre bot Botpress , la conversation peut être transférée à un agent humain dans Brevo. L'agent peut alors reprendre la conversation et fournir un support personnalisé. Les messages de l'utilisateur de Botpress seront relayés à l'agent Brevo, et vice-versa.

## Limites principales

Veuillez tenir compte des limitations suivantes lors de l'utilisation de cette intégration :

- Attribution des messages:** Les messages envoyés par l'utilisateur de Botpress à l'agent Brevo apparaîtront comme étant envoyés par le compte de l'agent Brevo qui est configuré avec l'intégration. Cependant, pour distinguer ces messages, ils seront précédés deBotpress User :". Par exemple : Botpress Utilisateur Botpress : Bonjour, j'ai besoin d'aide avec ma commande".
- **Mises à jour du statut:** L'utilisateur Botpress ne recevra pas automatiquement de notifications ou de mises à jour du statut concernant l'affectation d'un agent (par exemple, "L'agent John a rejoint le chat").

## Guide d'installation

Pour configurer l'intégration Botpress HITL, vous aurez besoin des éléments suivants :

1.  **Clé API Brevo:**
    - Vous pouvez créer et gérer vos clés API Brevo en suivant les instructions sur leur page d'aide officielle : [Créer et gérer vos clés API] (https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2.  **Désactiver le blocage d'IP:**
    - Pour une communication transparente entre Botpress et Brevo, il est nécessaire de désactiver le blocage d'IP dans votre compte Brevo.
    - Naviguez vers [Brevo IP Authorisation](https://app.brevo.com/security/authorised_ips) et assurez-vous que le blocage d'IP est désactivé pour permettre les requêtes depuis votre environnement Botpress .
3.  **Identification de l'agent Brevo:**
    - Vous devez spécifier quel compte d'agent Brevo sera utilisé par l'intégration pour envoyer et recevoir des messages.
    - Naviguez vers la page des paramètres des agents Brevo : [Brevo Agents Settings] (https://conversations-app.brevo.com/settings/agents)
    - Identifiez l'agent que vous souhaitez utiliser pour l'intégration et copiez son ID d'agent.

## Webhook Setup (Required) (Configuration du Webhook (obligatoire))

Pour recevoir des événements de Brevo dans votre intégration Botpress , vous devez configurer un webhook dans Brevo :

1. Allez dans **Integrations > Webhooks** dans votre tableau de bord Brevo ([lien direct](https://conversations-app.brevo.com/settings/integrations/webhooks)).
2. Cliquez sur **Add new webhook(ou modifiez un webhook existant).
3. Dans le champ **URL**, entrez le point de terminaison de votre webhook intégration de Botpress Brevo. Exemple :
   ```
   https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
   ```
4. Sous **Event types**, sélectionnez :
   - `conversationStarted`
   - `conversationTranscript`
   - `conversationFragment`
5. Cliquez sur **Save** pour activer le webhook.

**Note:** Assurez-vous que l'URL correspond au point de terminaison de votre intégration Botpress et que tous les types d'événements requis sont vérifiés pour une fonctionnalité complète.

Une fois que ceci est configuré, votre intégration Botpress recevra des événements en temps réel de Brevo et pourra les traiter en conséquence.

Une fois que vous avez ces détails, vous pouvez procéder à la configuration de l'intégration dans votre environnement Botpress selon les instructions de configuration spécifiques de l'intégration.