対話プラットフォーム連携：Slack

連携前の確認

• MaiAgent プラットフォーム上で「AI アシスタント」を 1 つ作成済みであること

• Slack ワークスペース（Workspace）の管理者権限を保有していること

ステップ 1：Slack App を作成する

1. Slack API にアクセスして App を作成する

https://api.slack.com/apps にアクセスし、Create an App をクリックします。

Slack API — Your Apps ページ

2. From scratch を選択する

From scratch を選択し、グラフィカルなインターフェースで手動設定を行います。

作成方法として From scratch を選択

3. App 名とワークスペースを入力する

App 名（例：MaiAgentBot）を入力し、インストール先の Slack ワークスペースを選択して、Create App をクリックします。

App 名を入力しワークスペースを選択

4. Signing Secret を取得する

作成が完了したら Basic Information ページに進み、App Credentials セクションで Signing Secret を見つけ、Show をクリックしてコピーし、控えておきます。

App Credentials — Signing Secret をコピー

---

ステップ 2：Bot の権限を設定する

1. OAuth & Permissions に進む

左側のメニューで OAuth & Permissions をクリックします。

OAuth & Permissions ページ

2. Bot Token Scopes を追加する

下にスクロールして Bot Token Scopes セクションまで移動し、Add an OAuth Scope をクリックして、以下の権限を順に追加します。

Scope	説明
app_mentions:read	ボットに @ メンションされたメッセージを読み取る
channels:history	パブリックチャンネルのメッセージ履歴を読み取る
chat:write	メッセージを送信する
files:read	ファイル（画像／ドキュメント）を読み取る
groups:history	プライベートチャンネルのメッセージ履歴を読み取る
im:history	ダイレクトメッセージのメッセージ履歴を読み取る
mpim:history	グループダイレクトメッセージの履歴を読み取る

Bot Token Scopes の権限設定

3. App をワークスペースにインストールする

ページ上部までスクロールして戻り、Install to Workspace（または Reinstall to Workspace）をクリックします。

Install App ページ

Slack が認可ページに遷移するので、権限を確認したうえで 許可する をクリックします。

App によるワークスペースへのアクセスを認可

4. Bot User OAuth Token をコピーする

インストールが完了したら OAuth & Permissions ページに戻り、Bot User OAuth Token（形式は xoxb-...）をコピーします。

Bot User OAuth Token をコピー

---

ステップ 3：App Home を設定する（ダイレクトメッセージを有効化）

左側のメニューから App Home ページに進み、Show Tabs セクションで以下を行います。

1. Messages Tab を有効にする

2. Allow users to send Slash commands and messages from the messages tab にチェックを入れる

Messages Tab を有効にして、ユーザーが Bot にダイレクトメッセージを送れるようにする

このステップは必ず完了させてください。完了しないと、ユーザーはダイレクトメッセージで Bot と対話できません。

---

ステップ 4：MaiAgent で Slack 対話プラットフォームを作成する

1. 対話プラットフォーム連携に進む

MaiAgent の左側メニューで 対話プラットフォーム をクリックし、右上の 対話プラットフォームを連携 をクリックして、Slack を選択します。

MaiAgent の Slack 連携設定画面

2. 基本設定を入力する

項目	説明
名称	この連携に名前を付けます（必須）
AI アシスタント	紐付ける AI アシスタントを選択します
Bot User OAuth Token	ステップ 2 で取得した Bot Token を貼り付けます（必須）
Signing Secret	ステップ 1 で取得した Signing Secret を貼り付けます（必須）

3. 認証情報を検証する

認証情報を検証 ボタンをクリックし、Token と Secret が正しいことを確認します。

4. チャットルーム設定

設定	説明
グループでは @ メンションされた場合のみ応答する	有効にすると、Bot はグループチャンネルで @ メンションされたときのみ応答します
リセットコマンドを有効にする	有効にすると、ユーザーはコマンドで対話を最初からやり直せます

5. 保存して Webhook URL を取得する

対話プラットフォームを連携 をクリックして作成を完了します。システムが Webhook URL を生成しますので、コピーして控えておいてください。

---

ステップ 5：Slack App に戻って Event Subscriptions を設定する

1. Events を有効にする

Slack App の左側メニューで Event Subscriptions をクリックし、Enable Events をオンにします。

Event Subscriptions 設定ページ

2. Request URL を貼り付ける

MaiAgent が生成した Webhook URL を Request URL 欄に貼り付けます。Slack が自動的に検証を行い、Verified ✓ と表示されれば設定成功です。

Request URL の検証成功

3. Bot Events を購読する

Subscribe to bot events セクションを展開し、Add Bot User Event をクリックして、以下のイベントを追加します。

Event	説明
message.im	ダイレクトメッセージ内の新着メッセージ
message.channels	パブリックチャンネル内の新着メッセージ
message.groups	プライベートチャンネル内の新着メッセージ
message.mpim	グループダイレクトメッセージ内の新着メッセージ
app_mention	チャンネル内で @ メンションされる

Bot Events を購読

4. 変更を保存する

Save Changes をクリックして設定を完了します。

保存後、Slack から App の再インストールを求められる場合があります。新しい権限を適用するため、ページ上部の案内をクリックして再インストールしてください。

---

利用を開始する

連携が完了すると、以下の方法で AI アシスタントと対話できます。

ダイレクトメッセージでの対話

Slack で Bot に直接ダイレクトメッセージを送ると、AI アシスタントが自動的に返信します。テキスト、画像、ファイルの送信に対応しています。

Slack のダイレクトメッセージ対話 — AI アシスタントが自動返信（画像認識に対応）

ファイルのアップロードと分析

ユーザーは対話の中で Excel や PDF などのファイルをアップロードでき、AI アシスタントはファイルの内容を読み取って関連する質問に回答できます。

Excel ファイルをアップロードすると、AI アシスタントが自動的に内容を分析

チャンネルでの @ メンション

チャンネル内で @Bot名 質問内容 のように入力すると、AI アシスタントがチャンネル内で返信します。

Bot を特定のチャンネルに追加するには、そのチャンネルで /invite @Bot名 と入力するか、チャンネル設定 → インテグレーション → アプリを追加 から追加してください。