SteveアプリをZoomに追加する
前提条件、2つのインストール方法、Steveが要求する権限、接続の確認方法
概要
このページでは、Steve for Zoom Team Chat をZoomアカウントに追加する手順を扱います。前提条件、2通りのインストール方法、Steveが要求する権限、そして接続の確認方法までを説明します。
対象者: 📣 PMM／管理者 — Zoomの接続は組織単位の操作です。
うまくいかない場合は？ トラブルシューティング を参照するか、tech@hiresteve.ai までメールしてください。
前提条件
Zoomアプリを追加する前に：
| 要件 | 詳細 |
|---|---|
| Steveアカウント | hiresteve.ai でサインアップ。Zoom連携は組織単位で設定します。 |
| Steveの組織マネージャー／管理者ロール | 連携の接続・設定・切断は組織マネージャーのみが行えます。 |
| Zoomでアプリを認可する権限 | Zoomアカウントでアプリを認可できる必要があります。Zoom管理者がMarketplaceを制限している場合は、Steveアプリの事前承認を依頼してください。 |
| Steveプロジェクトが1つ以上 | コマンド、サマリー、監視はプロジェクト単位のため、先にプロジェクトを作成してください。 |
| Zoom Team Chatが有効 | 必須です。SteveボットはZoom Team Chat上で動作します。 |
方法A：Zoom App Marketplaceから追加
- Zoom App Marketplace にサインインします。
- Steve を検索し、Steve for Zoom Team Chat のリスティングを開きます。
- Add をクリックします。
- Steveが要求する権限（下記の要求する権限）と規約を確認します。
- Allow をクリックしてアプリを認可します。
- Steveにリダイレクトされます。まだサインインしていない場合はサインイン（またはアカウント作成）すると、ZoomアカウントがSteve組織にリンクされます。
- 接続を確認します — 下記の接続を確認するを参照。
キャプション：Marketplaceのリスティング — Addをクリックして認可フローを開始します。
方法B：Steve内から追加
ステップ1：Zoom設定を開く
- Steveアカウントにログインします。
- ナビゲーションメニューの 設定 をクリックします。
- Zoom タブ（Zoom Team Chat と表示）を開きます。
キャプション：Zoom Team Chatカードにはボットの機能と現在の接続ステータスが表示されます。
ステップ2：Zoomワークスペースを接続する
Zoomタブには Zoom Team Chat カードが表示され、ボットの機能と現在のステータス — Zoomに未接続、またはリンク後は 接続済み（メールアドレス） — が確認できます。
- Add to Zoom をクリックします。
- Zoomの認可ページにリダイレクトされます。
- Steveが要求する権限を確認します。
- Allow をクリックします。
- ZoomからSteveにリダイレクトされます。
キャプション：Zoomの同意画面 — スコープを確認してAllowをクリックします。
要求する権限
Steve for Zoom Team Chatは以下のZoomスコープを要求します。
| スコープ | Steveが必要とする理由 |
|---|---|
team_chat:read | ボットが参加しているチャットとチャンネルのメッセージを読み取り、コマンドを認識し競合インサイトを検出するため |
team_chat:write | 返信、コマンド結果、カード、定期サマリーを会話に投稿するため |
team_chat:read:list_channels | ボットが所属するチャンネルを一覧し、Steve内で通知チャンネルとインテリジェンスチャンネルを選択できるようにするため |
chat_channel:read | 正しいチャンネルにメッセージを配信するために必要なチャンネル詳細とメンバーシップを読み取るため |
imchat:bot | ボットメッセージとインタラクティブカード（ドロップダウン、ボタン）を送受信するため |
user:read | 基本プロフィール（氏名、メールアドレス、ZoomアカウントID）を読み取り、ZoomアカウントをSteve組織にリンクするため |
Steveはボットが追加されたチャットとチャンネルのメッセージのみを読み取ります。会議、クラウド録画、連絡先にアクセスすることはありません。
接続を確認する
認可が成功すると：
- 「Zoom connected successfully!」 という成功メッセージが表示されます。
- Zoom Team Chatカードに緑のドットと 接続済み（メールアドレス） が表示されます。
- Add to Zoom ボタンが Disconnect に置き換わります。
キャプション：緑のドットとZoomのメールアドレスが、ワークスペースのリンクを示します。
1つのZoomアカウントは1つのSteve組織にのみ接続できます。「このZoomアカウントは既に別の組織に接続されています」 と表示された場合は、先にそちらで切断するか、tech@hiresteve.ai にご連絡ください。
Steveボットをチャンネルに追加する
チャンネル機能（定期サマリー、インテリジェンス監視、/steve コマンド）は、ボットがメンバーになっているチャンネルでのみ動作します。
- Zoom Team Chatで、使用したいチャンネルを開きます。
- Steve アプリ／ボットをチャンネルのメンバーとして追加します。
- 通知や監視に使用する予定のすべてのチャンネルで繰り返します。
キャプション：Steve側でチャンネルを設定する前に、ボットをチャンネルに追加してください。
Steveの設定画面のドロップダウンにチャンネルが表示されない場合、ほぼ確実にボットがまだそのチャンネルに追加されていないことが原因です。
動作を確認する
ZoomのダイレクトメッセージでSteveボットに /help を送信します。ボットがコマンドメニューを返せばインストール完了です。
キャプション：/help の返信が、ボットが稼働していることの最も手早い確認方法です。
返信がない場合は トラブルシューティング を参照してください。
次のステップ
- Steveとチャットする — 最初の質問をしてみる。
- Zoomニュースサマリー — チャンネルにダイジェストを定期配信。
- インテリジェンス検出 — Steveが監視するチャンネルを選ぶ。
- アプリを削除する — 認可解除とデータの取り扱い。