Zoom Team Chat設定マニュアル
1. 前提条件
- ZoomアカウントのOwnerまたはAdmin権限を持ち、アプリを作成・インストールできること
- Agentic Engineプラットフォームの管理者権限を持っていること
- Agentic Engineに、Zoomからアクセス可能なパブリックHTTPSアドレスが設定されていること
- グループチャットのメッセージをテストするための既存のZoom Team Chatチャンネルがあること
2. Zoom Appを作成して認証情報を取得する
Zoom App Marketplaceにアクセスし、次の手順で操作します：
- Develop → Build Appに進み、General Appを作成します
- 組織内部で使用する場合はAdmin-managedを選択します。開発・テスト段階では、まずDevelopment環境を使用できます
- アプリ名、説明、開発者の連絡先を入力します
- アプリの機能でZoom Team Chat / Chat Subscriptionを有効にします
- Slash Commandを1つ作成します。コマンド名は自由に設定できます（例：
/ae）。Bot Endpoint URLはいったん空欄のままにし、次の章でプラットフォームのチャネル設定を完了してから入力します - Scopesで、アプリに
imchat:bot権限が含まれていることを確認します。含まれていない場合は、手動で追加してください - 現在のアプリ環境の次の情報を控えます：
| 認証情報 | 説明 |
|---|---|
| Client ID | Zoomアプリのクライアント識別子 |
| Client Secret | Client IDと対になるクライアントシークレット |
| Secret Token | Zoomのコールバックリクエストの検証に使用 |
| Bot JID | Chatbotの識別子。通常はrobot_xxxxx@xmpp.zoom.usの形式 |
| Account ID | 現在のZoomアカウントの識別子 |
Client SecretとSecret Tokenは機密性の高い認証情報です。コードリポジトリにコミットしたり、チャットやチケットで送信したりしないでください。DevelopmentとProductionの認証情報は必ずセットで使用し、混在させないでください。
3. プラットフォームでZoom Team Chatチャネルを追加する
管理者がAgentic Engineにログインし、「システム管理」→「エージェント 管理者」→「チャンネル管理」に進みます：
- 「新規チャンネル」をクリックし、チャンネルタイプでZoom Team Chatを選択します
- 次の構成項目を入力します：
| 構成項目 | 必須 | 説明 |
|---|---|---|
| チャンネル名 | 必須 | 表示名。例：「Zoom Team Chat」 |
| Client ID | 必須 | ZoomアプリのClient ID |
| Client Secret | 必須 | ZoomアプリのClient Secret |
| Secret Token | 必須 | ZoomアプリのChat SubscriptionのSecret Token |
| Bot JID | 必須 | Zoom ChatbotのBot JID |
| Account ID | 必須 | Zoomアプリが属するアカウントのAccount ID |
| 連携モデル | 任意 | 入力しない場合は、システムのデフォルトモデルを使用します |
| システムプロンプト | 任意 | このチャネル専用のAgent用System Prompt |
- チャネルを保存し、チャネルリストに戻って「認証情報を検証」をクリックします
- 検証に成功したら、チャネルを有効にします
- チャネルを再度編集し、読み取り専用のBot Endpoint URLをコピーします
- Zoom App Marketplaceに戻り、そのアドレスをChat SubscriptionのBot Endpoint URLに貼り付け、Endpoint URL Validationを完了してから保存します
- Zoomの画面の指示に従って、アプリを現在のアカウントまたはテスト範囲にインストールします
Endpoint URL Validationの前に、Agentic Engineのチャネルで認証情報の検証が完了し、有効な状態になっている必要があります。既存のチャネルを編集する際、Client SecretとSecret Tokenを空欄のままにすると、元の値が保持されます。
4. ユーザーがZoomアカウントを連携する
一般ユーザーは初めて使用する前に、自分のZoomアカウントをAgentic Engineアカウントと連携する必要があります：
- 「アカウント」→「チャネル連携」に進み、使用するZoom Team Chatチャネルを選択します
- システムが生成したワンタイム連携コード（例：
+bind ABC234）をコピーします - Zoom Workplace → Team Chatを開き、管理者がインストールしたChatbotを見つけて、ボットとのプライベートチャットを開きます
- 管理者が実際に設定したSlash Commandで連携コードを送信します。コマンドが
/aeの場合は、/ae +bind ABC234を送信します - 連携成功のメッセージを受け取ったら使用を開始できます。連携を解除する場合は、「チャネル連携」ページに戻って操作します
連携コードの有効期間は10分間で、1回しか使用できません。連携コマンドはボットとのプライベートチャットでのみ使用できます。チャンネルで送信しても連携は完了せず、連携コードも消費されません。
同じZoomアカウントを複数のAgentic Engineユーザーに同時に連携することはできません。アカウントが他のユーザーに連携済みと表示された場合は、まず元のユーザー側で連携を解除してください。
5. グループチャットのメッセージ振り分け
グループチャットのメッセージ振り分けを使用すると、同じZoom Chatbotで、ルールに従って異なる質問を異なるAgentまたはTeamに渡すことができます。ルールは現在のZoomアプリとAccount IDに対応する入口で設定し、そのChatbotが追加されているTeam Chatチャンネルに適用されます。ユーザーはAgentic Engineアカウントを連携済みで、管理者が設定したSlash Commandでタスクを開始する必要があります。通常のチャンネルメッセージや、単にボットを@メンションしただけのメッセージは、Agentic Engineに届きません。
追加の権限チェック
アプリにはimchat:bot権限が含まれ、現在のZoomアカウントにインストールされている必要があります。特定のチャンネルで使用するには、権限を持つメンバーがアプリをそのTeam Chatチャンネルに追加する必要もあります。
管理者による設定
- 使用するTeam ChatチャンネルにChatbotを追加し、実際に設定したSlash Commandがメンバーに表示されることを確認します
- 「システム管理 → エージェント 管理者 → チャンネル管理」に進み、対象のZoom Team Chatチャネルで「メッセージ振り分け」を開きます
- 既定で使用するAgent/Teamを選択します。グループチャット振り分けを有効にする前に、既定の対象を設定する必要があります
- 必要に応じて最大19件のルールを追加します。各ルールでAgent/Teamを1つ選択し、必須の「呼び出しコマンド」を入力します。キーワードも最大10個まで入力できます。その後、有効化スイッチをオンにして保存します
- チャンネルで
/ae +helpを送信して動作を確認します。実際のSlash Commandが/aeでない場合は、管理者が設定したコマンドに置き換えてください
| 構成項目 | ルール |
|---|---|
| 既定の Agent/Team | 有効化する前に設定が必要です。呼び出しコマンドが指定されておらず、キーワードにも一致しない場合に使用されます |
| 呼び出しコマンド | 必須、1～32文字。英字、数字、-、_を使用できます。システムの予約コマンドは使用できません。大文字・小文字や全角・半角の違いは、別のコマンドとして扱われません |
| キーワード | 入力は任意です。各ルール最大10個、1個あたり2～32文字。複数のキーワードが同時に一致した場合は、長いキーワードが優先されます。同じ長さで一意に判断できない場合は、既定のAgent/Teamを使用します |
| 選択可能な範囲 | 有効かつ実行可能なシステム/企業Agent、および現在の企業のTeamを選択できます。個人Agentは候補に表示されません |
チャンネルでの使い方
下表の例では、Zoomで設定したSlash Commandを/aeと仮定しています。
| 用途 | 例 | 説明 |
|---|---|---|
| 利用可能な機能を確認 | /ae +help | 現在のユーザーが使用でき、かつ現在実行可能な機能を表示します |
| Agent/Teamを指定 | /ae +analysis 分析本周数据 | analysisは管理者が設定した呼び出しコマンドです |
| キーワードで振り分け | /ae 帮我检查埋点方案 | キーワードに一致した場合は対応するルールを、一致しない場合は既定の対象を使用します |
| タスクを取消 | /ae +cancel | メッセージ全体をこのとおり正確に送信する必要があります |
| 旧形式との互換 | /ae +agent analysis 分析本周数据 | 引き続き使用できますが、+analysisを直接使用することを推奨します |
コマンドの範囲：グループチャット振り分けでは+newは使用できません。ボットとのプライベートチャットでは引き続き+new、+agent、+cancelを使用できます。チャンネルでの新規タスクには、毎回実際のSlash Commandを使用する必要があります。
公開コンテキストと個人データ：チャンネルのタスクは独立した新しい会話を使用し、ボットとのプライベートチャットの内容やユーザーメモリは読み取りません。チャンネルでの質問と回答はチャンネルのメンバーに表示されるため、機密情報はボットとのプライベートチャットで送信してください。
6. よくある質問
認証情報の検証に失敗する
- Client ID、Client Secret、Secret Token、Bot JID、Account IDが同じZoomアプリ環境のものであることを確認します
- ZoomアプリでChat Subscriptionが有効になっており、
imchat:bot権限が含まれていることを確認します - DevelopmentとProductionの認証情報が混在していないことを確認します
Endpoint URL Validationに失敗する
- Agentic Engineのチャネルで「認証情報を検証」が完了し、有効になっていることを確認します
- Zoomに入力したBot Endpoint URLが、プラットフォームに表示されたアドレスと完全に一致していることを確認します
- Agentic EngineのパブリックHTTPSアドレスにZoomからアクセスできることを確認します
- Secret Tokenが現在のZoomアプリ環境のものであることを確認します
ユーザーがZoomアカウントを連携できない
- 連携コードが、ボットとのプライベートチャットで実際のSlash Commandを使って送信されていることを確認します
- 連携コードが10分間の有効期間内で、まだ使用されていないことを確認します
- そのZoomアカウントが他のAgentic Engineユーザーに連携されていないことを確認します
Botがチャンネルのメッセージを受信できない
- 通常のメッセージや単なるボットへの@メンションではなく、Zoom Slash Commandを使用していることを確認します
- アプリが対象のTeam Chatチャンネルに追加されていることを確認します。アカウントにインストールされているだけ、またはコマンドの候補が表示されるだけでは、アプリがチャンネルに追加されたことにはなりません
- ユーザーがボットとのプライベートチャットでアカウント連携を完了していることを確認します
Slash Commandを送信すると消える
- ZoomはSlash Commandを通常のチャンネルメッセージとして表示しません。これは正常な動作です
- しばらく待つと、ボットから質問者、元の質問、回答を含むメッセージが送信されます
Botはコマンドを受信できるが返信できない
- Bot JID、Account ID、
imchat:bot権限が正しく設定されていることを確認します - チャネルが引き続き有効な状態であり、アプリが現在のZoomアカウントのインストール範囲またはテスト範囲内にあることを確認します
関連ページと次のステップ
- 他のプラットフォームの接続手順を確認する：チャンネル管理。
- チャネル接続と連携の全体的な流れを確認する：チャネルの概要と連携。
- 使用するAgentを設定する：Agent。
- プラットフォーム内での会話の使い方を確認する：会話。