# Integrasi Botpress HITL
Integrasi ini memungkinkan Anda untuk menghubungkan bot Botpress Anda dengan platform percakapan Brevo, memungkinkan pengaturan Human-in-the-Loop (HITL). Ini berarti bot Botpress Anda dapat menangani interaksi pengguna awal dan meningkatkan percakapan dengan lancar ke agen manusia di Brevo bila diperlukan.
## Bagaimana cara kerjanya
Saat pengguna berinteraksi dengan bot Botpress Anda, percakapan dapat ditransfer ke agen manusia di Brevo. Agen kemudian dapat mengambil alih percakapan dan memberikan dukungan yang dipersonalisasi. Pesan dari pengguna Botpress akan diteruskan ke agen Brevo, dan sebaliknya.
## Keterbatasan Kunci
Harap perhatikan batasan-batasan berikut saat menggunakan integrasi ini:
- Atribusi Pesan:** Pesan yang dikirim oleh pengguna Botpress ke agen Brevo akan muncul seolah-olah dikirim oleh akun agen Brevo yang dikonfigurasi dengan integrasi. Namun, untuk membedakan pesan-pesan ini, pesan-pesan tersebut akan ditambahkan denganBotpress PenggunaBotpress :". Sebagai contoh: Botpress Botpress: Halo, saya butuh bantuan dengan pesanan saya.`
- Pembaruan Status:** Pengguna Botpress tidak akan secara otomatis menerima pemberitahuan atau pembaruan status mengenai penugasan agen (misalnya, "Agen John telah bergabung dalam obrolan").
## Panduan Penyiapan
Untuk mengonfigurasi integrasi Botpress HITL, Anda memerlukan yang berikut ini:
1. **Kunci API Brevo:**
- Anda dapat membuat dan mengelola kunci API Brevo Anda dengan mengikuti petunjuk pada halaman bantuan resmi mereka: [Buat dan kelola kunci API Anda] (https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2. **Nonaktifkan Pemblokiran IP:**
- Untuk komunikasi yang lancar antara Botpress dan Brevo, Anda perlu menonaktifkan pemblokiran IP di akun Brevo Anda.
- Buka [Otorisasi IP Brevo](https://app.brevo.com/security/authorised_ips) dan pastikan bahwa pemblokiran IP dinonaktifkan untuk mengizinkan permintaan dari lingkungan Botpress Anda.
3. **ID Agen Brevo:**
- Anda perlu menentukan akun agen Brevo mana yang akan digunakan oleh integrasi untuk mengirim dan menerima pesan.
- Arahkan ke halaman pengaturan agen Brevo: [Pengaturan Agen Brevo](https://conversations-app.brevo.com/settings/agents)
- Identifikasi agen yang ingin Anda gunakan untuk integrasi dan salin ID Agen mereka.
## Pengaturan Webhook (Wajib)
Untuk menerima event dari Brevo di integrasi Botpress Anda, Anda harus menyiapkan webhook di Brevo:
1. Buka **Integrasi > Webhooks** di dasbor Brevo Anda ([tautan langsung] (https://conversations-app.brevo.com/settings/integrations/webhooks)).
2. Klik **Tambahkan webhook(atau edit webhook yang sudah ada).
3. Di bidang **URL**, masukkan titik akhir webhook integrasi Botpress Brevo Anda. Contoh:
```
https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
```
4. Di bawah **Jenis peristiwa**, pilih:
- `percakapanDimulai`
- `percakapanTranskrip`
- `fragmenPercakapan`
5. Klik **Simpan** untuk mengaktifkan webhook.
> **Catatan:** Pastikan URL sesuai dengan titik akhir integrasi Botpress Anda dan semua jenis peristiwa yang diperlukan dicentang untuk fungsionalitas penuh.
Setelah ini diatur, integrasi Botpress Anda akan menerima peristiwa waktu nyata dari Brevo dan dapat memprosesnya dengan tepat.
Setelah Anda memiliki detail ini, Anda dapat melanjutkan dengan mengonfigurasi integrasi dalam lingkungan Botpress Anda sesuai dengan instruksi penyiapan khusus integrasi.
