Integrasi HITL Intercom

# Integrasi HITL Intercom

Integrasi ini memungkinkan Botpress untuk menggunakan Intercom sebagai penyedia HITL (Human in the Loop). Pesan dari bot akan muncul di Intercom, dan tanggapan agen akan dikirim kembali ke bot.

Fitur

Integrasi yang mulus antara Botpress dan Intercom
Sinkronisasi pesan waktu nyata
Dukungan untuk pesan teks
Manajemen sesi percakapan otomatis
Penanganan acara Webhook
Penugasan agen dan manajemen percakapan

Konfigurasi

Integrasi memerlukan konfigurasi berikut ini:

accessToken: Token Akses Intercom Anda (diperlukan untuk autentikasi API)

Pengaturan Aplikasi Intercom untuk Integrasi Botpress

Panduan ini memandu Anda melalui penyiapan dan konfigurasi Intercom untuk mengaktifkan integrasi dengan chatbot Botpress Anda.

Petunjuk Langkah-demi-Langkah

1. Buat Aplikasi Intercom

Bukaintercomintercom
Masuk ke akun Intercom Anda
Buka Aplikasi di hub pengembang
Klik "Buat Aplikasi ".
Masukkan nama aplikasi Anda (misalnya,Botpress IntegrasiBotpress HITL")
Klik "Buat Aplikasi "

2. Salin Token Akses

Di dasbor aplikasi Anda, buka Autentikasi
Salin Token Akses yang ditampilkan di bagian Token akses
Dalam **konfigurasi integrasi Botpress Intercom Anda, tempelkan Token Akses ini

3. Mengonfigurasi Webhooks

a. Acara Percakapan Webhook

Buka Webhooks di dasbor aplikasi Anda
Klik "Tambahkan Webhook".
Atur Webhook URL** ke webhook URL integrasi Botpress Intercom Anda**
Subscribe hanya ke acara-acara ini:
percakapan.admin.ditugaskan
percakapan.admin.ditutup
percakapan.admin.dijawab
Klik "Simpan Webhook".

Ringkasan Konfigurasi Botpress yang Diperlukan

Token Akses: Dari Otentikasi Aplikasi Intercom
** URL Webhook : Disediakan oleh Botpress

Penggunaan

Konfigurasikan integrasi dengan Token Akses Intercom Anda
Memulai sesi percakapan menggunakan tindakan startHitl
Pesan dari bot akan muncul dalam percakapan Intercom
Tanggapan agen di Intercom akan dikirim kembali ke bot
Status percakapan secara otomatis dikelola antara Botpress dan Intercom

Catatan: Saat memulai sesi HITL, jika email pengguna tidak ada sebagai kontak di Intercom, kontak baru akan dibuat secara otomatis. Jika email sudah ada, kontak yang sudah ada akan digunakan untuk proses HITL.

Dukungan

Untuk dukungan, silakan hubungi tim Botpress atau lihatIntercom Dokumentasi APIIntercom ]intercom.

Pemecahan masalah

Masalah Umum

Webhook tidak menerima peristiwa**: Pastikan URL webhook Anda dapat diakses publik dan dikonfigurasi dengan benar
Kesalahan autentikasi: Verifikasi Token Akses Anda sudah benar dan memiliki izin yang diperlukan
Pesan tidak tersinkronisasi: Periksa apakah percakapan dibuat dengan benar dan kontak ada di Intercom

Mode Debug ### Mode Debug

Aktifkan pencatatan debug di konfigurasi Botpress Anda untuk memecahkan masalah integrasi.

# Integrasi HITL Intercom Integrasi ini memungkinkan Botpress untuk menggunakan Intercom sebagai penyedia HITL (Human in the Loop). Pesan dari bot akan muncul di Intercom, dan tanggapan agen akan dikirim kembali ke bot. ## Fitur - Integrasi yang mulus antara Botpress dan Intercom - Sinkronisasi pesan waktu nyata - Dukungan untuk pesan teks - Manajemen sesi percakapan otomatis - Penanganan acara Webhook - Penugasan agen dan manajemen percakapan ## Konfigurasi Integrasi memerlukan konfigurasi berikut ini: - `accessToken`: Token Akses Intercom Anda (diperlukan untuk autentikasi API) ## Pengaturan Aplikasi Intercom untuk Integrasi Botpress Panduan ini memandu Anda melalui penyiapan dan konfigurasi Intercom untuk mengaktifkan integrasi dengan chatbot Botpress Anda. ### Petunjuk Langkah-demi-Langkah #### 1. Buat Aplikasi Intercom * Bukaintercomintercom * Masuk ke akun Intercom Anda * Buka **Aplikasi** di hub pengembang * Klik **"Buat Aplikasi "**. * Masukkan nama aplikasi Anda (misalnya,Botpress IntegrasiBotpress HITL") * Klik **"Buat Aplikasi "** #### 2. Salin Token Akses * Di dasbor aplikasi Anda, buka **Autentikasi** * Salin **Token Akses** yang ditampilkan di bagian Token akses * Dalam **konfigurasi integrasi Botpress Intercom Anda, tempelkan Token Akses ini #### 3. Mengonfigurasi Webhooks ##### a. Acara Percakapan Webhook * Buka **Webhooks** di dasbor aplikasi Anda * Klik **"Tambahkan Webhook"**. * Atur Webhook URL** ke webhook URL integrasi Botpress Intercom Anda** * **Subscribe hanya ke acara-acara ini:** * `percakapan.admin.ditugaskan` * `percakapan.admin.ditutup` * `percakapan.admin.dijawab` * Klik **"Simpan Webhook"**. ### Ringkasan Konfigurasi Botpress yang Diperlukan * **Token Akses**: Dari Otentikasi Aplikasi Intercom * ** URL Webhook : Disediakan oleh Botpress ## Penggunaan 1. Konfigurasikan integrasi dengan Token Akses Intercom Anda 2. Memulai sesi percakapan menggunakan tindakan `startHitl` 3. Pesan dari bot akan muncul dalam percakapan Intercom 4. Tanggapan agen di Intercom akan dikirim kembali ke bot 5. Status percakapan secara otomatis dikelola antara Botpress dan Intercom **Catatan:** Saat memulai sesi HITL, jika email pengguna tidak ada sebagai kontak di Intercom, kontak baru akan dibuat secara otomatis. Jika email sudah ada, kontak yang sudah ada akan digunakan untuk proses HITL. ## Dukungan Untuk dukungan, silakan hubungi tim Botpress atau lihatIntercom Dokumentasi APIIntercom ]intercom. ## Pemecahan masalah ### Masalah Umum 1. Webhook tidak menerima peristiwa**: Pastikan URL webhook Anda dapat diakses publik dan dikonfigurasi dengan benar 2. **Kesalahan autentikasi**: Verifikasi Token Akses Anda sudah benar dan memiliki izin yang diperlukan 3. **Pesan tidak tersinkronisasi**: Periksa apakah percakapan dibuat dengan benar dan kontak ada di Intercom Mode Debug ### Mode Debug Aktifkan pencatatan debug di konfigurasi Botpress Anda untuk memecahkan masalah integrasi.

Intercom HITL