> ## Documentation Index > Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt > Use this file to discover all available pages before exploring further. # Slack 連携 > AI Helpdesk と Slack ワークスペースを接続する手順を説明します。標準ボットとカスタムボットの 2 つの接続方式に対応します。 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）](https://api.slack.com/apps) でアプリを作成できる権限が必要です ## 標準ボットで接続する Admina 公式の Slack アプリを OAuth で接続する標準的な方式です。 左のナビゲーションから **設定** を選択し、**連携** タブを開きます。 **メッセージング** セクションで **接続を追加** ボタンをクリックし、**Slack — 標準ボット** を選択します。 {/* ![スクリーンショット: 設定 > 連携 > Slack 選択](/images/ai-helpdesk/placeholder.png) */} Slack の OAuth 認証ページにリダイレクトされます。 Slack にログインし、接続先のワークスペースを選択してください。 {/* ![スクリーンショット: Slack OAuth 認証ページ](/images/ai-helpdesk/placeholder.png) */} AI Helpdesk Slack アプリが要求するアクセス許可を確認し、**許可する** をクリックしてください。 アプリが要求する主な権限は以下のとおりです。 | 権限 | 用途 | | --------------------------------- | ------------------- | | `channels:read` / `groups:read` | チャンネル情報の読み取り | | `chat:write` | メッセージの送信 | | `im:read` / `im:write` | ダイレクトメッセージの読み書き | | `users:read` / `users:read.email` | ユーザー情報の取得・メールアドレス照合 | | `app_mentions:read` | ボットへのメンション検出 | 認証が成功すると、AI Helpdesk の連携設定画面に戻り、**メッセージング** セクションに接続済みのワークスペースが表示されます。 1 つの組織に複数の Slack ワークスペースを接続できます。 同じ手順を繰り返してください。 {/* ![スクリーンショット: 接続済みワークスペースカード](/images/ai-helpdesk/placeholder.png) */} ## カスタムボットで接続する 自社で Slack アプリを作成し、**Bot User OAuth Token**（フォーム上では「Bot Token」と表示されます）と **Signing Secret** を AI Helpdesk に入力して接続する方式です。 ### 接続に必要な情報 | 項目 | 取得元 | | ------------------------ | --------------------------------------- | | **Bot User OAuth Token** | Slack App の **OAuth & Permissions** ページ | | **Signing Secret** | Slack App の **Basic Information** ページ | AI Helpdesk の **設定 > 連携 > メッセージング** セクションで **接続を追加** をクリックし、**Slack — カスタムボット** を選択します。 Bot User OAuth Token と Signing Secret を入力するフォームが表示されます。 必要な値は次のステップで取得します。 {/* ![スクリーンショット: Slack - カスタムボット追加フォーム](/images/ai-helpdesk/placeholder.png) */} [Slack API（Your Apps）](https://api.slack.com/apps) にアクセスし、**Create New App** をクリックします。 続けて、アプリをインストールするワークスペースを選択してください。 以下のマニフェスト内容を **From a manifest** のエディタに貼り付け、確認画面で内容を確認したうえで送信します。 ```yaml theme={null} 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 ``` {/* ![スクリーンショット: Slack App マニフェスト編集画面](/images/ai-helpdesk/placeholder.png) */} Slack App の詳細画面で **Basic Information** を開きます。 **App Credentials** セクションの **Signing Secret** をコピーします。 {/* ![スクリーンショット: Slack App Basic Information](/images/ai-helpdesk/placeholder.png) */} **OAuth & Permissions** ページを開き、**OAuth Tokens** セクションの **Install to Workspace** をクリックします。 OAuth フローが完了すると **Bot User OAuth Token**（`xoxb-` で始まる文字列）が発行されます。値をコピーしてください。 {/* ![スクリーンショット: Slack App OAuth & Permissions](/images/ai-helpdesk/placeholder.png) */} 手順 1 のフォームに戻り、以下を入力して **接続** をクリックします。 * Bot User OAuth Token: `xoxb-` で始まるトークン * Signing Secret: Basic Information から取得した値 認証情報が正しければ、**メッセージング** セクションに接続済みカードが表示されます。 {/* ![スクリーンショット: カスタムボット接続完了](/images/ai-helpdesk/placeholder.png) */} ## ボットを利用する 接続が完了すると、Slack ワークスペース内にボットが追加されます。 * 標準ボット: デフォルトの表示名は **Admina AIヘルプデスク** です（後述の Tips で任意の名前に変更できます）。 * カスタムボット: 自社で作成した Slack アプリの表示名がそのまま使われます。 標準ボットのボット表示名はワークスペースごとに変更できます。Slack で対象アプリ（**Admina AIヘルプデスク**）を開き、**概要** タブの **設定** ボタンから **ボットユーザーの名前** を編集してください。 ### ダイレクトメッセージで質問する ボットとのダイレクトメッセージに質問を送信すると、AI が応答します。 ### チャンネルでメンションして質問する チャンネル内でボットをメンションして質問を送信すると、スレッドで AI が応答します。 スレッド内で続けて返信することで、同じセッションを継続できます。 DM での問い合わせを有効にするかどうかは、**設定 > 管理 > システム設定** の **DM有効** で制御できます。 ## Slack ワークスペースの接続を解除する **設定 > 連携** タブの **メッセージング** セクションを開きます。 切断するワークスペースのカードにあるゴミ箱アイコンをクリックします。 確認ダイアログで **切断** をクリックしてください。 接続を解除すると、そのワークスペースからの問い合わせは受け付けられなくなります。 ## トラブルシューティング **OAuth 認証で「アクセスが拒否されました」と表示される（標準ボット）** Slack ワークスペースでサードパーティアプリのインストールが制限されている可能性があります。 Slack ワークスペースの管理者に確認し、アプリのインストール権限を付与してもらってください。 権限の付与が難しい場合は、**カスタムボット** での接続を検討してください。 **「認証情報が無効です」と表示される（カスタムボット）** * Bot User OAuth Token が `xoxb-` で始まる文字列であることを確認してください * Signing Secret に余分な空白や改行が含まれていないことを確認してください * Slack App がワークスペースに正しくインストールされているか確認してください **接続済みになっているのにボットが反応しない** ボットが参加しているチャンネルでメンションしているか確認してください。 ボットを特定のチャンネルに追加するには、チャンネルで `/invite @<ボット名>` を実行します（**標準ボット** ならデフォルトは `@Admina AIヘルプデスク`、表示名を変更している場合や **カスタムボット** の場合は、ワークスペースで設定したアプリの名前を指定してください）。 ## 関連ページ * [連携（Microsoft Teams）](/ai-helpdesk/integrations/teams) * [連携（LINE WORKS）](/ai-helpdesk/integrations/line-works) * [連携（Google Chat）](/ai-helpdesk/integrations/google-chat)