# Intercom HITL Integration Ta integracja umożliwia Botpress korzystanie z Intercom jako dostawcy HITL (Human in the Loop). Wiadomości od bota będą pojawiać się w Intercom, a odpowiedzi agenta będą wysyłane z powrotem do bota. ## Funkcje - Płynna integracja między Botpress i Intercom - Synchronizacja wiadomości w czasie rzeczywistym - Obsługa wiadomości tekstowych - Automatyczne zarządzanie sesjami konwersacji - Obsługa zdarzeń Webhook - Przypisywanie agentów i zarządzanie konwersacjami ## Konfiguracja Integracja wymaga następującej konfiguracji: - `accessToken`: Twój token dostępu Intercom (wymagany do uwierzytelniania API) ## Konfiguracja aplikacji Intercom dla integracji Botpress Ten przewodnik przeprowadzi Cię przez konfigurację Intercom , aby umożliwić integrację z chatbotem Botpress . ### Instrukcje krok po kroku #### 1. Utwórz aplikację Intercom * Przejdź dointercomintercom * Zaloguj się na swoje konto Intercom * Przejdź do **Apps** w hub deweloperskim * Kliknij **"Create App "**. * Wpisz nazwę aplikacji (np.Botpress HITL Integration") * Kliknij **"Create App "**. #### 2. Skopiuj token dostępu * W panelu aplikacji przejdź do **Uwierzytelnianie**. * Skopiuj **Token dostępu** pokazany w sekcji Token dostępu. * W **Konfiguracji integracji Botpress Intercom wklej ten token dostępu. #### 3. Skonfiguruj Webhooks ##### a. Webhook zdarzeń konwersacji Webhook * Przejdź do **Webhooks** w panelu aplikacji * Kliknij **"Add Webhook"**. * Ustaw adres Webhook URL** na adres Botpress Intercom integration webhook URL**. ** Subskrybuj tylko te zdarzenia:** * `conversation.admin.assigned` * `conversation.admin.closed` * `conversation.admin.replied` * Kliknij **"Save Webhook"**. ### Podsumowanie wymaganej konfiguracji Botpress ** Token dostępu**: Z uwierzytelniania aplikacji Intercom Webhook URL**: Dostarczony przez Botpress ## Użycie 1. Skonfiguruj integrację z tokenem dostępu Intercom 2. Rozpocznij sesję konwersacji za pomocą akcji `startHitl`. 3. Wiadomości od bota pojawią się w konwersacjach Intercom . 4. Odpowiedzi agenta w Intercom będą wysyłane z powrotem do bota 5. Stan konwersacji jest automatycznie zarządzany pomiędzy Botpress i Intercom . Intercom > Uwaga:** Podczas rozpoczynania sesji HITL, jeśli adres e-mail użytkownika nie istnieje jako kontakt w Intercom, nowy kontakt zostanie utworzony automatycznie. Jeśli adres e-mail już istnieje, istniejący kontakt zostanie użyty w procesie HITL. ## Wsparcie Aby uzyskać pomoc, skontaktuj się z zespołem Botpress lub zapoznaj się zIntercom dokumentacjąIntercom API]intercom. ## Rozwiązywanie problemów ### Typowe problemy 1. Webhook nie odbiera zdarzeń**: Upewnij się, że adres URL webhook jest publicznie dostępny i poprawnie skonfigurowany. 2. **Błędy uwierzytelniania**: Sprawdź, czy token dostępu jest prawidłowy i ma wymagane uprawnienia. 3. **Brak synchronizacji wiadomości**: Sprawdź, czy konwersacja została poprawnie utworzona, a kontakt istnieje w Intercom . Intercom ### Tryb debugowania Włącz rejestrowanie debugowania w konfiguracji Botpress , aby rozwiązywać problemy z integracją.
