技术方案
PMS-0000-001 对接钉钉 / 企业微信 V0.2
作者：陈明
评审：刘洋、张伟
状态：待评审
一、背景
任务逾期、里程碑到达和风险升级需要推送到企业 IM。钉钉为企业主通道，权限若在 09/23 前无法获批，则切换企业微信备用通道，保证一期试运行可通知到人。开放能力说明见 钉钉开放平台。
二、目标
- 支持任务逾期、里程碑、红色风险三类通知。
- 主通道钉钉，备用企业微信，业务侧只接一套通知接口。
- 失败可重试，不在文档编辑链路里同步发送。
三、方案结构
四、方案对比
五、接口草图
{
"event": "task.overdue",
"projectId": "PMS-0000-001",
"receivers": ["ding:manager", "wecom:backup"],
"payload": {
"taskName": "钉钉消息集成",
"dueAt": "0000-00-00"
}
}
六、风险
- 权限：钉钉开放能力审批是关键路径，09/23 为切换日。
- 频控：同一任务 24 小时内只通知一次，避免刷屏。
- 内容安全：通知里不带文档正文，只带标题和链接。
七、上线检查
- 测试租户可分别打通钉钉与企微。
- 关闭钉钉通道后，通知自动走企微。
- 重试 3 次仍失败写入死信，并可手工补发。
- 正式环境默认关闭，试运行名单白名单开启。