Slack セットアップ

Slack Bot セットアップガイド¶

MarionetteとSlackを連携するには、Slack APIでアプリを作成し、Bot Token・App Token・Signing Secretを取得する必要があります。
このページでは、その手順を最初から説明します。

1. Slack API にアクセス¶

Slack API アプリ管理ページ にアクセスし、Slackアカウントでログインしてください。

2. アプリを作成¶

1. 「Create New App」 をクリック
2. 「From scratch」 を選択
3. アプリ名（例: Marionette Bot）とワークスペースを選択
4. 「Create App」 をクリック

3. Bot Token (xoxb-) を取得¶

1. 左メニューの 「OAuth & Permissions」 をクリック
2. Bot Token Scopes に以下のスコープを追加:
   • app_mentions:read - メンションの受信
   • channels:history - パブリックチャンネルのメッセージ履歴
   • channels:read - チャンネル一覧
   • chat:write - メッセージ送信
   • groups:history - プライベートチャンネルの履歴
   • groups:read - プライベートチャンネル一覧
   • im:history - DM履歴
   • im:read - DM一覧
   • im:write - DM送信
   • mpim:history - グループDM履歴
   • mpim:read - グループDM一覧
   • users:read - ユーザー情報
3. ページ上部の 「Install to Workspace」 をクリック
4. 権限を確認し 「許可する」 をクリック
5. Bot User OAuth Token (xoxb- で始まる) をコピー

4. App-Level Token (xapp-) を取得¶

Marionetteは Socket Mode を使用するため、App-Level Tokenが必要です。

1. 左メニューの 「Basic Information」 をクリック
2. 「App-Level Tokens」 セクションまでスクロール
3. 「Generate Token and Scopes」 をクリック
4. トークン名（例: socket-mode）を入力
5. スコープに connections:write を追加
6. 「Generate」 をクリック
7. 表示された App-Level Token (xapp- で始まる) をコピー

5. Signing Secret を取得¶

1. 左メニューの 「Basic Information」 をクリック
2. 「App Credentials」 セクションの Signing Secret の 「Show」 をクリック
3. 表示された値をコピー

6. Marionette に設定を入力¶

管理画面の左メニュー 「外部連携」→「Bot管理」 を開き、Slackを選択します。

接続設定¶

入力後、「設定保存」 をクリックしてから 「接続」 ボタンを押してください。
ステータスが「接続中」に変われば成功です。

7. 動作確認¶

1. Slack ワークスペースのチャンネルで Bot をメンション
2. Bot が応答すれば成功

参考リンク¶

• Slack API アプリ管理
• Slack トークンの種類
• Socket Mode ドキュメント