Memperbesar

  # 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