# 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/
- 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を正しく追加している
