Mag-zoom

  # Zoom Transcript Integration Madaling makatanggap at i-automate ang mga transcript ng Zoom meeting Botpress para sa mga pulong na hino-host ng mga partikular na user ng Zoom. ## Paano Ito Gumagana 1. **Nagtatapos ang Zoom meeting** → Nagpapadala ang Zoom ng a webhook kapag handa na ang transcript. 2. **Mga filter ng integration `host_id`** → Pinapayagan lamang ang mga kaganapan mula sa tinukoy na (mga) user ng Zoom. 3. **Ang transcript ay kinukuha at nilinis** → Na-download mula sa Zoom at na-convert sa plain text. 4. **Event emitted** → Isang `transcriptReceived` event na may `meetingUUID` at `transcript` ay available sa iyong mga flow. --- ## Paggamit - **Mga daloy ng trabaho sa pag-trigger** → Magdagdag ng card na "Makinig sa Kaganapan" para sa `transcriptReceived`. - **I-access ang data** → Gamitin ang `event.payload.meetingUUID` at `event.payload.transcript` sa mga daloy. - **Mag-imbak ng mga transcript** → I-save sa mga talahanayan para sa pagsusuri o pag-uulat sa ibang pagkakataon. --- ## Mga Kinakailangan Ikaw ay dapat na: - Isang Zoom **may-ari ng account**, **admin**, o may **“Mag-zoom para sa Mga Developer” na tungkulin** upang magawa ang Zoom OAuth App - Sa isang **Zoom premium plan** (hindi sinusuportahan ng libreng tier ang mga cloud recording) --- ## Step-by-Step na Setup ### 1. Bumisita ng: Zoom OAuth App [https://marketplace.zoom.us/](https://marketplace.zoom.us/) - Pumunta sa **Develop > Build App** → Piliin ang **Server-to-Server OAuth** → Pangalanan ang iyong app - Sa pahina ng **App Credentials**, kopyahin ang: - **Account ID** - **Client ID** - **Client Secret** Gagamitin mo ang mga ito sa iyong Botpress pagsasaayos ng pagsasama sa ibang pagkakataon. - Sa **Impormasyon**, punan ang kinakailangang impormasyon tungkol sa iyong sarili at sa app. - Sa **Features**, kopyahin ang **Secret Token** - Sa **Scopes**, idagdag ang: cloud_recording:read:list_user_recordings:admin cloud_recording:read:list_recording_files:admin cloud_recording:read:recording:admin - I-activate ang app sa ilalim ng **Activation** tab ### 2. ` Mag-zoom ` Maaari mong mahanap ang Zoom _ sa web nang direkta portal. #### Mga Hakbang: 1. Mag-log in sa iyong Zoom account at mag-navigate sa: **Zoom Admin Panel > User Management > Users** 2. Mag-click sa pangalan ng user na gusto mong makuha ang `host_id`. 3. Tingnan ang URL sa address bar ng iyong browser. Ito ay nasa ganitong format: https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile na gusto mong kopyahin ang xxxxxxxxxxxx dahil iyon ang iyong host_id --- ### 3. I-configure ang Botpress Integration - I-install ang integration na ito sa iyong Bot - I-paste: - `Zoom Client ID` - `Zoom Client Secret` - `Zoom Account ID` - `Secret Token` - `Allowed Zoom User IDs` → I-paste ang iyong `host_id` (maaari kang magsama ng marami) I-click ang **Save Configuration**. --- ### 4. Itakda Webhook sa Mag-zoom Bumalik sa iyong Zoom OAuth App: - Pumunta sa **Mga Tampok** → I-enable ang **Mga Subscription sa Kaganapan** - Pangalan: `Transcript Received` (Maaari ding pumili ng ibang pangalan) - Paraan: ` Webhook ` - Endpoint URL: gamitin ang ** Botpress integration URL** - Magdagdag ng Mga Kaganapan: - Sa ilalim ng **Recording**: - `Nakumpleto na ang lahat ng recording` - `Nakumpleto na ang pagre-record ng mga transcript file` - I-click ang **Done** - I-click ang **Validate** sa tabi ng endpoint URL (dapat mong makita ang Validated) - I-click ang **I-save** --- ## Tapos na! Iyong Botpress makakatanggap na ngayon ang bot ng mga transcript para sa mga pinapayagang user ng Zoom kapag nakumpleto ang mga pag-record ng cloud. Tiyaking: - Ikaw **nag-record sa cloud** - Ikaw ay nasa isang **bayad na Zoom plan** - Naidagdag mo nang tama ang lahat ng nilalayong `host_id`