docs/zh/platform/slack.md

# 接入 Slack

## 创建 AstrBot Slack 平台适配器

进入 `机器人` 页，点击 `+ 创建机器人`，找到 Slack 并点击进入 Slack 配置页。

![image](https://files.astrbot.app/docs/source/images/slack/image-1.png)

在弹出的配置对话框中点击 `启用`。

## 在 Slack 创建 App

Slack 支持两种接入方式：`Webhook` 与 `Socket`。如果您没有公网服务器并且消息业务量的规模较小，我们建议您使用 `socket` 方式。如果您有公网服务器（或者有一定的技术背景，了解如何设置 Tunnel，如 Cloudflare Tunnel），可以选择 `webhook` 方式。`socket` 方式部署相对简单。

1. 创建 [Slack](https://slack.com/signin) 账号和一个工作区（Workspace）。
2. 前往 [应用后台](https://api.slack.com/apps)，点击「Create New App」->「From Scratch」，输入 `应用名称` 和要添加到的工作区，然后点击「Create App」。  
3. （仅 Webhook 需要）获取 `Signing Secret`，在左边栏 Basic Information 页下，找到 App Credentials 的 `Signing Secret`，点击 Show 并且复制到平台适配器配置的 signing_secret 处。

![image](https://files.astrbot.app/docs/source/images/slack/image.png)

4. 在左边栏 Basic Information 页下，找到 App-Level Tokens，点击 「Generate Token and Scopes」。Token Name 任意输入，点击 Add Scope，选择 `connections:write`，然后点击 「Generate」，点击 Copy 将结果复制到 AstrBot 配置页的 app_token 处。

![image](https://files.astrbot.app/docs/source/images/slack/image-2.png)

5. 在左边栏 OAuth & Permissions 页下，在 Bot Token Scopes 下方添加如下权限：
   - channels:history
   - channels:read
   - channels:write.invites
   - chat:write
   - chat:write.customize
   - chat:write.public
   - files:read
   - files:write
   - groups:history
   - groups:read
   - groups:write
   - im:history
   - im:read
   - im:write
   - reactions:read
   - reactions:write
   - users:read

6. 在左边栏 OAuth & Permissions 页下，在 Oauth Token 处点击 `Install to xxx`（xxx 是您工作区的名字）。然后复制生成的 Bot User OAuth Token 到平台适配器配置的 bot_token 处。

7. （仅 Socket 需要）在左边栏 Socket Mode 页下，开启 Enable Socket Mode。

![image](https://files.astrbot.app/docs/source/images/slack/image-3.png)

## 启动平台适配器

现在，配置已经完成。如果您使用的是 Socket 模式，那么直接点击配置的右下角的保存按钮即可。

如果您使用的是 Webhook 模式，请保持 `统一 Webhook 模式 (unified_webhook_mode)` 为开启状态。

> [!TIP]
> v4.8.0 之前没有 `统一 Webhook 模式`，请填写以下配置项：
> Slack Webhook Host、Slack Webhook Port 和 Slack Webhook Path

## 开启事件接收

新建平台适配器成功后，返回到 Slack 设置，在左边栏 Event Subscriptions 页下，点击 Enable Events 启用事件接收。

如果您使用的是 Webhook 模式：

- 如果开启了 `统一 Webhook 模式`，点击保存之后，AstrBot 将会自动为你生成唯一的 Webhook 回调链接，你可以在日志中或者 WebUI 的机器人页的卡片上找到，将该链接填入 `Request URL` 输入框中。

![unified_webhook](https://files.astrbot.app/docs/source/images/use/unified-webhook.png)

- 如果没有开启 `统一 Webhook 模式`，请在 `Request URL` 输入框中输入 `https://您的域名/astrbot-slack-webhook/callback`。

> [!TIP]
> Webhook 模式下，您需要先在 DNS 服务商处设置好域名，然后使用反向代理软件将请求转发到 AstrBot 所在服务器的 `7860` 端口（如果开启了统一 Webhook 模式）或配置指定的端口（如果没有开启统一 Webhook 模式）。或者您可以使用 Cloudflare Tunnel。具体教程请参考网络资源，本教程不赘述。

启用后，在下方的 Subscribe to bot events 处，点击 Add Bot User Event，添加如下事件：

1. channel_created
2. channel_deleted
3. channel_left
4. member_joined_channel
5. member_left_channel
6. message.channels
7. message.groups
8. message.im
9. reaction_added
10. reaction_removed
11. team_join

## 测试成功性

进入您刚刚添加的 Slack 工作区，进入需要用到 Bot 的频道，然后 @ 您刚刚创建的应用。然后点击 Slackbot 随后发送的消息中的 添加 按钮来添加到工作区中。然后，@ 应用，输入 `/help`，如果能够成功回复，说明测试成功。

如果有疑问，请[提交 Issue](https://github.com/AstrBotDevs/AstrBot/issues)。