钉钉场景管理
清海与钉钉深度集成的场景规划总览，面向以钉钉为主要协同工具的企业客户（如多燕瘦销售团队）。
场景全景
| # | 场景 | 核心价值 | 状态 |
|---|---|---|---|
| 1 | 钉钉组织架构识别 | 同步钉钉通讯录 → 自动识别员工身份 → 千人千面对话 | ✅ 已规划 |
| 2 | 销售团队管理 | AI 绩效评分、经验提炼、主动访谈、末位识别 | 🕐 待规划（见客户案例） |
| 3 | 钉钉消息主动推送 | 任务催办、异常提醒主动触达钉钉用户 | 🕐 待规划 |
集成架构概览
钉钉 API 接入说明
| 项目 | 说明 |
|---|---|
| 接入方式 | 企业内部应用机器人，AppKey + AppSecret 换取 access_token |
| 推荐接入模式 | Stream 模式（WebSocket 长连接），无需公网 IP / 域名，极大降低部署门槛 |
| 备选接入模式 | HTTP 回调模式，需要公网 HTTPS 地址，适合已有服务器的场景 |
| 事件订阅 | 通讯录变更事件实时推送（user_add_org / user_leave_org / user_modify_org 等） |
| 用户唯一标识 | 机器人消息 senderStaffId 即企业内 userid，唯一且稳定 |
| API 版本 | 通讯录优先旧版（oapi.dingtalk.com），manager_userid 等关键字段仅旧版完整 |
| 数据隔离 | 基于钉钉 userid + 组织架构，清海已完成人员识别（见钉钉组织架构识别） |
与其他平台的核心差异
| 维度 | 飞书 | 企业微信 | 钉钉 |
|---|---|---|---|
| 是否需要公网 | ✅ 需要（HTTP 回调） | ✅ 需要（HTTP 回调） | ❌ Stream 模式不需要 |
| 用户主键 | open_id（ou_ 开头） | userid（FromUserName） | userid（senderStaffId） |
| 事件变更 | 定时轮询（30 分钟） | 事件回调（实时） | 事件订阅（实时） |
| 直属上级字段 | 需额外查询 | direct_leader（数组） | manager_userid（单字段） |
| 部门根节点 | parent_department_id=0 | id=1 | dept_id=1 |
| 适用行业 | 互联网 / 新型企业 | 制造 / 零售 / 金融 | 中大型企业 / 销售型组织 |