一、钉钉企业内部应用准备
1. 企业管理员登录钉钉开放平台,进入“应用开发”,选择需要同步通讯录的企业内部应用。
2. 在“权限管理”中设置通讯录接口范围,确认覆盖需要同步的部门和员工。
3. 开通部门列表、部门成员列表、成员信息读、员工手机号、员工邮箱读取权限。未获授权的字段不会返回。
4. 在“版本管理与发布”发布新版本,确认应用状态为“已上线”。
5. 在“凭证与基础信息”获取 Client ID、Client Secret 和 AgentId。Client Secret 只填入九宸后台,不写进文档或截图。
二、九宸后台渠道配置
1. 登录目标租户后台,进入“基础平台 → 系统管理 → 消息推送 → 渠道配置”。
2. 新增“钉钉工作通知应用”渠道,填写同一应用的 Client ID、Client Secret 和 AgentId,启用并保存。钉钉群机器人渠道不能用于通讯录同步。
3. 如有多个钉钉应用,后续预览时选择与目标企业对应的渠道。