Integracja Intercom HITL

# 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

Skonfiguruj integrację z tokenem dostępu Intercom
Rozpocznij sesję konwersacji za pomocą akcji startHitl.
Wiadomości od bota pojawią się w konwersacjach Intercom .
Odpowiedzi agenta w Intercom będą wysyłane z powrotem do bota
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

Webhook nie odbiera zdarzeń**: Upewnij się, że adres URL webhook jest publicznie dostępny i poprawnie skonfigurowany.
Błędy uwierzytelniania: Sprawdź, czy token dostępu jest prawidłowy i ma wymagane uprawnienia.
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ą.

# 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ą.

Intercom HITL