# Slack 机器人使用传入 Webhooks 或 Slack Web API 将消息和丰富内容发送到 Slack 通道。使用 Block Kit 构建格式化公告、营销报告、指标仪表板和社区更新。 ## 先决条件需要在“.env”、“.env.local”或“~/.claude/.env.global”中设置“SLACK_WEBHOOK_URL”或“SLACK_BOT_TOKEN”。源 ~/.claude/.env.global 2>/dev/null 源 .env 2>/dev/null 源.env.local 2>/dev/null 如果[-n“$SLACK_WEBHOOK_URL”];然后 echo "SLACK_WEBHOOK_URL 已设置。Webhook 模式可用。" elif [ -n "$SLACK_BOT_TOKEN" ];然后 echo "SLACK_BOT_TOKEN 已设置。Web API 模式可用。" 否则 echo "SLACK_WEBHOOK_URL 和 SLACK_BOT_TOKEN 均未设置。" echo "请参阅下面的设置指南来配置 Slack 凭据。" 菲如果这两个变量均未设置，请指示用户遵循下面的“设置指南”部分。 ** ** ## 设置指南 ### 选项 A：传入 Webhook（简单）传入 Webhook 是发布消息的最快方式。它们不需要 OAuth 范围，并且范围仅限于单个通道。 1. 转到并单击 **创建新应用程序** > **从头开始**。 2. 为应用程序命名（例如“营销机器人”）并选择您的工作区。 3. 在左侧边栏中，单击 **Incoming Webhooks** 并将其切换为 **On**。 4. 单击底部的“**将新 Webhook 添加到工作区**”。 5. 选择要发布的频道并单击“**允许**”。 6. 复制 Webhook URL（以“https://hooks.slack.com/services/...”开头）。 7. 将其添加到您的环境中： echo 'SLACK_WEBHOOK_URL=https://hooks.slack.com/services/T.../B.../xxxx' >> .env **限制：** 每个通道一个 Webhook。无法以编程方式读取消息、列出频道或回复线程（您必须从之前的 API 响应中知道“thread_ts”）。 ### 选项 B：机器人代币（全功能）机器人令牌可以访问完整的 Slack Web API：发布到机器人所在的任何频道、回复线程、列出频道、上传文件等等。 1. 转到并单击 **创建新应用程序** > **从头开始**。 2. 为应用程序命名并选择您的工作区。 3. 在左侧边栏中，单击 **OAuth 和权限**。 4. 在 **Bot Token Scopes** 下，添加以下范围： * `chat:write` \- 发布消息 * `chat:write.public` \- 发布到频道而不加入 * `channels:read` \- 列出公共频道 * `files:write` \- 上传文件（可选，用于图像/报告） * `reactions:write` \- 添加表情符号反应（可选） 5. 点击顶部的**安装到工作区**并授权。 6. 复制 **机器人用户 OAuth 令牌**（以“xoxb-”开头）。 7. 将其添加到您的环境中： echo 'SLACK_BOT_TOKEN=xoxb-your-token-here' >> .env 8. 邀请机器人加入其应发布内容的频道：在每个频道中输入“/invite @YourBotName”。 **可选：** 设置默认频道以方便使用： echo 'SLACK_DEFAULT_CHANNEL=#marketing' >> .env ** ** ## 方法 1：传入 Webhook ### 发送简单的短信卷曲-s -X POST“$SLACK_WEBHOOK_URL”\ -H“内容类型：application/json”\ -d'{ "text": "来自营销机器人的您好！" }' ### 发送带有用户名和图标覆盖的消息卷曲-s -X POST“$SLACK_WEBHOOK_URL”\ -H“内容类型：application/json”\ -d'{ "text": "新博文发布！", “用户名”：“营销机器人”， "icon_emoji": ":mega:" }' ### 使用 Block Kit (Webhook) 发送消息卷曲-s -X POST“$SLACK_WEBHOOK_URL”\ -H“内容类型：application/json”\ -d'{ “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": "新品发布会" } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*产品 X* 现已上线！查看公告。" } }, { “类型”：“分隔符” }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "阅读我们博客上的完整公告。" }, “配件”：{ “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， “文本”：“阅读更多” }, “url”：“https://example.com/blog/launch” } } ] }' ** ** ## 方法 2：Slack Web API（机器人令牌） Web API 提供对消息传递、线程、通道管理等的完全控制。 ### API 基础所有请求都会发送到“https://slack.com/api/”，并带有标题“Authorization: Bearer {SLACK_BOT_TOKEN}”。 ### 将消息发布到频道卷曲-s -X POST“https://slack.com/api/chat.postMessage”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d'{ “渠道”：“#营销”， "text": "每周指标报告已准备就绪！", “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": "每周营销指标" } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "这是本周的数字。" } } ] }' 响应包括标识消息的“ts”（时间戳）字段。保存该值用于线程回复： # 发布并捕获线程的消息时间戳 RESPONSE=$(curl -s -X POST "https://slack.com/api/chat.postMessage" \ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d'{ “渠道”：“#营销”， "text": "线程父消息" }') MESSAGE_TS=$(echo "$RESPONSE" | python3 -c "导入 json,sys; print(json.load(sys.stdin).get('ts',''))") echo "消息时间戳: $MESSAGE_TS" ### 回复主题使用“thread_ts”参数在现有线程内进行回复：卷曲-s -X POST“https://slack.com/api/chat.postMessage”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d“{ \“渠道\”：\“#营销\”， \"thread_ts\": \"${MESSAGE_TS}\", \"text\": \"这是带有附加详细信息的线索回复。\" }” 要同时广播对频道的回复（因此它也出现在主对话中），请添加 `"reply_broadcast": true`。 ### 更新现有消息卷曲-s -X POST“https://slack.com/api/chat.update”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d“{ \“渠道\”：\“#营销\”， \"ts\": \"${MESSAGE_TS}\", \"text\": \"更新消息内容。\", \“块\”：[] }” ### 删除消息卷曲-s -X POST“https://slack.com/api/chat.delete”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d“{ \“渠道\”：\“#营销\”， \"ts\": \"${MESSAGE_TS}\" }” ### 列出公共频道对于发现要发布到哪个频道很有用：卷曲-s“https://slack.com/api/conversations.list?types=public_channel&limit=100”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" | \ python3-c“ 导入 json、系统数据 = json.load(sys.stdin) 对于 data.get('channels', []) 中的 ch：成员 = ch.get('num_members', 0) print(f\"#{ch['name']} | 成员: {members} | ID: {ch['id']}\") ” ### 将文件上传到频道卷曲-s -X POST“https://slack.com/api/files.uploadV2”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -F“文件=@report.pdf”\ -F“文件名=每周报告.pdf”\ -F“channel_id=C0123456789”\ -F "initial_comment=这是本周的营销报告。" ### 添加表情符号反应卷曲-s -X POST“https://slack.com/api/reactions.add”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d“{ \"频道\": \"C0123456789\", \"时间戳\": \"${MESSAGE_TS}\", \“名称\”：\“white_check_mark \” }” ** ** ## Slack Block 套件参考 Block Kit 是 Slack 的 UI 框架，用于构建丰富的交互式消息。消息由一系列块组成，每个块都有特定的类型和结构。 ### 块类型块型 |目的|支持mrkdwn ---|---|--- `标题` |大粗体标题文本 |否（仅限纯文本） `部分` |带有文本和可选附件的主要内容块 |是的 `分隔线` |水平线分隔符|不适用 `图像` |带替代文本的全角图像 |不适用 `上下文` |小而静音的文本和图像（用于元数据、时间戳）|是的 `行动` |交互元素行（按钮、选择、日期选择器）|不适用 `丰富的文本` |高级格式化文本（列表、引号、代码块）|不适用 ### 标题块 { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": "每周营销报告", “表情符号”：正确 } } ### 节块纯文本部分： { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*与上周相比，本周流量增长了 23%*。\n自然搜索推动了大部分增长。" } } 包含字段的部分（两列布局）： { “类型”：“部分”， “字段”：[ { “类型”：“mrkdwn”， "text": "*访客*\n12,450" }, { “类型”：“mrkdwn”， "text": "*注册*\n342" }, { “类型”：“mrkdwn”， "text": "*MRR*\n$28,500" }, { “类型”：“mrkdwn”， "text": "*流失*\n1.2%" } ] } 带按钮配件的部分： { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "新博文：*我们如何在 6 个月内成长 10 倍*" }, “配件”：{ “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": "阅读帖子" }, “url”：“https://example.com/blog/growth-story”， “action_id”：“read_blog_post” } } 带有图像附件的部分： { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*新功能：深色模式*\n我们最需要的功能终于来了。" }, “配件”：{ “类型”：“图像”， "image_url": "https://example.com/images/dark-mode-preview.png", "alt_text": "深色模式预览" } } ### 分隔块 { “类型”：“分隔符” } ### 图像块 { “类型”：“图像”， "image_url": "https://example.com/images/chart.png", "alt_text": "每周流量图", “标题”：{ “类型”：“纯文本”， "text": "流量概览" } } ### 上下文块 { “类型”：“上下文”， “元素”：[ { “类型”：“mrkdwn”， "text": "发布者：*营销团队* | 2026 年 2 月 10 日" }, { “类型”：“图像”， "image_url": "https://example.com/logo-small.png", "alt_text": "公司标志" } ] } ### 操作块（按钮） { “类型”：“动作”， “元素”：[ { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， “文本”：“批准” }, “风格”：“主要”， "action_id": "approve_action", “值”：“已批准” }, { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， “文本”：“拒绝” }, “风格”：“危险”， "action_id": "拒绝_action", “价值”：“拒绝” }, { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": "查看详情" }, "url": "https://example.com/details", “action_id”：“查看详细信息” } ] } 按钮样式：“主要”（绿色）、“危险”（红色）或默认省略（灰色）。 **关于交互性的注意事项：** 具有“action_id”（无“url”）的按钮需要在“交互性和快捷方式”下的 Slack 应用程序设置中配置请求 URL，以接收按钮点击负载。带有“url”字段的按钮直接打开链接，不需要后端。 ### 块套件限制限制|价值 ---|--- 每条消息的块数 | 50 每个文本块的字符数 | 3,000 每个标题的字符数 | 150 每个部分的字段 | 10 每个操作块的元素 | 25 每个上下文块的元素 | 10 ### 块套件生成器在编码之前使用可视化构建器来设计和预览消息： ** ** ## Slack mrkdwn 格式化指南 Slack 使用自己的 markdown 变体，称为 mrkdwn。它在几个方面与标准 Markdown 不同。格式化|语法 |示例 ---|---|--- 大胆| `*文本*` | _粗体文字_ 斜体 | `_文本_` | _斜体文本_ 删除线 | `~文本~` | ~~删除线~~ 代码（内联）| ``文本`` | `内联代码` 代码块 | ````文本```` |多行代码块块引用 | `>文本` |引用文字链接 | `` |可点击的链接用户提及| `<@U0123456>` | @用户名频道提及 | `<#C0123456>` | #频道表情符号 | `：表情符号名称：` | ：火箭：项目符号列表 |以 `- ` 或 `* ` | 开头要点编号列表 |以“1”开始行。 ` |编号项目换行| JSON 字符串中的 `\n` |新线 **与标准 Markdown 的重要区别：** * 粗体使用单星号“*粗体*”，而不是双“**粗体**”。 * 斜体使用下划线`_italic_`，而不是单个星号。 * 链接使用带有管道的“”格式，而不是“[text](url)”。 * mrkdwn 中不存在标头。请改用“header”块类型。 * 图像无法内嵌在 mrkdwn 中。请改用“image”块或“accessory”。 ** ** ## 消息模板 ### 模板 1：产品公告卷曲-s -X POST“$SLACK_WEBHOOK_URL”\ -H“内容类型：application/json”\ -d'{ “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": ":rocket: 新功能：[功能名称]", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "我们刚刚发布*[功能名称]* - 这是它的作用及其重要性。\n\n:point_right: *它的作用:* [一句话描述]\n:point_right: *为什么它很重要:* [对用户的主要好处]\n:point_right: *如何尝试:* [快速说明或链接]" } }, { “类型”：“图像”， "image_url": "https://example.com/feature-screenshot.png", "alt_text": "功能截图" }, { “类型”：“分隔符” }, { “类型”：“动作”， “元素”：[ { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": ":报纸: 阅读公告", “表情符号”：正确 }, “url”：“https://example.com/blog/feature-launch”， "action_id": "已读公告" }, { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": ":play_or_pause_button: 观看演示", “表情符号”：正确 }, "url": "https://example.com/demo", “action_id”：“watch_demo” } ] }, { “类型”：“上下文”， “元素”：[ { “类型”：“mrkdwn”， "text": "发布者 *产品团队* | :speech_balloon: 在帖子中回复问题" } ] } ] }' ### 模板 2：每周指标报告卷曲-s -X POST“$SLACK_WEBHOOK_URL”\ -H“内容类型：application/json”\ -d'{ “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": ":bar_chart: 每周营销指标 — 2026 年 2 月 3 日至 9 日", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "这是本周的表现快照。" } }, { “类型”：“分隔符” }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": ":globe_with_meridians: *网站流量*" }, “字段”：[ { “类型”：“mrkdwn”， "text": "*会话*\n45,230 (:arrow_up: 12%)" }, { “类型”：“mrkdwn”， "text": "*独立访客*\n31,870 (:arrow_up: 8%)" }, { “类型”：“mrkdwn”， "text": "*跳出率*\n42.3% (:arrow_down: 2.1%)" }, { “类型”：“mrkdwn”， "text": "*平均会话持续时间*\n3m 42s (:arrow_up: 15s)" } ] }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": ":money_with_wings: *转化指标*" }, “字段”：[ { “类型”：“mrkdwn”， "text": "*注册*\n487 (:arrow_up: 18%)" }, { “类型”：“mrkdwn”， "text": "*试用到付费*\n12.4% (:arrow_up: 1.2%)" }, { “类型”：“mrkdwn”， "text": "*MRR*\n$52,300 (:arrow_up: $3,200)" }, { “类型”：“mrkdwn”， "text": "*流失*\n1.8% (:arrow_down: 0.3%)" } ] }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": ":email: *电子邮件性能*" }, “字段”：[ { “类型”：“mrkdwn”， "text": "*已发送电子邮件*\n12,400" }, { “类型”：“mrkdwn”， "text": "*打开率*\n34.2%" }, { “类型”：“mrkdwn”， "text": "*点击率*\n4.8%" }, { “类型”：“mrkdwn”， "text": "*取消订阅*\n23" } ] }, { “类型”：“分隔符” }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*:bulb: 要点*\n- 发布 3 篇新博客文章后，有机流量增长了 15%\n- 电子邮件欢迎序列 A/B 测试：变体 B 表现优于 22%\n- 周四的试用注册激增与 Product Hunt 功能相关" } }, { “类型”：“动作”， “元素”：[ { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": "完整仪表板", “表情符号”：正确 }, “url”：“https://analytics.example.com/dashboard”， “action_id”：“view_dashboard” } ] }, { “类型”：“上下文”， “元素”：[ { “类型”：“mrkdwn”， "text": "由营销机器人自动生成 | 数据来自 Google Analytics + Stripe" } ] } ] }' ### 模板 3：博客文章分享卷曲-s -X POST“$SLACK_WEBHOOK_URL”\ -H“内容类型：application/json”\ -d'{ “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": ":pencil: 新博客文章已发布", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "**\n\n文章内容的简短摘要 - 将其控制在 2-3 个句子内，以捕获关键值并让人们想要点击。" }, “配件”：{ “类型”：“图像”， "image_url": "https://example.com/blog/post-og-image.png", "alt_text": "博客文章封面图片" } }, { “类型”：“上下文”， “元素”：[ { “类型”：“mrkdwn”， "text": ":bust_in_silhouette: 作者：*Jane Smith* | :clock1: 6 分钟阅读 | :label: SEO，增长" } ] }, { “类型”：“分隔符” }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": ":mega: *帮助我们放大！* 在您的社交媒体上分享此帖子。以下是现成的片段：\n\n*Twitter/X:* _刚刚发布：[标题]。[帖子中的关键见解]。回复链接。_\n\n*LinkedIn：* _我们刚刚发布了关于[主题]的深入探讨。这是第一条要点：[见解]._" } }, { “类型”：“动作”， “元素”：[ { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": "阅读帖子", “表情符号”：正确 }, “风格”：“主要”， “url”：“https://example.com/blog/post-slug”， “action_id”：“已读帖子” }, { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": "在 Twitter 上分享", “表情符号”：正确 }, "url": "https://twitter.com/intent/tweet?text=Check%20out%20this%20post&url=https://example.com/blog/post-slug", “action_id”：“分享推特” }, { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": "在 LinkedIn 上分享", “表情符号”：正确 }, "url": "https://www.linkedin.com/sharing/share-offsite/?url=https://example.com/blog/post-slug", “action_id”：“share_linkedin” } ] } ] }' ### 模板 4：团队更新/站立卷曲-s -X POST“$SLACK_WEBHOOK_URL”\ -H“内容类型：application/json”\ -d'{ “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": ":clipboard: 营销团队更新 — 2 月 10 日星期一", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*:white_check_mark: 上周完成*\n- 启动了电子邮件欢迎序列 v2\n- 发布了 3 篇博文（SEO、产品、案例研究）\n- 设置 Google Ads 再营销广告系列\n- 已发送着陆页 A/B 测试（版本 B 已上线）" } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*:施工：进行中*\n- 3 月份的内容日历（完成 70%）\n- 竞争对手分析报告（周三到期）\n- 推出 Product Hunt 的社交媒体活动" } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*:dart：本周的优先事项*\n1. 完成 Product Hunt 启动资产\n2. 发送每周简讯（周四上午 9 点）\n3. 审核并批准第一季度广告支出预算\n4. 加入新的内容编写者" } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*:警告：拦截器*\n- 等待设计团队获取 Product Hunt 画廊图像\n- 在发布之前需要对新案例研究进行法律审查" } }, { “类型”：“分隔符” }, { “类型”：“上下文”， “元素”：[ { “类型”：“mrkdwn”， "text": ":speech_balloon: 在帖子中回复您自己的更新或问题" } ] } ] }' ### 模板 5：事件/紧急通知卷曲-s -X POST“$SLACK_WEBHOOK_URL”\ -H“内容类型：application/json”\ -d'{ “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": ":rotating_light: 营销警报", “表情符号”：正确 } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*问题:* [问题的简要描述]\n*影响:* [受影响的人员/内容]\n*状态:* :red_circle: 活动\n*所有者:* <@U0123456>" } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*详细信息:*\n[更长的解释。发生了什么，何时开始，到目前为止我们所知道的。]" } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "*后续步骤:*\n1.[操作项 1]\n2.[操作项 2]\n3.[操作项 3]" } }, { “类型”：“动作”， “元素”：[ { “类型”：“按钮”， “文本”：{ “类型”：“纯文本”， "text": "状态页" }, "url": "https://status.example.com", “action_id”：“status_page” } ] } ] }' ** ** ## 工作流程 ### 工作流程 1：发布营销公告当用户要求向 Slack 发布公告、产品更新或新闻时： 1. **收集详细信息** \- 询问公告标题、正文、链接、图像 URL 和目标频道。 2. **选择模板** \- 从上面的模板中选择或构建自定义 Block Kit 有效负载。 3. **构建有效负载** \- 使用正确的 mrkdwn 格式构建 JSON。 4. **预览** \- 向用户显示完整的 JSON 负载并描述它将如何呈现。 5. **确认** \- 发送前要求用户批准。 6. **发送** \- 执行curl命令。 7. **报告** \- 显示 API 响应。对于 Web API，捕获用于线程的“ts”。 ### 工作流程 2：发布每周指标当用户要求将指标报告或仪表板发送到 Slack 时： 1. **收集指标** \- 询问数据或帮助从分析工具中提取数据。 2. **带字段的格式** \- 将带有“字段”的节块用于两列度量布局。 3. **添加上下文** \- 包括与箭头表情符号的每周比较。 4. **添加要点** \- 在一个部分中总结 2-3 个关键见解。 5. **包含仪表板链接** \- 将按钮添加到完整分析仪表板。 6. **发送并讨论** \- 发布主要报告，然后将详细的细分作为回复。 ### 工作流程 3：分享博客文章当需要向团队分发新博客文章时： 1. **获取 URL** \- 请求博客文章 URL，或从博客获取最新内容。 2. **提取元数据** \- 使用 WebFetch 提取标题、描述、作者和 OG 图像。 3. **构建分享消息** \- 使用模板 3 和社交放大片段。 4. **添加分享按钮** \- 包括用帖子预先填充的 Twitter 和 LinkedIn 意图 URL。 5. **发布到频道** \- 发送到团队营销频道。 ### 工作流程 4：社区参与用于管理 Slack 社区渠道（公共社区、客户渠道）： 1. **欢迎消息** \- 当新成员加入时发布包含规则和资源的欢迎消息。 2. **预定更新** \- 每周发布热门讨论或新资源的综述。 3. **活动公告** \- 使用 RSVP 按钮分享即将举行的网络研讨会、AMA 或聚会。 4. **投票和反馈** \- 使用带有按钮的操作块来收集快速反馈。 5. **线程管理** \- 通过更新或答案回复现有线程。 ** ** ## 发送带有动态内容的消息 ### 使用 Shell 变量构建有效负载 TITLE="产品 X v2.0 已发布" 描述：“2.0 版包括暗模式、API 改进和 3 倍更快的性能。” LINK =“https://example.com/changelog/v2” IMAGE_URL="https://example.com/images/v2-banner.png" 频道=“#公告” 卷曲-s -X POST“https://slack.com/api/chat.postMessage”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d“$(python3-c” 导入 json 有效负载={ '频道': '${CHANNEL}', '文本': '${TITLE}', '块'：[ { '类型'：'标题'， '文本'：{'类型'：'plain_text'，'文本'：'$ {TITLE}'，'表情符号'：True} }, { '类型'：'部分'， '文本'：{'类型'：'mrkdwn'，'文本'：'$ {DESCRIPTION}'} }, { '类型'：'图像'， 'image_url': '${IMAGE_URL}', 'alt_text': '${TITLE}' }, { '类型'：'动作'， “元素”：[{ '类型'：'按钮'， 'text': {'type': 'plain_text', 'text': '了解更多'}, 'url': '${LINK}', '风格': '主要', 'action_id': '了解更多' }] } ] } 打印（json.dumps（有效负载）） “）” ### 从 JSON 文件构建有效负载对于复杂的消息，首先将有效负载写入文件： # 写入有效负载猫 > /tmp/slack-message.json << 'PAYLOAD' { “渠道”：“#营销”， "text": "通知的备用文本", “块”：[ { “类型”：“标题”， “文本”：{ “类型”：“纯文本”， "text": "消息标题" } }, { “类型”：“部分”， “文本”：{ “类型”：“mrkdwn”， "text": "消息正文采用*粗体*和_斜体_格式。" } } ] } 有效载荷 # 发送卷曲-s -X POST“https://slack.com/api/chat.postMessage”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d @/tmp/slack-message.json ** ** ## 预定消息使用“chat.scheduleMessage”在未来的特定时间发布消息： # 为特定的 Unix 时间戳安排一条消息 # 使用：date -d "2026-02-12 09:00:00" +%s (Linux) 或 date -j -f "%Y-%m-%d %H:%M:%S" "2026-02-12 09:00:00" +%s (macOS) SEND_AT=$(日期 -j -f "%Y-%m-%d %H:%M:%S" "2026-02-12 09:00:00" +%s 2>/dev/null || 日期 -d "2026-02-12 09:00:00" +%s) 卷曲-s -X POST“https://slack.com/api/chat.scheduleMessage”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d“{ \“渠道\”：\“#营销\”， \"post_at\": ${SEND_AT}, \"text\": "团队早上好！这是今天的营销议程。\", \“块\”：[] }” 列出预定消息：卷曲-s“https://slack.com/api/chat.scheduledMessages.list”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" | \ python3-c“ 导入 json、系统、日期时间数据 = json.load(sys.stdin) 对于 data.get('scheduled_messages', []) 中的消息： ts = datetime.datetime.fromtimestamp(msg['post_at']).strftime('%Y-%m-%d %H:%M') print(f\"ID: {msg['id']} | 频道: {msg['channel_id']} | 预定: {ts}\") ” 删除预定消息：卷曲-s -X POST“https://slack.com/api/chat.deleteScheduledMessage”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d'{ “频道”：“C0123456789”， “scheduled_message_id”：“Q0123456789” }' ** ** ## 多渠道发布将同一条消息发布到多个渠道：频道=(“#营销”“#通用”“#产品”) MESSAGE='{"text":"明天有重大公告！","blocks":[{"type":"section","text":{"type":"mrkdwn","text":":mega: *明天有重大公告！*敬请关注。"}}]}' 对于“${CHANNELS[@]}”中的频道；做 echo“正在发布到${CHANNEL}...” 回声“$MESSAGE”| python3-c“ 导入 json、系统消息 = json.load(sys.stdin) msg['频道'] = '${频道}' 打印（json.dumps（msg）） ” |卷曲-s -X POST“https://slack.com/api/chat.postMessage”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d @- | python3-c“ 导入 json、系统 r = json.load(sys.stdin) if r.get('ok'): print(f' 已发送。ts={r[\"ts\"]}') 其他： print(f' 错误: {r.get(\"错误\", \"未知\")}') ” 完成 ** ** ## 错误处理 ### 常见 API 错误错误 |原因 |修复 ---|---|--- `invalid_auth` |令牌错误或过期 |在 Slack 应用程序设置中重新生成机器人令牌 `未找到频道` |机器人不在频道中或频道名称错误 |使用“/invite @BotName”邀请机器人或使用频道 ID `不在频道中` | Bot需要先加入频道 |邀请机器人或使用 `chat:write.public` 范围 `太多附件` |超过 50 个街区 |将消息拆分为多个帖子或线程回复 `msg_too_long` |文本超过 40,000 个字符 |缩短消息或分成几部分 `rate_limited` |请求过多 |等待“Retry-After”标头中的秒数 `缺失范围` |令牌缺乏所需的权限 |在 OAuth 和权限中添加范围并重新安装应用程序 ### 验证响应 RESPONSE=$(curl -s -X POST "https://slack.com/api/chat.postMessage" \ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d '{"channel":"#marketing","text":"测试消息"}') python3-c“ 导入 json、系统 r = json.loads('${RESPONSE}'.replace(\"'\", \"\")) if r.get('ok'): print(f'消息发送成功。ts={r[\"ts\"]} channel={r[\"channel\"]}') 其他： print(f'错误: {r.get(\"错误\", \"未知\")}') if r.get('response_metadata', {}).get('messages'): 对于 r['response_metadata']['messages'] 中的 m：打印（f'详细信息：{m}'） " 2>/dev/null ||回显“$响应” 使用临时文件的更可靠的方法： RESPONSE_FILE=$(mktemp) 卷曲-s -X POST“https://slack.com/api/chat.postMessage”\ -H "授权：持有者 ${SLACK_BOT_TOKEN}" \ -H“内容类型：application/json”\ -d '{"channel":"#marketing","text":"测试消息"}' \ -o“$RESPONSE_FILE” python3-c“ 导入 json 将 open('${RESPONSE_FILE}') 作为 f： r = json.load(f) if r.get('ok'): print(f'已发送。ts={r[\"ts\"]}') 其他： print(f'错误: {r.get(\"错误\")}') ” rm -f“$RESPONSE_FILE” ** ** ## 提示 * 始终在“块”旁边包含“文本”字段 - 它用作通知、辅助功能阅读器和不支持 Block Kit 的客户端的后备。 * 在构建curl 命令之前，使用上的Block Kit Builder 来直观地设计和预览消息。 * 对于生产工作流程，请通过 Webhooks 使用“chat.postMessage”（Web API）。它返回一条消息“ts”，您可以使用该消息进行线程化、更新和删除。 * 串接长报告。将摘要作为父消息发布，将详细信息作为线索回复发布，以保持渠道干净。 * 在 `plain_text` 字段中使用 `:emoji:` 代码和 `"emoji": true` 在标题和按钮标签中呈现表情符号。 * mrkdwn 中的转义特殊字符：`&` 变为 `&`，`<` 变为 `<`，`>` 变为 `>`。 * 速率限制：Slack 允许每个通道每秒发送大约 1 条消息。对于批量发布，请在请求之间添加 1 秒的延迟。 * 发布指标时，请使用“字段”部分进行两列布局，而不是尝试在 mrkdwn 中格式化表格（Slack 不支持表格）。 * **始终向用户显示完整的消息负载并在发布前要求确认。**

松弛机器人

包含技能