跳转到内容
BugCapturer BugCapturer Docs

Slack

Slack 集成会把每条分享以 Block Kit 卡片的形式发到你指定的 Slack 频道：标题、页面、环境、诊断条数、带标注截图的链接，以及一个「查看完整报告」按钮（点击跳转到分享页）。

接入方式为 Slack Incoming Webhook：不需要 OAuth，也不用提交应用审核。一个 webhook 地址对应一个频道，所以想推到三个频道就配置三个集成。

第一步：在 Slack 创建 Incoming Webhook

Section titled “第一步：在 Slack 创建 Incoming Webhook”
  1. 打开 api.slack.com/apps → Create New App → From scratch
  2. 填写应用名，选择目标 workspace，点击 Create App
  3. 左侧进入 Incoming Webhooks，把 Activate Incoming Webhooks 开关打开
  4. 点击底部的 Add New Webhook to Workspace，选择接收报告的频道并授权
  5. 复制生成的地址，形如 https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXX

第二步：在 BugCapturer 添加集成

Section titled “第二步：在 BugCapturer 添加集成”
  1. 登录后进入集成设置页
  2. 左侧平台列表选择 Slack → 点击「添加集成」
  3. 填写名称，粘贴第一步的 Incoming Webhook 地址
  4. 点击「保存」——服务端会校验地址属于 hooks.slack.com，并向该频道发送一张测试卡片
  5. 频道里出现卡片即表示配置成功，之后每条新分享都会自动发一张卡片到该频道

卡片包含什么

Section titled “卡片包含什么”
元素内容
标题🐞 [类型] 描述首行
页面反馈所在页面的标题，链接到脱敏后的 URL
环境浏览器 · 操作系统 · 分辨率
诊断只有条数：控制台 2 · 网络 0
截图带标注截图的链接 —— 平台能抓取图片时会直接内嵌显示
按钮「查看完整报告」→ 分享页（含完整错误详情）

一个地址对应一个频道

Section titled “一个地址对应一个频道”

Slack Incoming Webhook 本身就是按频道授权的。如果多个团队都要收报告，可以：

  • 每个频道配一个集成，或
  • 全部发到一个频道，再用 Slack 自己的自动化继续分流

卡片以你创建的 Slack 应用身份发出，频道名正常显示。

投递、重试与失败

Section titled “投递、重试与失败”
  • 只认 2xx 为成功（Slack 接收成功会返回 ok）
  • 失败自动重试 2 次（5s / 15s 退避），每次结果记录在投递日志中
  • 连续失败 20 次自动停用集成并邮件提醒
  • 常见失败原因：webhook 在 Slack 侧被吊销、应用被卸载、频道被删除。修复后点「测试」即可恢复

安全说明

Section titled “安全说明”
  • 该 webhook 地址本身就是凭证，任何拿到它的人都能往这个频道发消息
  • 因此 BugCapturer 不回显完整地址：列表与卡片只显示末 6 位
  • 需要更换时，在编辑集成时重新粘贴完整地址
  • 需要吊销时，直接在 Slack 侧删除该 webhook（之后集成会持续失败并在 20 次后自动停用）
  • 仅接受 https://hooks.slack.com/services/…（GovSlack 为 hooks.slack-gov.com）

常见问题

Section titled “常见问题”

保存时提示「仅支持平台官方地址」？ 地址必须是 Slack Incoming Webhook，不接受其他域名 —— 因为该地址是凭证，可以往你的 workspace 发消息。

截图在哪里？ 卡片一定会带上带标注截图的链接。Slack 会自己去抓取并渲染图片；如果它取不到我们的截图代理地址（302 跳转到签名 URL），卡片仍会正常发出，链接也照常可用。

能在 BugCapturer 里选频道吗？ 用 Incoming Webhook 做不到。要「下拉选频道」需要走完整的 Slack App + OAuth 授权，已在规划中，本版本不含。

卡片按钮能直接改状态吗？ 暂不支持。按钮是纯跳转链接，让这个集成保持轻量、低风险的「通知层」定位。

另见：投递日志 与 自动停用。