メインコンテンツへスキップ
AI Helpdesk の Slack 連携を設定すると、Slack チャンネルやダイレクトメッセージから AI ボットに問い合わせを送信できるようになります。

​
サポートする接続方式

Slack 連携では、以下の 2 つの接続方式に対応しています。導入要件に合わせて選択してください。
方式説明こんな場合に
標準ボットAdmina が提供する公式 Slack アプリを OAuth で接続する方式最短で導入したい / 自社で Slack アプリを管理したくない
カスタムボット自社で Slack アプリを作成し、Bot User OAuth Token と Signing Secret を入力して接続する方式アプリの権限・ブランディングを自社で管理したい / 社内ポリシーで公開アプリのインストールが制限されている
どちらの方式でも、ボットの会話体験（チャンネルメンション、スレッド応答、DM）は同じです。

​
前提条件

  • AI Helpdesk の 管理者（Admin） ロールが必要です
  • Slack ワークスペースの管理者権限（アプリのインストール権限）が必要です
  • カスタムボット を選ぶ場合は、Slack API（Your Apps） でアプリを作成できる権限が必要です

​
標準ボットで接続する

Admina 公式の Slack アプリを OAuth で接続する標準的な方式です。
1

連携設定を開く

左のナビゲーションから 設定 を選択し、連携 タブを開きます。 メッセージング セクションで 接続を追加 ボタンをクリックし、Slack — 標準ボット を選択します。
2

Slack で認証する

Slack の OAuth 認証ページにリダイレクトされます。 Slack にログインし、接続先のワークスペースを選択してください。
3

ボットのアクセス許可を確認する

AI Helpdesk Slack アプリが要求するアクセス許可を確認し、許可する をクリックしてください。アプリが要求する主な権限は以下のとおりです。
権限用途
channels:read / groups:readチャンネル情報の読み取り
chat:writeメッセージの送信
im:read / im:writeダイレクトメッセージの読み書き
users:read / users:read.emailユーザー情報の取得・メールアドレス照合
app_mentions:readボットへのメンション検出
4

接続完了を確認する

認証が成功すると、AI Helpdesk の連携設定画面に戻り、メッセージング セクションに接続済みのワークスペースが表示されます。
1 つの組織に複数の Slack ワークスペースを接続できます。 同じ手順を繰り返してください。

​
カスタムボットで接続する

自社で Slack アプリを作成し、Bot User OAuth Token（フォーム上では「Bot Token」と表示されます）と Signing Secret を AI Helpdesk に入力して接続する方式です。

​
接続に必要な情報

項目取得元
Bot User OAuth TokenSlack App の OAuth & Permissions ページ
Signing SecretSlack App の Basic Information ページ
1

連携設定を開きカスタムボットを選択する

AI Helpdesk の 設定 > 連携 > メッセージング セクションで 接続を追加 をクリックし、Slack — カスタムボット を選択します。Bot User OAuth Token と Signing Secret を入力するフォームが表示されます。 必要な値は次のステップで取得します。
2

Slack でアプリを新規作成する

Slack API（Your Apps） にアクセスし、Create New App をクリックします。続けて、アプリをインストールするワークスペースを選択してください。
3

マニフェスト（slack-manifest.yaml）でアプリを構成する

以下のマニフェスト内容を From a manifest のエディタに貼り付け、確認画面で内容を確認したうえで送信します。
display_information:
  name: Admina AIヘルプデスク
  description: AI-powered assistant with memory and knowledge management
  background_color: "#4A154B"
features:
  app_home:
    home_tab_enabled: true
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: Admina AIヘルプデスク
    always_online: true
oauth_config:
  redirect_urls:
    - https://assist.i.moneyforward.com/web/auth/callback/slack
    - https://assist.i.moneyforward.com/web/slack/oauth/callback
  scopes:
    bot:
      - app_mentions:read
      - channels:history
      - channels:read
      - chat:write
      - chat:write.public
      - files:read
      - groups:history
      - groups:read
      - im:history
      - im:read
      - im:write
      - mpim:history
      - mpim:read
      - team:read
      - users:read
      - users:read.email
  pkce_enabled: false
settings:
  event_subscriptions:
    request_url: https://assist.i.moneyforward.com/chat/slack
    bot_events:
      - app_home_opened
      - app_mention
      - member_joined_channel
      - message.channels
      - message.groups
      - message.im
  interactivity:
    is_enabled: true
    request_url: https://assist.i.moneyforward.com/chat/slack
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false
  is_mcp_enabled: false
4

Signing Secret を取得する

Slack App の詳細画面で Basic Information を開きます。 App Credentials セクションの Signing Secret をコピーします。
5

Bot User OAuth Token を取得する

OAuth & Permissions ページを開き、OAuth Tokens セクションの Install to Workspace をクリックします。OAuth フローが完了すると Bot User OAuth Token（xoxb- で始まる文字列）が発行されます。値をコピーしてください。
6

AI Helpdesk のフォームに入力して接続する

手順 1 のフォームに戻り、以下を入力して 接続 をクリックします。
  • Bot User OAuth Token: xoxb- で始まるトークン
  • Signing Secret: Basic Information から取得した値
認証情報が正しければ、メッセージング セクションに接続済みカードが表示されます。

​
ボットを利用する

接続が完了すると、Slack ワークスペース内にボットが追加されます。
  • 標準ボット: デフォルトの表示名は Admina AIヘルプデスク です（後述の Tips で任意の名前に変更できます）。
  • カスタムボット: 自社で作成した Slack アプリの表示名がそのまま使われます。
標準ボットのボット表示名はワークスペースごとに変更できます。Slack で対象アプリ（Admina AIヘルプデスク）を開き、概要 タブの 設定 ボタンから ボットユーザーの名前 を編集してください。

​
ダイレクトメッセージで質問する

ボットとのダイレクトメッセージに質問を送信すると、AI が応答します。

​
チャンネルでメンションして質問する

チャンネル内でボットをメンションして質問を送信すると、スレッドで AI が応答します。 スレッド内で続けて返信することで、同じセッションを継続できます。
DM での問い合わせを有効にするかどうかは、設定 > 管理 > システム設定 の DM有効 で制御できます。

​
Slack ワークスペースの接続を解除する

1

連携設定を開く

設定 > 連携 タブの メッセージング セクションを開きます。
2

切断する

切断するワークスペースのカードにあるゴミ箱アイコンをクリックします。 確認ダイアログで 切断 をクリックしてください。
接続を解除すると、そのワークスペースからの問い合わせは受け付けられなくなります。

​
トラブルシューティング

OAuth 認証で「アクセスが拒否されました」と表示される（標準ボット） Slack ワークスペースでサードパーティアプリのインストールが制限されている可能性があります。 Slack ワークスペースの管理者に確認し、アプリのインストール権限を付与してもらってください。 権限の付与が難しい場合は、カスタムボット での接続を検討してください。 「認証情報が無効です」と表示される（カスタムボット）
  • Bot User OAuth Token が xoxb- で始まる文字列であることを確認してください
  • Signing Secret に余分な空白や改行が含まれていないことを確認してください
  • Slack App がワークスペースに正しくインストールされているか確認してください
接続済みになっているのにボットが反応しない ボットが参加しているチャンネルでメンションしているか確認してください。 ボットを特定のチャンネルに追加するには、チャンネルで /invite @<ボット名> を実行します（標準ボット ならデフォルトは @Admina AIヘルプデスク、表示名を変更している場合や カスタムボット の場合は、ワークスペースで設定したアプリの名前を指定してください）。

​
関連ページ

最終更新日 2026年7月10日