# Zoom トランスクリプトの統合 特定のZoomユーザーが主催する会議のZoom会議の記録を、Botpress 簡単に受信し、自動化できます。 ## 仕組み 1.**Zoom会議が終了** → 会議記録の準備ができたら、Zoomがwebhook 送信。 2.2.**統合フィルター `host_id`** → 指定したZoomユーザーからのイベントのみ許可。 3.**トランスクリプトの取得とクリーニング** → Zoomからダウンロードし、プレーンテキストに変換。 4.**イベント発行** → `meetingUUID` と `transcript` を含む `transcriptReceived` イベントがフローで利用可能になります。 --- ## 利用方法 - ワークフローをトリガーする** → `transcriptReceived` の "Listen to Event" カードを追加する。 - データへのアクセス** → `event.payload.meetingUUID`と`event.payload.transcript`をフローで使用する。 - トランスクリプトを保存する** →後の分析やレポート作成のためにテーブルに保存する。 --- ## 前提条件 以下の条件を満たす必要があります: - Zoom OAuthアプリを作成するには、**Zoomの**アカウント所有者**、**管理者**、または**"Zoom for Developers "ロール**を持っている必要があります。 - Zoomプレミアムプラン**であること(無料プランはクラウド録画に対応していません) --- ## ステップバイステップのセットアップ ### 1.Zoom OAuth アプリの作成 - 訪問する:[https://marketplace.zoom.us/](https://marketplace.zoom.us/) - Develop > Build App** → **Server-to-Server OAuth** → Name your app を選択します。 - App Credentials**ページでコピーします: - アカウント ID** - クライアント ID** - クライアントシークレット これらは後でBotpress 統合設定で使用します。 - Information**に、あなた自身とアプリに関する必要な情報を記入します。 - Features**で、**Secret Token**をコピーします。 - Scopes**に、以下を追加します: cloud_recording:read:list_user_recordings:adminを追加します。 cloud_recording:read:list_recording_files:adminを追加します。 cloud_recording:read:recording:adminを追加します。 - Activation**タブでアプリをアクティブにする。 ### 2.Zoom `host_id`を取得する。 Zoom Webポータルから直接、Zoom `host_id`を取得できます。 #### 手順 1.Zoomアカウントにログインし、次のページに移動します: **Zoom管理パネル > ユーザー管理 > ユーザー**」に移動します。 2.host_id`を取得したいユーザー名をクリックします。 3.ブラウザのアドレスバーでURLを見てください。このような形式になっているでしょう: https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile xxxxxxxxxxxxxはあなたのhost_idなのでコピーしてください。 --- ### 3.Botpress インテグレーションを設定する - このインテグレーションをあなたのBotにインストールします。 - 貼り付けます: - ズームクライアントID - ズームクライアントシークレット - ZoomアカウントID - 秘密のトークン - 許可されたZoomユーザーID` → `host_id`を貼り付ける(複数可) Save Configuration**をクリックします。 --- ### 4.ZoomでWebhook 設定する Zoom OAuthアプリに戻ります: - Features** → Enable **Event Subscriptions** に進みます。 - 名前トランスクリプト受信` (別の名前も選択可能) - メソッド:Webhook - エンドポイントURL: **Botpress 統合URL**を使用 - イベントを追加します: - イベント追加: **Recording**の下にある: - すべての録画が完了しました - 記録ファイルの記録が完了しました - 完了**をクリック - エンドポイントURLの横にある**Validate**をクリックします。 - 保存**をクリックします。 --- ## 完了です! クラウド録画が完了すると、許可されたZoomユーザーのトランスクリプトがBotpress ボットに送信されます。確認してください: - クラウドに録音している - Zoomの有料プラン**を利用している - 意図したすべての `host_id` を正しく追加している