开发指南什么是钉钉通讯录
钉钉通讯录是企业内部信息统一管理的核心基础设施，它以数字化方式呈现企业的组织架构和人员信息，为企业成员提供快速找人、高效协作的基础能力。 更多功能介绍请参考钉钉使用手册-企业通讯录。如何查看通讯录
企业管理员视角
企业管理员可通过以下方式管理和查看通讯录：- 钉钉管理后台：登录登录钉钉管理后台，进入内部通讯录模块，可进行通讯录的完整管理和配置
- 通讯录设置：配置通讯录的可见性规则、自定义字段、高管模式等高级功能
普通成员
普通组织成员可通过以下终端查看通讯录：- PC 端钉钉：在钉钉 PC 客户端中点击「通讯录」标签，可查看企业组织架构和联系详情
- 手机端钉钉：在钉钉移动 App 中进入「通讯录」页面，支持按部门浏览和关键词搜索
- Web 端钉钉：通过钉钉网页版访问通讯录功能
开放概览
开放接口列表
通讯录提供了丰富的接口开放能力，开发者通过API接口可以实现通讯录和企业业务系统打通。用户通讯录
通讯录权限
用户管理
部门管理
角色管理
外部联系人
企业账号
企业管理
通讯录ID转译
通讯录可见性管理
回调事件列表
通讯录支持用户变更、部门变更、角色变更和企业信息变更等回调事件，更多事件可参考事件订阅总览。使用教程
钉钉提供了通讯录接口接入流程示例。- 创建、获取、更新和删除企业员工
- 创建、获取、更新和删除企业部门
- 企业OA系统与钉钉通讯录实现同步
- 第三方个人小程序获取登录用户信息
名词解释
工号
工号对应的字段编码是job_number，企业内员工的工号可以不唯一，所以不能作为员工在企业内的唯一标识。 企业管理员登录钉钉管理后台，在通讯录页面单击员工姓名可查看员工工号，工号字段是非必填字段。
unionId
用户在当前钉钉开放平台账号范围内的唯一标识，同一个钉钉开放平台账号可以包含多个开放应用，同时也包含ISV的套件应用及企业应用。 unionId可通过调用查询用户详情接口获取。角色组和角色
企业内定义的角色组和角色，方便对员工身份信息进行管理，员工同时可拥有多个角色身份。 企业管理员登录钉钉管理后台，在通讯录 > 内部通讯录管理页面，单击角色可查看角色组和角色。
通讯录扩展字段
通讯录可以添加扩展字段。 企业管理员登录钉钉管理后台，在内部通讯录设置 > 通讯录信息 > 添加自定义字段页面，新增自定义字段。