Zoom アカウントを Okou に接続すると、会議を管理し、チャットを通じて会議情報を扱えます。このガイドでは、ユーザー管理型コネクタの Zoom を扱います。Zoom Admin と Zoom AI は別のコネクタです。
始める前に
- Okou にサインインし、接続を許可された Zoom アカウントを用意してください。
- Zoom アカウントの管理者によるアプリまたはその権限の承認が必要な場合があります。
- 外部配布に対する Zoom の承認は保留中です。承認されるまでは、利用可否は Zoom のアプリ共有ルールにより制限されます。Okou でコネクタを見つけても、それらのルールは回避できません。
- クラウド録画には、対象の Zoom プラン、クラウド録画の有効化、完了済みの録画が必要です。トランスクリプトは Zoom によって既に生成されている必要があります。ウェビナー機能には、該当する Zoom ライセンスとアクセスが必要です。
- 変更内容や会議の削除を評価する場合は、テスト用アカウントとテスト会議を使用してください。顧客の会議をテストに使用しないでください。
アプリを追加する
- Okou Connectors を開きます。
- Discover で、Find connectors に Zoom と入力します。
- Meetings and scheduling の Zoom カードで Connect Zoom を選択します。このガイドでは、Zoom Admin や Zoom AI は選択しないでください。
- Zoom の認可ウィンドウが開きます。Okou にアクセスさせたい会議がある Zoom アカウントでサインインします。
- アプリケーション名と要求されている権限を確認します。続行するには Allow を、キャンセルするには Decline を選択します。共有アクセス権限は任意です。作業に必要な場合を除き、無効のままにしてください。
- Okou に戻り、アカウントが接続済みとして表示されていることを確認します。My Okou: 接続されたアカウントと、名前付きの権限を確認します。Legacy Agents: さらに、Zoom を使用できる Agent も選択します。リクエストで提示されたアクセス期間を選択してください。
- My Okou では自分の Chat、Legacy Agents では選択した Agent との Chat を開きます。接続を確認するには、今後の Zoom 会議を一覧表示して と依頼します。新しいアカウントでは、会議一覧が空でも正常な結果です。
アカウントの接続と Okou にアクセスを付与することは別の手順です。Legacy Agents では Agent の認可も使用します。他のチームメンバーの Zoom 接続によって、その人のアカウントにアクセスできるようにはなりません。
チャットで Zoom を使う
Okou は、接続済みアカウントの Zoom アクセス権と、付与された Okou 権限（Legacy Agents での Agent 認可を含む）の範囲内で、要求されたタスクに対して Zoom を呼び出します。会議、タイムゾーン、実行したい操作を明確に指定してください。
| 機能 | 依頼の例 | 前提条件と結果 |
|---|---|---|
| 会議を一覧表示する | 今後の Zoom 会議を一覧表示して。 | 認可済みの Zoom アカウントが必要です。会議のトピック、時刻、ID、利用可能な参加リンクが返されます。 |
| 会議を表示する | Zoom 会議 [meeting ID] の詳細を表示して。 | その会議へのアクセス権が必要です。利用可能な会議情報が返されます。 |
| 会議をスケジュールする | Asia/Shanghai で明日 10:00 に、Review test という名前の 30 分の Zoom 会議を作成して。誰も招待しないで。 | 会議を作成する権限が必要です。会議 ID、時刻、参加リンクが返されます。 |
| 会議を更新する | Zoom 会議 [meeting ID] を Asia/Shanghai の 11:00 に変更して、45 分にして。 | 自分が管理を許可されている会議が必要です。指定した項目が更新されます。 |
| 会議を削除する | テスト用の Zoom 会議 [meeting ID] だけを削除して。 | 自分が削除できる会議が必要です。削除すると指定した会議はキャンセルされるため、依頼前に ID を確認してください。 |
| 進行中の会議を終了する | テスト用の Zoom 会議 [meeting ID] を終了して。 | 自分が主催していて終了できる進行中の会議が必要です。参加者に対してその会議を終了します。 |
| 過去の会議の詳細 | 完了済みのテスト用 Zoom 会議 [meeting UUID] の詳細を表示して。 | 完了済みの会議と、そのデータへのアクセス権が必要です。履歴上のインスタンスでは Zoom の meeting UUID を使用します。 |
| 過去の参加者 | 完了済みのテスト用 Zoom 会議 [meeting UUID] の参加者を一覧表示して。 | 完了済み会議の参加者データへのアクセス権が必要です。利用可能かどうかは、Zoom アカウントの権限と保持期間に依存します。 |
| 録画を検索する | [date] から [date] までの Zoom クラウド録画を探して。 | クラウド録画へのアクセス権と、その期間内の録画が必要です。1 回のリクエストで指定する期間は 30 日以内にしてください。 |
| 録画ファイルを表示する | Zoom 会議 [meeting ID] で利用可能な録画ファイルを表示して。 | アクセス可能な完了済みクラウド録画が必要です。Zoom で利用可能になっているファイルが返されます。 |
| 利用可能な文字起こしを読む | テスト用の Zoom 録画 [meeting ID] の既存の文字起こしを読んで。 | Zoom がすでに生成した文字起こしファイルと、それにアクセスする権限が必要です。この操作で録画が有効になることはなく、不足している文字起こしが作成されることもありません。 |
| ウェビナーを一覧表示する | 自分がアクセスできるウェビナーを一覧表示して。 | ウェビナー対応の Zoom アカウントと適切な権限が必要です。 |
| ウェビナーを表示する | Zoom ウェビナー [webinar ID] の詳細を表示して。 | そのウェビナーへのアクセス権が必要です。コネクタはウェビナー情報を読み取るだけで、ウェビナーを作成したり変更したりはしません。 |
権限とデータ
ユーザー管理型の統合では、上記の機能に対して profile、meeting、past-participant、cloud-recording、webinar の権限を要求します。profile アクセスは、接続したアカウントを識別します。meeting の書き込み権限は、会議のスケジュール、更新、削除、終了をサポートします。recording と webinar の権限は、アクセス可能な情報とファイルの読み取りをサポートします。
Okou は OAuth 資格情報をプラットフォーム上で暗号化して保存し、アクセス トークンをサーバー側で更新します。資格情報は環境変数として Agent コードに渡されるのではなく、ネットワーク境界でコネクタのリクエストに注入されます。この統合では、Okou のチャットに Zoom のパスワードは不要です。
タスクのために取得した会議情報、参加者情報、または録画/トランスクリプトの内容は、Okou のチャットや、Okou に作成させたドキュメントやその他の成果物に表示される場合があります。アカウントの切断を、以前に保存されたチャット結果や成果物の削除とみなさないでください。収集、使用、保持、削除、およびデータ権利については Privacy Policy を、アカウント認可と権限制御については 権限 を参照してください。
アプリを削除する
今後の使用を停止し、Okou から接続を削除するには、次の手順を実行します。
- Okou で Connectors を開き、Connected を選択します。
- Zoom を見つけて Manage Zoom accounts を開きます。
- 削除したいアカウントを選択し、Disconnect を選択します。影響を受けるアカウントを確認して確定します。
- そのアカウントが接続済みとして表示されなくなったことを確認します。今後のタスクには、別の接続済みアカウントか新しい認可が必要です。
また、Zoom 側でプロバイダーの認可を取り消します。
- 同じ Zoom アカウントで Zoom App Marketplace にサインインします。
- Marketplace の画面に応じて My library または Manage > Added Apps を開きます。
- この Okou アプリを見つけ、削除コントロールを開いて Remove を選択します。削除を確定します。
Legacy Agents では、1 つの Agent の認可を削除しても、その Agent のアクセスだけが削除されます。ほかの認可済み Agent に対して Zoom アカウントの接続が解除されることはありません。このアプリを切断またはアンインストールしても、Zoom 内の会議や録画は削除されません。それらのリソースも削除したい場合は、Zoom 自身の操作を使用してください。
Okou に保持されている Zoom 由来のデータの削除を依頼するには、Okou アカウントに関連付けられたメールアドレスから [email protected] に連絡してください。対象のアカウントと関連するチャットまたは成果物を明記し、パスワードやアクセストークンは決して含めないでください。依頼は、該当する法的な保持義務を含め Privacy Policy に従って処理されます。
トラブルシューティング
- Zoom がインストールを拒否する、またはアプリが利用できないと言われる: Zoom アカウントの管理者に、アプリの承認状況と共有の適格性を確認してください。Zoom が承認するまでは外部配布は利用できません。
- 認可が拒否された、またはウィンドウを閉じてしまった: Connectors に戻り、接続ボタンがまだ処理中ならページを更新して、新しい認可を開始してください。キャンセルされた試行では接続は確立されません。
- 接続済みだが、Okou が権限を求める: 対象の Agent と、要求された特定の操作を認可してください。接続しただけでは、すべての Agent にアクセス権は付与されません。
- アカウントが違う: 認可時に正しい Zoom アカウントを選択してください。必要に応じて、Okou でアカウントを管理または切断してから再接続してください。
- 再接続が必要: アカウントのコントロールから再接続してください。トークンの期限が切れているか、認可が取り消されている可能性があります。トークンをチャットに貼り付けないでください。
- 会議、録画、ウェビナーが表示されない: 接続済みアカウント、日付範囲、会議の所有権、Zoom ライセンス、対象リソースの有無を確認してください。空の結果は接続失敗の証拠ではありません。
- トランスクリプトまたは録画が見つからない: Zoom の処理が完了するまで待ち、録画/文字起こしが Zoom で有効になっていたことを確認してください。Okou は、Zoom がまだ生成していない、または利用可能にしていないファイルを取得できません。
- レート制限またはプロバイダー エラー: Zoom で示された間隔を待ってください。会議の作成や変更を再試行する前に、元の操作の結果を確認し、重複を避けてください。
サポートが必要な場合は、support page を使用するか、実行した操作、おおよその時刻、エラーメッセージ、および関連するテスト会議 ID を添えて [email protected] にメールしてください。資格情報と非公開の会議内容は含めないでください。
