添加 Slack 应用

开始之前

需同时满足以下三点。

• 你的 Search Console 资源已连接到 AutoPSEO。参见 连接 Search Console。
• 你拥有有效的订阅或试用。Slack 连接、订阅和斜杠命令均以此为前提。
• 你能够在 Slack 工作区中安装应用。部分工作区需要管理员批准新应用；若你的工作区属于这种情况，Slack 会显示申请界面，而不是授权界面。

连接工作区

1. 在 AutoPSEO 中，打开 账户 → Slack、Teams 与 Webhook。
2. 点击 添加到 Slack。随后会跳转到 Slack 的授权界面。
3. 在该界面右上角选择工作区，核对权限，然后点击 允许。
4. Slack 将你带回设置页，并显示 Slack 工作区已连接。该工作区现在会显示为 活跃，并附有日期和已授予的权限范围。

你可以连接多个工作区。使用 添加另一个工作区，并在 Slack 界面上选择不同的工作区。每条订阅只归属一个工作区。

各项权限的用途

AutoPSEO 只申请六个机器人权限范围，除此之外不再申请任何权限。它没有消息历史权限，因此无法读取你的对话。

• chat:write 将报告和提醒消息发送到你订阅的频道。
• channels:read 列出公开频道，供订阅表单选择发送目标。
• groups:read 对已邀请机器人加入的私密频道提供同样的列表。
• commands 注册并接收 /autopseo。
• files:write 在定时报告中上传趋势图。
• channels:join 让机器人加入你已选但从未邀请过它的公开频道，避免首次发送失败。该权限仅用于从这一错误中恢复，绝不会主动去加入频道。

公开频道与私密频道

订阅表单中的频道选择器会按 AutoPSEO 是否已在频道中分组。

• 公开频道 全部列出，包括机器人从未加入过的频道。首次发帖时会自动加入，因此发一条测试消息就足以让它进入。
• 私密频道 仅在你邀请机器人之后才会出现。在 Slack 中，于该频道执行 /invite @AutoPSEO，然后点击选择器旁的 重新加载。
• 重命名了频道或新建了频道？列表有缓存，请用 重新加载 重新拉取。

重新连接工作区

Slack 在安装时授予权限，不会向已有令牌追加新权限。当 AutoPSEO 开始使用一项新权限时，此前已连接的工作区仍可继续工作，只是缺少该项能力；设置页会显示 重新连接 提示，说明缺了什么。

• 缺少 files:write：定时报告以纯文本送达，不含趋势图。其余功能不受影响。
• 缺少 channels:join：机器人无法自行加入公开频道，因此你需要用 /invite @AutoPSEO 邀请它。

重新连接只需对同一工作区再次执行 添加到 Slack。订阅、计划和设置均保持不变。

断开连接与移除

连接有两端，任意一端都可以终止。

• 从 AutoPSEO： 工作区旁的垃圾桶图标会撤销其机器人令牌，并删除该工作区的订阅。其他工作区不受影响。
• 从 Slack： 在工作区的应用设置中移除该应用会使令牌失效。AutoPSEO 会在下次发送时发现，将工作区标记为 连接已断开，并暂停其订阅而不是删除，因此重新连接后订阅会恢复。

消息未送达时

测试按钮会报告 Slack 给出的原因，设置页会将其转成可读说明。

• AutoPSEO 尚未加入该频道。 使用 /invite @AutoPSEO 邀请它，或重新连接工作区，使其能够自行加入公开频道。
• 该频道已不存在，或已被归档。 在订阅中另选一个频道。
• 连接已失效。 令牌已被撤销或过期：请重新连接工作区。
• Slack 正在对我们限流。 这是暂时的，下一次运行会重试。
• 连续失败会自动停用订阅，原因显示在该行。排除原因后，用电源图标重新打开。

本文是 Slack、Teams 与 Webhook 的一部分。相关文档：定时报告、提醒、在 Slack 中使用。