Intercom HITL Entegrasyonu

# Intercom HITL Entegrasyonu

Bu entegrasyon, Botpress 'in Intercom 'u bir HITL (Döngüdeki İnsan) sağlayıcısı olarak kullanmasına olanak tanır. Bottan gelen mesajlar Intercom'da görünecek ve temsilci yanıtları bota geri gönderilecektir.

Özellikler

Botpress ve Intercom arasında sorunsuz entegrasyon
Gerçek zamanlı mesaj senkronizasyonu
Metin mesajları için destek
Otomatik konuşma oturumu yönetimi
Webhook olay işleme
Temsilci atama ve görüşme yönetimi

Konfigürasyon

Entegrasyon aşağıdaki yapılandırmayı gerektirir:

accessToken: Intercom Erişim Belirteciniz (API kimlik doğrulaması için gereklidir)

Botpress Entegrasyonu için Intercom Uygulama Kurulumu

Bu kılavuz, Botpress sohbet robotunuzla entegrasyonu etkinleştirmek için Intercom 'un kurulumu ve yapılandırması boyunca size yol gösterir.

Adım Adım Talimatlar

1. Bir Intercom Uygulaması Oluşturun

*intercomintercom adresine gidin

Intercom hesabınızda oturum açın
Geliştirici hub 'ında Uygulamalar bölümüne gidin
"Uygulama Oluştur " seçeneğine tıklayın
Uygulama adınızı girin (örneğin,Botpress HITL Entegrasyonu")
"Uygulama Oluştur " seçeneğine tıklayın

2. Erişim Belirtecini Kopyala

Uygulama kontrol panelinizde Kimlik Doğrulama bölümüne gidin
Erişim belirteci bölümünde gösterilen Erişim Belirtecini kopyalayın
Botpress Intercom entegrasyon yapılandırmanıza** bu Erişim Belirtecini yapıştırın

3. Web Kancalarını Yapılandırma

a. Conversation Events Webhook

Uygulama kontrol panelinizdeki Webhooks bölümüne gidin
" Webhook Ekle " seçeneğine tıklayın
Webhook URL'sini** Botpress Intercom entegrasyonu webhook URL'nize** ayarlayın
Sadece şu olaylara abone olun:
conversation.admin.assigned
conversation.admin.closed
conversation.admin.replied
" Webhook'u Kaydet " seçeneğine tıklayın

Gerekli Botpress Yapılandırmasının Özeti

Erişim Simgesi: Intercom Uygulama Kimlik Doğrulamasından
Webhook URL**: Botpress tarafından sağlanmıştır Botpress

Kullanım

Intercom Erişim Belirteciniz ile entegrasyonu yapılandırın
StartHitl` eylemini kullanarak bir konuşma oturumu başlatın
Bottan gelen mesajlar Intercom konuşmalarında görünecektir
Intercom 'daki temsilci yanıtları bota geri gönderilecektir
Görüşme durumu Botpress ve Intercom arasında otomatik olarak yönetilir Intercom

Not: Bir HITL oturumu başlatırken, kullanıcının e-postası Intercom'da bir kişi olarak mevcut değilse, otomatik olarak yeni bir kişi oluşturulacaktır. E-posta zaten mevcutsa, HITL işlemi için mevcut kişi kullanılacaktır.

Destek

Destek için lütfen Botpress ekibiyle iletişime geçin veyaIntercom API belgelerine]intercom bakın.

Sorun Giderme

Yaygın Sorunlar

Webhook olayları almıyor**: webhook URL'nizin herkes tarafından erişilebilir olduğundan ve düzgün yapılandırıldığından emin olun
Kimlik doğrulama hataları: Erişim Belirtecinizin doğru olduğunu ve gerekli izinlere sahip olduğunu doğrulayın
Mesajlar senkronize edilmiyor: Görüşmenin düzgün bir şekilde oluşturulduğunu ve kişinin Intercom 'da mevcut olduğunu kontrol edin Intercom

Hata Ayıklama Modu

Entegrasyon sorunlarını gidermek için Botpress yapılandırmanızda hata ayıklama günlüğünü etkinleştirin.

# Intercom HITL Entegrasyonu Bu entegrasyon, Botpress 'in Intercom 'u bir HITL (Döngüdeki İnsan) sağlayıcısı olarak kullanmasına olanak tanır. Bottan gelen mesajlar Intercom'da görünecek ve temsilci yanıtları bota geri gönderilecektir. ## Özellikler - Botpress ve Intercom arasında sorunsuz entegrasyon - Gerçek zamanlı mesaj senkronizasyonu - Metin mesajları için destek - Otomatik konuşma oturumu yönetimi - Webhook olay işleme - Temsilci atama ve görüşme yönetimi ## Konfigürasyon Entegrasyon aşağıdaki yapılandırmayı gerektirir: - `accessToken`: Intercom Erişim Belirteciniz (API kimlik doğrulaması için gereklidir) ## Botpress Entegrasyonu için Intercom Uygulama Kurulumu Bu kılavuz, Botpress sohbet robotunuzla entegrasyonu etkinleştirmek için Intercom 'un kurulumu ve yapılandırması boyunca size yol gösterir. ### Adım Adım Talimatlar #### 1. Bir Intercom Uygulaması Oluşturun *intercomintercom adresine gidin * Intercom hesabınızda oturum açın * Geliştirici hub 'ında **Uygulamalar** bölümüne gidin * **"Uygulama Oluştur "** seçeneğine tıklayın * Uygulama adınızı girin (örneğin,Botpress HITL Entegrasyonu") * **"Uygulama Oluştur "** seçeneğine tıklayın #### 2. Erişim Belirtecini Kopyala * Uygulama kontrol panelinizde **Kimlik Doğrulama** bölümüne gidin * Erişim belirteci bölümünde gösterilen **Erişim Belirtecini** kopyalayın * Botpress Intercom entegrasyon yapılandırmanıza** bu Erişim Belirtecini yapıştırın #### 3. Web Kancalarını Yapılandırma ##### a. Conversation Events Webhook * Uygulama kontrol panelinizdeki **Webhooks** bölümüne gidin * **" Webhook Ekle "** seçeneğine tıklayın * Webhook URL'sini** Botpress Intercom entegrasyonu webhook URL'nize** ayarlayın * **Sadece şu olaylara abone olun:** * `conversation.admin.assigned` * `conversation.admin.closed` * `conversation.admin.replied` * **" Webhook'u Kaydet "** seçeneğine tıklayın ### Gerekli Botpress Yapılandırmasının Özeti * **Erişim Simgesi**: Intercom Uygulama Kimlik Doğrulamasından * Webhook URL**: Botpress tarafından sağlanmıştır Botpress ## Kullanım 1. Intercom Erişim Belirteciniz ile entegrasyonu yapılandırın 2. StartHitl` eylemini kullanarak bir konuşma oturumu başlatın 3. Bottan gelen mesajlar Intercom konuşmalarında görünecektir 4. Intercom 'daki temsilci yanıtları bota geri gönderilecektir 5. Görüşme durumu Botpress ve Intercom arasında otomatik olarak yönetilir Intercom > **Not:** Bir HITL oturumu başlatırken, kullanıcının e-postası Intercom'da bir kişi olarak mevcut değilse, otomatik olarak yeni bir kişi oluşturulacaktır. E-posta zaten mevcutsa, HITL işlemi için mevcut kişi kullanılacaktır. ## Destek Destek için lütfen Botpress ekibiyle iletişime geçin veyaIntercom API belgelerine]intercom bakın. ## Sorun Giderme ### Yaygın Sorunlar 1. Webhook olayları almıyor**: webhook URL'nizin herkes tarafından erişilebilir olduğundan ve düzgün yapılandırıldığından emin olun 2. **Kimlik doğrulama hataları**: Erişim Belirtecinizin doğru olduğunu ve gerekli izinlere sahip olduğunu doğrulayın 3. **Mesajlar senkronize edilmiyor**: Görüşmenin düzgün bir şekilde oluşturulduğunu ve kişinin Intercom 'da mevcut olduğunu kontrol edin Intercom ### Hata Ayıklama Modu Entegrasyon sorunlarını gidermek için Botpress yapılandırmanızda hata ayıklama günlüğünü etkinleştirin.

Intercom HITL