# Penyepaduan Transkrip Zum Terima dan automatik masuk transkrip mesyuarat Zum dengan mudah Botpress untuk mesyuarat yang dihoskan oleh pengguna Zoom tertentu. ## Cara Ia Berfungsi 1. **Mesyuarat zum tamat** → Zum menghantar a webhook apabila transkrip sudah siap. 2. **Penapis integrasi `host_id`** → Hanya membenarkan acara daripada pengguna Zum yang ditentukan. 3. **Transkrip diambil dan dibersihkan** → Dimuat turun daripada Zum dan ditukar kepada teks biasa. 4. **Acara yang dipancarkan** → Acara `transcriptReceived` dengan `meetingUUID` dan `transcript` tersedia untuk aliran anda. --- ## Penggunaan - **Pencetuskan aliran kerja** → Tambah kad "Listen to Event" untuk `transcriptReceived`. - **Akses data** → Gunakan `event.payload.meetingUUID` dan `event.payload.transcript` dalam aliran. - **Simpan transkrip** → Simpan ke jadual untuk analisis atau pelaporan kemudian. --- ## Prasyarat Anda mestilah: - Seorang Zoom **pemilik akaun**, **admin**, atau mempunyai peranan **“Zoom untuk Pembangun”** untuk dapat mencipta Apl Zoom OAuth - Pada **pelan premium Zum** (peringkat percuma tidak menyokong rakaman awan) --- ## Persediaan Langkah demi Langkah ### 1. Lawati: Apl Zoom OAuth - [https://marketplace.zoom.us/](https://marketplace.zoom.us/) - Pergi ke **Develop > Build App** → Pilih **Server-to-Server OAuth** → Namakan apl anda - Pada halaman **App Credentials**, salin: - **ID Akaun** - **ID Pelanggan** - **Rahsia Pelanggan** Anda akan menggunakan ini dalam anda Botpress konfigurasi penyepaduan kemudian. - Dalam **Maklumat**, isikan maklumat yang diperlukan tentang diri anda dan apl. - Dalam **Ciri**, salin **Token Rahsia** - Dalam **Skop**, tambahkan: cloud_recording:read:list_user_recordings:admin cloud_recording:read:list_recording_files:admin cloud_recording:read:hosting:admin - Aktifkan apl di bawah tab **Activation** dari ` Zoom _ Anda boleh mencari Zum _ web anda secara terus portal. #### Langkah: 1. Log masuk ke akaun Zoom anda dan navigasi ke: **Panel Pentadbir Zum > Pengurusan Pengguna > Pengguna** 2. Klik pada nama pengguna yang anda ingin dapatkan `host_id`. 3. Lihat URL dalam bar alamat penyemak imbas anda. Ia akan berada dalam format ini: https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile yang anda ingin salin xxxxxxxxxxxxx kerana itu adalah host_id anda --- ### 3. Konfigurasikan Botpress Penyepaduan - Pasang penyepaduan ini ke dalam Bot anda - Tampal: - `Zoom ID Klien` - `Zoom Rahsia Pelanggan` - `Zoom ID Akaun` - `Token Rahsia` - `Zum Pengguna ID Dibenarkan` → Tampalkan `host_id` anda (anda boleh memasukkan berbilang) Klik **Simpan Konfigurasi**. --- ### 4. Tetapkan Webhook dalam Zum Kembali dalam Apl OAuth Zum anda: - Pergi ke **Ciri** → Dayakan **Langganan Acara** - Nama: `Transkrip Diterima` (Boleh memilih nama lain juga) - Kaedah: ` Webhook ` - URL titik akhir: gunakan ** Botpress URL penyepaduan** - Tambah Peristiwa: - Di bawah **Rakaman**: - `Semua rakaman telah selesai` - `Fail transkrip rakaman telah selesai` - Klik **Selesai** - Klik **Sahkan** di sebelah URL titik akhir (anda seharusnya melihat Disahkan) - Klik **Simpan** --- ## Selesai! awak Botpress bot kini akan menerima transkrip untuk pengguna Zoom yang dibenarkan apabila rakaman awan selesai. Pastikan: - Anda **rakam ke awan** - Anda menggunakan **pelan Zum berbayar** - Anda telah menambah semua `host_id` yang dimaksudkan dengan betul
