钉钉 / 企业微信 / 飞书机器人

这三种渠道都是基于「群机器人 Webhook」推送，配置流程基本一致：

1. 在 IM 群里创建一个机器人，得到一个 Webhook URL
2. 把 URL 填到改页侦探的渠道配置里
3. 测试发送

谁能收到

机器人发送的消息会被群里 所有成员 看到，适合团队共享监控提醒。目前不支持 @ 指定成员。

钉钉机器人

1. 在钉钉群创建机器人

1. 打开钉钉群 → 右上角 ⚙ → 群助手 → 添加机器人 → 自定义
2. 安全设置勾选「自定义关键词」或「加签」
   • 自定义关键词推荐填：改页侦探、变化提醒
3. 复制 Webhook URL

2. 在改页侦探中配置

「我的 → 通知渠道 → 添加 → 钉钉机器人」：

字段	必填	说明
渠道名称	✅	如「钉钉运营群」
Webhook	✅	填完整 Webhook 地址，或只填其中的 access_token
secret	-	加签密钥，安全设置选了「加签」时必填，以 SEC 开头
消息格式	-	默认 Markdown；选「纯文本」会剥离模板里的 Markdown 标记

3. 测试

点击 测试，群里收到「改页侦探 · 测试通知」即配置成功。

安全设置

钉钉机器人必须至少配置一种安全设置，否则会拒绝 Webhook 请求。 推荐用「自定义关键词」最简单，关键词包含 改页侦探 即可。

---

企业微信机器人

1. 在企业微信群创建机器人

1. 打开企业微信群 → 右上角 ⋯ → 添加群机器人
2. 新建机器人，自定义名称和头像
3. 复制 Webhook URL

2. 在改页侦探中配置

「我的 → 通知渠道 → 添加 → 企业微信机器人」：

字段	必填	说明
渠道名称	✅	如「企微研发群」
Webhook	✅	填完整 Webhook 地址，或只填其中的 key
消息格式	-	默认 Markdown；纯文本最长约 2048 字节，长差异可能被截断

3. 测试

点击 测试，群里收到测试消息即可。

注意

企业微信机器人没有「关键词」「加签」等安全要求， 但有 每分钟 20 条 的发送频率限制，请勿密集触发。

---

飞书机器人

1. 在飞书群创建机器人

1. 打开飞书群 → 右上角 ⋯ → 设置 → 群机器人 → 添加机器人
2. 选择「自定义机器人」
3. 安全设置勾选「自定义关键词」或「签名校验」
4. 复制 Webhook URL

2. 在改页侦探中配置

「我的 → 通知渠道 → 添加 → 飞书机器人」：

字段	必填	说明
渠道名称	✅	如「飞书产品群」
webhook	✅	完整的飞书机器人 Webhook 地址
secret	-	签名密钥，开启「签名校验」时必填
消息格式	-	默认 交互卡片；选「纯文本」会剥离 Markdown 标记，且不再附带差异详情按钮

3. 测试

点击 测试，群里收到测试消息即配置成功。

---

消息样式

消息的标题与正文由该任务绑定的 通知模板 渲染，各渠道再按「消息格式」设置呈现：

• 钉钉 / 企业微信：默认 Markdown，正文里的「查看完整差异详情」是一条链接
• 飞书：默认交互卡片，除正文外还会附一个跳转差异详情的按钮；切成纯文本后按钮消失
• 三者都可以切换成纯文本，此时模板里的 Markdown 标记会被剥离，只保留可读文案
• 差异内容按元素分块展示，每块最多 30 行，超出会截断

想改标题措辞或正文结构，改通知模板即可，不用改渠道配置。

失败排查

现象	排查方向
测试失败：关键词不匹配	钉钉 / 飞书的自定义关键词需要包含「改页侦探」
测试失败：签名错误	是否填了加签密钥 / 签名 secret
测试失败：webhook 已禁用	群机器人是否被群主移除
偶发失败	是否触发限流（钉钉 5s 内最多 20 条）