# Botpress HITL Integration
Ta integracja umożliwia połączenie bota Botpress z platformą konwersacji Brevo, umożliwiając konfigurację Human-in-the-Loop (HITL). Oznacza to, że bot Botpress może obsługiwać początkowe interakcje użytkownika i w razie potrzeby płynnie eskalować rozmowy do ludzkich agentów w Brevo.
## Jak to działa
Gdy użytkownik wchodzi w interakcję z botem Botpress , rozmowa może zostać przeniesiona do ludzkiego agenta w Brevo. Agent może następnie przejąć rozmowę i zapewnić spersonalizowane wsparcie. Wiadomości od użytkownika Botpress będą przekazywane do agenta Brevo i odwrotnie.
## Kluczowe ograniczenia
Podczas korzystania z tej integracji należy pamiętać o następujących ograniczeniach:
- **Przypisanie wiadomości:** Wiadomości wysyłane przez użytkownika Botpress do agenta Brevo będą wyglądały tak, jakby były wysyłane przez konto agenta Brevo, które jest skonfigurowane z integracją. Jednakże, aby odróżnić te wiadomości, będą one poprzedzoneBotpress User:". Na przykład: Botpress Użytkownik Botpress: Witam, potrzebuję pomocy z moim zamówieniem".
- Aktualizacje statusu:** Użytkownik Botpress nie będzie automatycznie otrzymywać powiadomień ani aktualizacji statusu dotyczących przypisania agenta (np. "Agent John dołączył do czatu").
## Przewodnik konfiguracji
Aby skonfigurować integrację Botpress HITL, potrzebne będą następujące elementy:
1. **Klucz API Brevo:**
- Możesz utworzyć klucze API Brevo i zarządzać nimi, postępując zgodnie z instrukcjami na ich oficjalnej stronie pomocy: [Create and manage your API keys](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys).
2. **Dezaktywacja blokowania IP:**
- Aby zapewnić płynną komunikację między Botpress i Brevo, konieczne jest wyłączenie blokowania adresów IP na koncie Brevo.
- Przejdź do [Brevo IP Authorisation](https://app.brevo.com/security/authorised_ips) i upewnij się, że blokowanie IP jest wyłączone, aby umożliwić żądania ze środowiska Botpress .
3. **Identyfikator agenta Brevo:**.
- Należy określić, które konto agenta Brevo będzie używane przez integrację do wysyłania i odbierania wiadomości.
- Przejdź do strony ustawień agentów Brevo: [Ustawienia agentów Brevo](https://conversations-app.brevo.com/settings/agents).
- Zidentyfikuj agenta, którego chcesz użyć do integracji i skopiuj jego identyfikator agenta.
## Konfiguracja Webhook (wymagane)
Aby otrzymywać zdarzenia z Brevo w integracji Botpress , musisz skonfigurować webhook w Brevo:
1. Przejdź do **Integrations > Webhooks** na pulpicie nawigacyjnym Brevo ([bezpośredni link](https://conversations-app.brevo.com/settings/integrations/webhooks)).
2. Kliknij **Dodaj nowy webhook(lub edytuj istniejący).
3. W polu **URL** wprowadź punkt końcowy webhook integracji Botpress Brevo. Przykład:
```
https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
```
4. W sekcji **Typ zdarzenia** wybierz:
- `conversationStarted`
- `conversationTranscript`
- `conversationFragment`
5. Kliknij **Zapisz**, aby aktywować webhook.
> Uwaga:** Upewnij się, że adres URL odpowiada punktowi końcowemu integracji Botpress i że wszystkie wymagane typy zdarzeń są sprawdzane pod kątem pełnej funkcjonalności.
Po skonfigurowaniu, integracja Botpress będzie otrzymywać zdarzenia w czasie rzeczywistym z Brevo i będzie mogła je odpowiednio przetwarzać.
Po uzyskaniu tych szczegółów można przystąpić do konfigurowania integracji w środowisku Botpress zgodnie z instrukcjami konfiguracji integracji.
