Brevo HITL

  # Botpress HITL Integration

Diese Integration ermöglicht es Ihnen, Ihren Botpress mit der Konversationsplattform von Brevo zu verbinden und so ein Human-in-the-Loop (HITL) Setup zu ermöglichen. Das bedeutet, dass Ihr Botpress die ersten Benutzerinteraktionen abwickeln und die Gespräche bei Bedarf nahtlos an menschliche Agenten in Brevo weiterleiten kann.

## So funktioniert's

Wenn ein Benutzer mit Ihrem Botpress interagiert, kann das Gespräch an einen menschlichen Agenten in Brevo weitergeleitet werden. Der Agent kann dann die Konversation übernehmen und personalisierten Support leisten. Die Nachrichten des Botpress werden an den Brevo-Agenten weitergeleitet und umgekehrt.

## Wichtige Beschränkungen

Bitte beachten Sie die folgenden Einschränkungen bei der Nutzung dieser Integration:

- **Nachrichtenzuordnung:** Nachrichten, die vom Botpress an den Brevo-Agenten gesendet werden, sehen so aus, als würden sie von dem Brevo-Agenten-Konto gesendet, das mit der Integration konfiguriert ist. Um diese Nachrichten jedoch zu unterscheiden, wird ihnen der ZusatzBotpress User:" vorangestellt. Zum Beispiel: Botpress Botpress User: Hallo, ich brauche Hilfe bei meiner Bestellung".
- **Statusaktualisierungen:** Der Botpress erhält nicht automatisch Benachrichtigungen oder Statusaktualisierungen über die Zuweisung von Agenten (z. B. "Agent John ist dem Chat beigetreten").

## Anleitung zur Einrichtung

Um die Botpress zu konfigurieren, benötigen Sie die folgenden Voraussetzungen:

1.  **Brevo-API-Schlüssel:**
    - Sie können Ihre Brevo-API-Schlüssel erstellen und verwalten, indem Sie den Anweisungen auf der offiziellen Hilfeseite von Brevo folgen: [Erstellen und Verwalten Ihrer API-Schlüssel](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2.  **Deaktivieren Sie die IP-Sperre:**
    - Für eine reibungslose Kommunikation zwischen Botpress und Brevo ist es notwendig, die IP-Blockierung in Ihrem Brevo-Konto zu deaktivieren.
    - Navigieren Sie zu [Brevo IP-Autorisierung](https://app.brevo.com/security/authorised_ips) und stellen Sie sicher, dass die IP-Sperre deaktiviert ist, um Anfragen aus Ihrer Botpress zuzulassen.
3.  **Brevo-Agent ID:**
    - Sie müssen angeben, welches Brevo-Agentenkonto von der Integration zum Senden und Empfangen von Nachrichten verwendet werden soll.
    - Navigieren Sie zur Seite mit den Einstellungen für Brevo-Agenten: [Brevo-Agenten-Einstellungen](https://conversations-app.brevo.com/settings/agents)
    - Identifizieren Sie den Agenten, den Sie für die Integration verwenden möchten, und kopieren Sie seine Agenten-ID.

## Webhook Setup (Erforderlich)

Um Ereignisse von Brevo in Ihrer Botpress zu empfangen, müssen Sie einen webhook in Brevo einrichten:

1. Gehen Sie zu **Integrationen > Webhooks** in Ihrem Brevo-Dashboard ([Direktlink](https://conversations-app.brevo.com/settings/integrations/webhooks)).
2. Klicken Sie auf **Neuen webhook(oder bearbeiten Sie einen bestehenden).
3. Geben Sie in das Feld **URL** den webhook Ihrer Botpress Brevo-Integration ein. Beispiel:
   ```
   https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
   ```
4. Wählen Sie unter **Ereignistypen**:
   - `KonversationStarted`
   - GesprächsTranskript
   - Gesprächsfragment".
5. Klicken Sie auf **Speichern**, um den webhook zu aktivieren.

**Hinweis:** Vergewissern Sie sich, dass die URL mit dem Endpunkt Ihrer Botpress übereinstimmt und dass alle erforderlichen Ereignistypen für die volle Funktionalität überprüft werden.

Sobald dies eingerichtet ist, empfängt Ihre Botpress Echtzeit-Ereignisse von Brevo und kann sie entsprechend verarbeiten.

Sobald Sie diese Details haben, können Sie mit der Konfiguration der Integration in Ihrer Botpress gemäß den spezifischen Einrichtungsanweisungen der Integration fortfahren.