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

連携前の確認

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

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

クイックインストール：App Manifest を使用する

Slack API にアクセスし、Create New App をクリックして From a manifest を選択し、App をインストールするワークスペースを選びます。YAML タブに切り替え、以下の完全な Manifest を貼り付けます。

display_information:
  name: MaiAgentBot
features:
  app_home:
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: MaiAgentBot
    always_online: false
oauth_config:
  scopes:
    bot:
      - chat:write
      - users:read
      - im:history
      - channels:history
      - groups:history
      - files:read
      - app_mentions:read
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

MaiAgentBot は例として設定した名前です。App を作成する前に、display_information.name と features.bot_user.display_name を任意の名前に変更できます。

Manifest から App を作成した場合、以下の手動設定のステップ 1〜3（App の作成、scopes の設定、App Home の有効化）は省略できます。ただし、ステップ 4 から MaiAgent で対話プラットフォームを作成し、Webhook URL を取得した後にステップ 5 の Event Subscriptions を完了する必要があります。Request URL は、MaiAgent の対話プラットフォームを作成した後にのみ発行されます。

ステップ 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名 と入力するか、チャンネル設定 → インテグレーション → アプリを追加 から追加してください。