Slack 連携

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

サポートする接続方式

Slack 連携では、以下の 2 つの接続方式に対応しています。導入要件に合わせて選択してください。

方式	説明	こんな場合に
標準ボット	Admina が提供する公式 Slack アプリを OAuth で接続する方式	最短で導入したい / 自社で Slack アプリを管理したくない
カスタムボット	自社で Slack アプリを作成し、Bot User OAuth Token と Signing Secret を入力して接続する方式	アプリの権限・ブランディングを自社で管理したい / 社内ポリシーで公開アプリのインストールが制限されている

どちらの方式でも、ボットの会話体験（チャンネルメンション、スレッド応答、DM）は同じです。

前提条件

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

標準ボットで接続する

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

連携設定を開く

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

Slack で認証する

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

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

AI Helpdesk Slack アプリが要求するアクセス許可を確認し、許可する をクリックしてください。アプリが要求する主な権限は以下のとおりです。

権限	用途
`channels:read` / `groups:read`	チャンネル情報の読み取り
`chat:write`	メッセージの送信
`im:read` / `im:write`	ダイレクトメッセージの読み書き
`users:read` / `users:read.email`	ユーザー情報の取得・メールアドレス照合
`app_mentions:read`	ボットへのメンション検出

接続完了を確認する

認証が成功すると、AIヘルプデスクの連携設定画面に戻り、メッセージング セクションに接続済みのワークスペースが表示されます。

1 つの組織に複数の Slack ワークスペースを接続できます。同じ手順を繰り返してください。

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

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

接続に必要な情報

項目	取得元
Bot User OAuth Token	Slack App の OAuth & Permissions ページ
Signing Secret	Slack App の Basic Information ページ

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

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

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

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

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

以下のマニフェスト内容を From a manifest のエディタに貼り付け、確認画面で内容を確認したうえで送信します。

display_information:
  name: Admina AI Helpdesk
  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 Helpdesk
    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

Signing Secret を取得する

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

Bot User OAuth Token を取得する

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

AIヘルプデスクのフォームに入力して接続する

手順 1 のフォームに戻り、以下を入力して接続をクリックします。

Bot User OAuth Token: xoxb- で始まるトークン
Signing Secret: Basic Information から取得した値

認証情報が正しければ、メッセージング セクションに接続済みカードが表示されます。

ボットを利用する

接続が完了すると、Slack ワークスペース内にボットが追加されます。

標準ボット: デフォルトの表示名は Admina AI Helpdesk です（後述の Tips で任意の名前に変更できます）。
カスタムボット: 自社で作成した Slack アプリの表示名がそのまま使われます。

標準ボットのボット表示名はワークスペースごとに変更できます。Slack で対象アプリ（Admina AI Helpdesk）を開き、概要タブの設定ボタンから ボットユーザーの名前 を編集してください。

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

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

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

チャンネル内でボットをメンションして質問を送信すると、スレッドで AI が応答します。スレッド内で続けて返信することで、同じセッションを継続できます。

DM での問い合わせを有効にするかどうかは、設定 > 管理 > システム設定 の DM有効 で制御できます。

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

連携設定を開く

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

切断する

切断するワークスペースのカードにあるゴミ箱アイコンをクリックします。確認ダイアログで切断をクリックしてください。

接続を解除すると、そのワークスペースからの問い合わせは受け付けられなくなります。

トラブルシューティング

OAuth 認証で「アクセスが拒否されました」と表示される（標準ボット） Slack ワークスペースでサードパーティアプリのインストールが制限されている可能性があります。 Slack ワークスペースの管理者に確認し、アプリのインストール権限を付与してもらってください。権限の付与が難しい場合は、カスタムボット での接続を検討してください。 「認証情報が無効です」と表示される（カスタムボット）

Bot User OAuth Token が xoxb- で始まる文字列であることを確認してください
Signing Secret に余分な空白や改行が含まれていないことを確認してください
Slack App がワークスペースに正しくインストールされているか確認してください

接続済みになっているのにボットが反応しない ボットが参加しているチャンネルでメンションしているか確認してください。ボットを特定のチャンネルに追加するには、チャンネルで /invite @<ボット名> を実行します（標準ボット ならデフォルトは @Admina AI Helpdesk、表示名を変更している場合や カスタムボット の場合は、ワークスペースで設定したアプリの名前を指定してください）。

はじめに

機能別ガイド

サポートする接続方式

前提条件

標準ボットで接続する

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

接続に必要な情報

ボットを利用する

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

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

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

トラブルシューティング

関連ページ

​サポートする接続方式

​前提条件

​標準ボットで接続する

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

​接続に必要な情報

​ボットを利用する

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

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

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

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

​関連ページ

サポートする接続方式

前提条件

標準ボットで接続する

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

接続に必要な情報

ボットを利用する

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

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

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

トラブルシューティング

関連ページ