Slack调用手册

向测试频道发送机器人消息

用 Bot Token 调用 chat.postMessage,保存频道 ID 与消息 ts 供后续线程回复或状态更新。

官方资料核对 2026-10-15示例代码,未进行真实接口实测
← 返回平台功能

接入准备

  • 创建并安装 Slack App,Bot Token Scopes 至少为 chat:write。
  • 把机器人加入自己的测试频道;本例不申请 chat:write.public,也不冒充其他用户。

准备环境变量

示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行;密钥不应放进公开网页。

SLACK_BOT_TOKEN
OAuth & Permissions 中已安装应用的 Bot User OAuth Token,保存在本机或服务端。
终端
export SLACK_BOT_TOKEN='xoxb_replace_with_your_bot_token'

以上 export 适用于 macOS / Linux 的终端。按调用步骤保存代码文件,再在同一终端执行。

调用步骤

  1. 01

    在 api.slack.com/apps 创建 App,选开发工作区,进入 OAuth & Permissions 添加 chat:write。

  2. 02

    点击 Install to Workspace 并完成同意或管理员审批,把 Bot User OAuth Token 设置为 SLACK_BOT_TOKEN。

  3. 03

    在 Slack 测试频道中添加此应用,从频道详情复制频道 ID;将下面 JSON 中 channel 的虚构值直接改成自己的频道 ID。

  4. 04

    运行单次请求,检查 JSON 的 ok 是否为 true,保存 channel 和 ts;本操作会真的发出消息。

调用 01

发送一条文字通知

最小 JSON 请求使用实际频道 ID;请求体中的示例字面量不会从环境变量自动替换。

POSThttps://slack.com/api/chat.postMessage

请求头

Authorization
Bearer ${SLACK_BOT_TOKEN}
Content-Type
application/json; charset=utf-8

参数说明

参数表可左右滑动,查看完整说明。

字段 / 位置类型 / 必填说明
channel请求体string必填目标会话 ID。本例 C0123456789 为虚构值,必须在 JSON 中替换;机器人需已加入该频道。
text请求体string必填本例文字正文。若使用 blocks,建议仍提供可访问的文本后备内容。
unfurl_links / unfurl_media请求体boolean可选示例均为 false,避免自动展开链接和媒体预览。
thread_ts请求体string可选添加时填写父消息 ts,表示线程回复;当前最小示例未设置。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误,业务状态还需按下方返回示例核对。

cURL
cat > request-body.json <<'JSON'
{
  "channel": "C0123456789",
  "text": "接入测试:这是一条来自测试应用的通知。",
  "unfurl_links": false,
  "unfurl_media": false
}
JSON

# 执行后核对返回 JSON 的业务状态;HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://slack.com/api/chat.postMessage" \
  --header "Authorization: Bearer ${SLACK_BOT_TOKEN}" \
  --header "Content-Type: application/json; charset=utf-8" \
  --data-binary @request-body.json
Python 3
import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://slack.com/api/chat.postMessage")
headers = {
    "Authorization": expand("Bearer ${SLACK_BOT_TOKEN}"),
    "Content-Type": expand("application/json; charset=utf-8"),
}
body = {
    "channel": "C0123456789",
    "text": "接入测试:这是一条来自测试应用的通知。",
    "unfurl_links": False,
    "unfurl_media": False,
}
data = json.dumps(body, ensure_ascii=False).encode("utf-8")
request = urllib.request.Request(url, data=data, headers=headers, method="POST")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
if isinstance(result, dict) and "ok" in result and result["ok"] != True:
    raise SystemExit("平台返回业务错误,请结合下方排错说明检查响应")
Node.js
// Node.js 22+,保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://slack.com/api/chat.postMessage");
const headers = Object.fromEntries(
  Object.entries({
  "Authorization": "Bearer ${SLACK_BOT_TOKEN}",
  "Content-Type": "application/json; charset=utf-8"
}).map(([key, value]) => [key, expand(value)])
);
const body = {
  "channel": "C0123456789",
  "text": "接入测试:这是一条来自测试应用的通知。",
  "unfurl_links": false,
  "unfurl_media": false
};
const response = await fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));
if (Object.hasOwn(result, "ok") && result["ok"] !== true) {
  throw new Error('平台返回业务错误,请结合下方排错说明检查响应');
}

返回示例

官方字段的节选结构示意,频道 ID、时间戳和正文均为虚构。成功业务状态为 ok:true;ts 应保留为字符串。 以下为结构示意,非本站实测结果。

JSON
{
  "ok": true,
  "channel": "C0123456789",
  "ts": "1735689600.000001",
  "message": {
    "type": "message",
    "text": "接入测试:这是一条来自测试应用的通知。",
    "ts": "1735689600.000001"
  }
}

常见错误与排查

invalid_auth / token_revoked令牌失效或已撤销。
核对应用所在工作区和 token 状态;必要时重新安装授权,不要把 Signing Secret 当 Bot Token。
missing_scope令牌没有方法所需权限。
在 OAuth & Permissions 增加本场景 scope 并重新安装授权,不能只修改后台配置后继续用旧权限。
HTTP 429 / ratelimited方法调用触发限流。
遵守 Retry-After 响应头暂停,再按方法和工作区排队;不要立即循环重试。
channel_not_found / not_in_channel / no_permission目标频道无效或应用不能发帖。
检查 ID、工作区和成员身份,邀请机器人加入;私有频道需要明确邀请,勿盲目扩大权限。

调用注意

  • HTTP 成功不等于业务成功,必须检查 ok 与 error;通用示例会打印完整返回,需按这里检查。
  • 通常每频道每秒约 1 条,另有工作区级限制;超时后不要直接重发,以免重复通知。

注意事项

  • 示例会真实写入工作区并可能通知频道成员,请在自己控制的测试频道运行。
  • 基础 Web API 方法没有列统一按次单价;工作区套餐和自身后端费用另算。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码,覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

  1. 01
    创建 Slack App核验日期 2026-10-15
  2. 02
    OAuth 安装与权限核验日期 2026-10-15
  3. 03
  4. 04

Slack的其他调用手册

← 返回Slack的全部功能