开放能力导航
首页/消息与机器人/Slack
消息与机器人 / Slack Web API & Events API

Slack

Slack App 可发送频道或私信消息、读取授权会话历史、订阅事件并处理按钮与弹窗交互，适合通知机器人、工单和团队协作集成。每个工作区分别安装授权；应用安装、会话成员身份与权限范围共同决定能看到什么。

团队机器人频道消息会话历史事件订阅Block KitOAuth
01 / CAPABILITIES

开放功能

核心接口调用手册

2 个场景

覆盖机器人发送消息和读取频道历史两种核心调用，包含 scope、频道成员范围、业务错误与当前商业分发限流。使用已安装应用的 Bot Token；OAuth 回调服务和线程完整同步未在本组代码中实现。

向测试频道发送机器人消息分页读取授权频道的消息历史

频道通知与机器人消息

向可访问的频道或私信发送文字和 Block Kit 消息，使用父消息 ts 发送线程回复，可用于告警、进度和工单通知。

接入要求chat.postMessage 需 chat:write；机器人通常先加入频道。向未加入的公开频道发帖还需 chat:write.public，私有频道必须具有相应访问资格。
向测试频道发送机器人消息站内调用手册 · 参数、代码与排错
chat.postMessage 方法、权限与发送限制OAuth 安装与权限

会话历史与消息同步

读取授权会话的消息与事件，使用 cursor 翻页或时间边界增量读取；线程回复另走 conversations.replies。

接入要求公开频道用 channels:history，私有频道 groups:history，私信 im:history，群私信 mpim:history；Bot 仅可读其加入的会话。分发类型影响历史读取限流。
分页读取授权频道的消息历史站内调用手册 · 参数、代码与排错
conversations.history 读取范围、分页与分发限流Web API 限流与新商业分发条件

消息与工作区事件推送

按事件类型订阅新消息、提及和成员变化，让 Slack 把授权范围内事件推送给自己的应用。

接入要求在 App 中启用 Events API，配置订阅及所需 scopes；HTTP 接收端处理 URL 校验、及时确认与去重，并用 Signing Secret 验签。
Events API 事件订阅与接收校验 Slack 请求签名

按钮、快捷操作与弹窗

接收 Block Kit 按钮、快捷入口和表单提交，结合自己的后端实现状态更新或审批式交互。

接入要求启用 Interactivity & Shortcuts 并配置 Request URL；按 payload 类型解析，及时确认，交互回调不能替代调用 Web API 所需的 OAuth scopes。
按钮、快捷操作和弹窗交互校验 Slack 请求签名
02 / REQUIREMENTS

接入条件

适用主体
通知与运维工具开发者、团队内部工具开发者、面向多个工作区的 SaaS 团队
接入方式
安装应用取得 Bot User OAuth Token（常见 xoxb 前缀） / OAuth v2 为各工作区签发安装令牌，可按需申请用户权限 / 接收事件或交互回调时，用 Signing Secret 验证签名
申请概况
需要 Slack 工作区和可安装应用的权限；内部应用可直接安装，面向其他工作区分发需 OAuth 与相应分发配置。
  • 准备有权安装应用的工作区，在 Slack App 管理后台创建 App 并选择开发工作区；组织启用审批时先走管理员审批。
  • 在 OAuth & Permissions 按功能添加 Bot Token Scopes，安装后保存 Bot User OAuth Token；新增 scope 后重新安装或授权。
  • 以会话 ID 作为目标；Bot 加入相应频道，读取权限与发送权限分开配置，chat:write 不包含历史读取。
  • 服务多个工作区时实现 OAuth v2 安装、回调与 token 存储，按安装的 workspace/team 保存凭证，不能把一个工作区令牌当通用凭证。
  • 需要事件或按钮回调时准备接收服务，验签、去重并快速返回确认；不要仅凭 payload 中的旧 token 字段判断回调可信。
创建 Slack AppOAuth 安装与权限chat.postMessage 方法、权限与发送限制conversations.history 读取范围、分页与分发限流按钮、快捷操作和弹窗交互校验 Slack 请求签名
03 / GET STARTED

