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