企业微信通讯录
企业微信通讯录能力用于把企业微信的成员、部门和组织结构接入到产品中。它适合成员选择、部门权限、组织架构展示、身份映射和通知对象选择等场景。适合什么场景
- 在产品中展示企业微信部门树。
- 根据部门或成员设置数据权限、审批人或负责人。
- 查询员工信息，用于任务分配、通知和组织协作。
- 将企业微信用户身份与产品账号对应起来。
接入前需要准备
企业微信后台需要配置什么
企业微信通讯录不像飞书那样通过一组固定 scope key 批量导入。这里主要配置的是自建应用的通讯录权限、应用可见范围和接口调用安全项。
常用通讯录接口对应关系：
如何在 superun 中启用
1
点击「企业微信通讯录」
在「研发」→「技能库」中打开「企业微信通讯录」，点击使用，并说明产品里需要使用成员、部门或身份映射的业务场景。
2
按引导完成基础配置
如果项目还没有配置企业微信基础插件，对话框会引导你填写 CorpID、AgentID 和 Secret；如果已经配置过，会直接复用已有配置。
3
开通通讯录权限
按照 企业微信自建应用后台配置指南，在企业微信后台确认自建应用拥有通讯录读取权限，并设置应用可见范围。
4
补充数据范围
告诉 superun 需要读取哪些部门、成员字段，以及这些数据用于哪些页面或流程。
5
发布后测试
使用已绑定的企业备案域名进行测试，确认部门和成员数据可以正常读取。
常见限制
- 企业微信要求域名备案主体与企业认证主体一致，开发预览域名通常无法通过安全校验。
- 应用可见范围不足时，可能只返回部分成员或部门。
- 通讯录字段读取遵循企业微信权限控制，敏感字段需要额外授权。