钉钉 (DingTalk) 群机器人配置指南

通过在钉钉群中添加自定义机器人并接入 DuRT，您可以将团队录音转写的核心摘要、决议、待办行动项即时推送到指定的钉钉协作群，方便全员实时同步与跟进。

---

核心特性

• Markdown 丰富排版：支持大标题、高亮引用块、无序列表等原生渲染，排版清晰美观。
• 加签安全机制 (HMAC-SHA256)：支持钉钉官方推荐的高级安全设置——通过时间戳与密钥生成加密签名，杜绝 Webhook 地址泄漏带来的安全风险。
• 免审核开箱即用：群管理员或群成员仅需在群内花费 1 分钟即可创建，无需企业开发者认证。

---

第一步：在钉钉群中创建自定义机器人并获取 Webhook

1. 在电脑端打开钉钉，进入您需要接收纪要的钉钉群（若测试可新建一个只有自己的群）。
2. 点击群界面右上角的 「群设置」（齿轮或群成员列表旁的更多图标）。
3. 选择 「智能群助手」 -> 点击 「添加机器人」。
4. 在机器人列表中选择 「自定义（通过 Webhook 接入自定义服务）」。
5. 点击 「添加」，进入配置页面：
   • 机器人名称：建议命名为 DuRT 纪要助手。
   • 添加到群组：确认目标群无误。
6. 安全设置（关键步骤）：
   • 钉钉要求至少选择一种安全设置。强烈推荐勾选「加签」：
   • 勾选 「加签」 后，界面会显示一串以 SEC 开头的密钥（Secret），如 SECxxxxxxxxxxxxxxxx...。
   • 点击该密钥旁边的 复制 图标，将其记录下来备用。
7. 勾选底部的“我已阅读并同意《自定义机器人服务及免责条款》”，点击 「完成」。
8. 此时会生成专属的 Webhook 地址（格式如 https://oapi.dingtalk.com/robot/send?access_token=xxxxxx）。
9. 点击 「复制」 保存该 Webhook 地址。

---

第二步：在 DuRT 中完成配置

1. 打开 DuRT 客户端，进入 「设置」->「第三方集成与推送」。
2. 点击左下角的 「+ 添加账号」，在弹出菜单中选择 「钉钉 (DingTalk)」。
3. 在右侧表单中填入刚才获取的信息：
   • 账号名称：如 产品研发组钉钉群。
   • Webhook 地址：粘贴第一步获取的完整 Webhook URL。
   • 加签密钥 (Sign Secret)：粘贴以 SEC 开头的密钥字符串（若群机器人未开启加签则可留空）。
   • 内容推送偏好：
     • ✅ 包含 AI 核心摘要 (Summary)
     • ✅ 包含行动项与待办 (Action Items)
     • 包含逐句对话记录 (可选：群聊中建议关闭或仅在需要时精简输出)
4. 点击右下角 「保存」，确认状态开关为开启。

---

第三步：测试与实际使用

1. 手动推送测试

1. 在 DuRT 工作台选择任意一个已完成的录音会话。
2. 点击右上角 「分发推送」 图标。
3. 勾选刚才添加的钉钉账号，点击 「立即投送」。
4. 钉钉群将立即弹出一条 Markdown 卡片通知，显示会议标题、时长、核心摘要与行动项。

2. 工作流全自动分发

编辑您的常用工作流（如“例会速记与分发”），在 ExportArtifact 步骤中勾选钉钉群账号。后续录音结束，DuRT 会全自动在后台推送，无需任何人工二次介入。

---

钉钉消息展示效果示意

当 DuRT 成功推送到钉钉群时，呈现如下规范的排版效果：

🎙️ 2026-10-14 产品周会纪要
时长: 24分35秒  |  来源: DuRT 本地语音 AI

💡 核心总结与决策:
本周完成了 OneASR 引擎网关升级，下周将启动多模态语音降噪测试...

✅ 行动项与待办:
- [张三] 完成客户端接口压测，周四前输出测试报告
- [李四] 配合对接钉钉与企业微信群机器人 Webhook

📝 逐句对话记录 (前 15 句):
> [00:00:05] 张三: 大家下午好，今天我们主要过一下本周交付进度...

---

常见问题与排错 (FAQ)

Q1: 发送报错 {"errcode":310000,"errmsg":"sign not match"}？

• 原因：加签密钥（Secret）填写错误，或者钉钉群后台开启了加签但 DuRT 中未填密钥。
• 解决：检查密钥是否完整（是否以 SEC 开头），两端是否有空格。

Q2: 发送报错 {"errcode":300001,"errmsg":"token is not exist"}？

• 原因：Webhook 地址中的 access_token 参数不正确或机器人已被删除。
• 解决：在钉钉群助手管理中重新复制一次完整的 Webhook 地址。

Q3: 钉钉群有消息发送频次限制吗？

• 机制：钉钉官方对每个自定义机器人有每分钟最多 20 条的频次限制。DuRT 针对单次会议只发送一条完整整合卡片，完全在限额安全范围内。