开通步骤

  1. 01

    创建应用并选工作区

    先在自己可控制的开发工作区建立 App，确定仅内部使用还是需要商业分发。

  2. 02

    设置最小权限并安装

    按读写场景分别添加 scope，完成安装和管理员审批后保存令牌。

  3. 03

    在测试频道验证调用

    把机器人加入测试频道，从单次发送或少量历史读取开始，检查 ok、error 与分页。

  4. 04

    接好事件和限流处理

    为事件与交互配置接收端、签名校验和去重；按应用分发类别安排读取频率。

04 / COSTS & LIMITS

费用、边界与测试方式

费用概况

按工作区套餐与接入范围评估成本；API 的速率限制不是购买来的调用次数。

  • 本条目所列 Web API 方法页未列统一按请求收费；可在免费工作区开发安装应用，但免费版最多安装 10 个第三方或自建应用。
  • 免费工作区只可访问最近 90 天消息与文件历史，超过 1 年的数据会被删除；需要更长可见历史或更多安装时，需评估工作区付费套餐。
  • 付费工作区按用户、账单周期和地区计费；月付、年付和促销价格不同，实际席位费用以官方购买页为准。
  • 外部应用自身收费、自建后端运行和数据存储另外核算。升级工作区套餐不等于取消 Web API 方法限流，也不替代 Marketplace 的分发规则。
chat.postMessage 方法、权限与发送限制conversations.history 读取范围、分页与分发限流Slack 工作区套餐免费版历史记录与应用安装限制Web API 限流与新商业分发条件

使用范围与限制

  • Bot Token 不能读取自己未加入的所有频道，也不能凭发送权限获取整个工作区历史。
  • 自 2025 年 5 月 29 日起，商业分发且未经 Slack Marketplace 批准的新应用及新安装，其 conversations.history/replies 限为每分钟 1 次，limit 默认及最大为 15。Marketplace 已批准应用和客户自建内部应用仍按 Tier 3；当前文档说明既有安装不受这项新限流影响。
  • chat.postMessage 通常每频道每秒约 1 条，并另有工作区级限制；以 HTTP 429 和 Retry-After 为重试依据。
  • HTTP 200 仍可能返回 ok:false；业务错误、token 撤销、缺少 scope 和访问限制需要分别处理。
  • 应用读取仍受工作区套餐、历史可见范围、保留政策和成员权限约束；API 不会恢复已删除或无权访问的内容。

如何进行开发测试

  • 使用自己的开发工作区和测试频道；消息发送会成为实际工作区内容，可能产生通知。
  • App 安装和 OAuth 连接的是实际工作区，没有把此处开发工作区描述为统一隔离的 API 沙箱。
  • 本次未创建 App、安装机器人、读取消息或发送任何真实消息。

接入前再确认

  • 按当前 docs.slack.dev 限流说明整理，未把旧版 api.slack.com 的历史迁移日期当作当前规则。
  • 未登录开发后台，未验证具体工作区的安装审批、历史保留或付费资格。
05 / OFFICIAL SOURCES

官方资料

以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。

  1. 01
    创建 Slack App已核对官方资料 · 2026-10-15
  2. 02
    OAuth 安装与权限已核对官方资料 · 2026-10-15
  3. 03
    chat.postMessage 方法、权限与发送限制已核对官方资料 · 2026-10-15
  4. 04
  5. 05
    Events API 事件订阅与接收已核对官方资料 · 2026-10-15
  6. 06
    按钮、快捷操作和弹窗交互已核对官方资料 · 2026-10-15
  7. 07
    校验 Slack 请求签名已核对官方资料 · 2026-10-15
  8. 08
    Web API 限流与新商业分发条件已核对官方资料 · 2026-10-15
  9. 09
    Slack 工作区套餐已核对官方资料 · 2026-10-15
  10. 10
    免费版历史记录与应用安装限制已核对官方资料 · 2026-10-15
  11. 11
    Slack App 管理后台官方入口 · 细则待复核 · 2026-10-15
官方文档核对，未进行接口实测
最近核验 2026-10-15 · 查看核验说明

其他平台

全部平台
Telegram 机器人消息与机器人Discord 开发者平台消息与机器人飞书办公协作