企微场景管理
清海与企业微信深度集成的场景规划总览，覆盖通讯录感知、消息对话等企业微信原生能力。
场景全景
| # | 场景 | 核心价值 | 状态 |
|---|---|---|---|
| 1 | 企微组织架构识别 | 同步企微通讯录 → 自动识别员工身份 → 千人千面对话 | ✅ 已规划 |
| 2 | 企微消息主动推送 | 异常提醒、任务催办、审批通知主动推送到企微 | 🕐 待规划 |
| 3 | 企微群聊场景 | 群 @机器人、群内任务指派、多人协作场景 | 🕐 待规划 |
集成架构概览
企业微信 API 接入说明
| 项目 | 说明 |
|---|---|
| 接入方式 | 企业自建应用，corpid + corpsecret 换取 access_token |
| 消息回调格式 | XML（自建应用），消息体经 AES 加密，需用 Token + EncodingAESKey 解密 |
| 事件订阅 | 通讯录变更事件（入职 / 离职 / 调岗）实时推送回调 |
| Token 有效期 | 7200 秒（2 小时），建议提前 5 分钟全局缓存刷新 |
| 用户唯一标识 | FromUserName（普通消息）/ from.userid（智能机器人）均为企业内 userid |
| 数据隔离 | 基于企微 userid + 组织架构，清海已实现人员识别（见企微组织架构识别） |
与其他平台的核心差异
| 维度 | 飞书 | 企业微信 | 钉钉 |
|---|---|---|---|
| 用户主键 | open_id（ou_ 开头） | userid（FromUserName） | userid（senderStaffId） |
| 消息格式 | JSON | XML（必须 AES 解密） | JSON |
| 事件变更 | 定时轮询（30 分钟） | 事件回调（实时） | 事件订阅（实时） |
| 直属上级字段 | 需额外查询 | direct_leader（数组） | manager_userid |
| 适用行业 | 互联网 / 新型企业 | 制造 / 零售 / 金融 | 中大型企业 |