# Integrasi Transkrip Zoom Terima dan otomatiskan transkrip rapat Zoom dengan mudah di Botpress untuk rapat yang diselenggarakan oleh pengguna Zoom tertentu. ## Bagaimana Cara Kerjanya 1. **Rapat Zoom berakhir** → Zoom mengirimkan webhook saat transkrip siap. 2. **Filter integrasi `host_id`** → Hanya mengizinkan acara dari pengguna Zoom tertentu. 3. **Transkrip diambil dan dibersihkan** → Diunduh dari Zoom dan dikonversi ke teks biasa. 4. **Acara dipancarkan** → Acara `transkripDiterima` dengan `meetingUUID` dan `transkrip` tersedia untuk aliran Anda. --- ## Penggunaan - **Arus kerja pemicu** → Tambahkan kartu "Dengarkan Acara" untuk `transkripDiterima`. - **Akses data** → Gunakan `event.payload.meetingUUID` dan `event.payload.transcript` dalam alur. - Simpan transkrip** → Simpan ke tabel untuk analisis atau pelaporan nanti. --- ## Prasyarat Anda harus: - Pemilik **akun Zoom**, **admin**, atau memiliki peran **"Zoom untuk Pengembang" untuk dapat membuat Aplikasi Zoom OAuth - Menggunakan **paket premium Zoom** (paket gratis tidak mendukung perekaman cloud) --- ## Penyiapan Langkah demi Langkah ### 1. Membuat Aplikasi Zoom OAuth - Kunjungi: [https://marketplace.zoom.us/](https://marketplace.zoom.us/) - Buka **Kembangkan > Bangun Aplikasi** → Pilih **OAuth Server-ke-Server** → Beri nama aplikasi Anda - Pada halaman **Kredensial Aplikasi**, salin: - **ID Akun** - ** ID Klien** - **Rahasia Klien** **Rahasia Klien Anda akan menggunakan ini dalam konfigurasi integrasi Botpress Anda nanti. - Di **Informasi**, isi informasi yang diperlukan tentang diri Anda dan aplikasi. - Di **Fitur**, salin **Token Rahasia** - Di **Cakupan**, tambahkan: cloud_recording:read:list_user_recording:admin cloud_recording:read:list_recording_files:admin cloud_recording:read:rekaman:admin - Aktifkan aplikasi di bawah tab **Aktivasi** ### 2. Dapatkan `host_id` Zoom Anda dapat menemukan `host_id` Zoom Anda langsung dari portal web Zoom. #### Langkah-langkah: 1. Masuk ke akun Zoom Anda dan buka: **Panel Admin Zoom > Manajemen Pengguna > Pengguna** 2. Klik nama pengguna yang ingin Anda dapatkan `host_id`-nya. 3. Lihatlah URL di bilah alamat peramban Anda. URL tersebut akan memiliki format seperti ini: https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile Anda ingin menyalin xxxxxxxxxxxxx karena itu adalah host_id Anda --- ### 3. Mengonfigurasi Integrasi Botpress - Pasang integrasi ini ke dalam Bot Anda - Rekatkan: - `Zoom ID Klien` - `Zoom Rahasia Klien` - `Zoom ID Akun` - `Token Rahasia` - `ID Pengguna Zoom yang Diizinkan` → Rekatkan `host_id` Anda (Anda dapat menyertakan beberapa) Klik **Simpan Konfigurasi**. --- ### 4. Mengatur Webhook di Zoom Kembali ke Aplikasi Zoom OAuth Anda: - Buka **Fitur** → Aktifkan **Langganan Acara** - Nama `Transkrip Diterima` (Dapat memilih nama lain juga) - Metode: `Kait Webhook - URL Titik Akhir: gunakan **URL integrasi Botpress - Tambahkan Acara: - Di bawah **Rekaman**: - `Semua rekaman telah selesai` - `File transkrip rekaman telah selesai` - Klik **Selesai** - Klik **Validasi** di samping URL titik akhir (Anda akan melihat Validasi) - Klik **Simpan** --- ## Selesai! Bot Botpress Anda sekarang akan menerima transkrip untuk pengguna Zoom yang diizinkan saat rekaman cloud selesai. Pastikan: - Anda **merekam ke cloud** - Anda menggunakan paket Zoom berbayar **paket Zoom berbayar** - Anda telah menambahkan semua `host_id` yang dimaksudkan dengan benar