Nox-Lumen Auto企业微信 (WeCom) 集成
能力全景
Rendering diagram…
能力总览
| 能力 | 说明 |
|---|---|
| 通讯录 | 按姓名 / 别名查询成员，返回 userid + 别名 |
| 即时通讯（IM） | 会话列表、消息记录拉取（文本/图片/文件/语音/视频）、发文本 |
| 文档 / 智能表格 | 创建、读写、子表/字段管理、记录 CRUD |
| 会议 | 预约 / 查询 / 取消 / 成员管理 |
| 日程 | 创建 / 查询 / 更新、闲忙状态分析 |
| 待办 | 列表 / 详情 / 创建 / 分派 / 状态变更 |
企业微信返回结果只包含当前身份可见范围内的数据，不是全公司全量。这一点和飞书不同，设计场景时注意。
前置条件
- 企业微信管理员账号
- 在 work.weixin.qq.com 自建应用，拿到：
- CorpID（我的企业 → 企业信息）
- AgentID（所建应用详情）
- Secret（所建应用详情）
- 如需事件订阅：配置接收消息 URL + Token + EncodingAESKey
配置步骤
步骤 1：创建凭据
管理台 → 集成 → 企业微信 → 新增：
- CorpID：企业 ID
- AgentID：应用 ID
- Secret：应用 Secret
- Token / EncodingAESKey（仅订阅事件时必填）
步骤 2：授权可见范围
企业微信后台 → 应用 → 可见范围：设置该应用能看到哪些部门 / 成员。没授权的成员，CLI 查不到。
步骤 3：订阅事件（可选）
企业微信后台 → 应用 → 接收消息：
- URL：
https://<combo-agent>/v1/webhook/wecom - Token / EncodingAESKey：和平台配置保持一致
步骤 4：验证
日常使用场景
| 场景 | 能力 | 典型对话 |
|---|---|---|
| 查员工 | 通讯录 | "找一下产品组的李四" |
| 查聊天记录 | IM | "上周在『项目 A』群里讨论了什么" |
| 安排会议 | 会议 / 日程 | "下周一 10:00 和张三李四开个 1 小时会" |
| 创建待办 | 待办 | "给我建个下周三交周报的提醒" |
| 看文档 | 文档 | "打开『项目周报』这个智能表格最近一周的记录" |
常见坑位
| 问题 | 解决 |
|---|---|
42001 access_token 过期 | SDK 自动刷；手动调用时注意缓存 |
| 查不到某个同事 | 检查应用可见范围是否包含该员工所在部门 |
| 发消息给不在可见范围的人 | 企微不允许，改为通过共同群聊转发 |
| EncodingAESKey 解密失败 | 长度必须 43 位且和后台一致 |
相关文档
- 📖 办公自动化方案
- 📖 Channel 消息渠道
- 🧰 技能：
wecomcli-contact,wecomcli-msg,wecomcli-doc,wecomcli-meeting,wecomcli-schedule,wecomcli-todo