配置钉钉账号集成
通过钉钉账号集成，企业成员可使用钉钉扫码登录 AgentCore，用户信息从钉钉通讯录自动同步。集成后无需手动创建用户，即可实现成员统一认证和自动化用户管理。
准备工作
开始配置前，确认以下条件已满足：
已创建钉钉开放平台应用。后续的钉钉侧操作（权限开通、安全设置、事件订阅、版本发布）均在该应用内完成。
权限开通可能需要企业管理员审批，请预留审批时间。
同步人数受 AgentCore 当前账号及 Workspace 的配额限制，目前仅支持导入最多100名成员。
配置钉钉应用权限
在钉钉开放平台的应用内开通 AgentCore 所需的接口权限。权限开通需要在 AgentCore 控制台配置钉钉集成前完成。钉钉开放平台对权限、安全设置等的修改需发布应用版本后才能生效，发布步骤见“配置钉钉登录”和“配置钉钉增量同步”。
开通以下全部权限。权限缺失会导致登录失败或同步不生效：
权限信息 | 权限点 code |
获取钉钉开放接口用户访问凭证的基础权限 |
|
通讯录个人信息读权限（范围应为全体员工） |
|
通讯录部门成员读权限（范围应为全体员工） |
|
通讯录部门信息读权限（范围应为全体员工） |
|
成员信息读权限 |
|
权限开通方法：
在钉钉开放平台应用的左侧导航栏，选择开发配置 > 权限管理。
按上表逐项搜索权限名称或权限点 code 并开通。AgentCore 中选择的同步范围不能超出钉钉应用的授权范围，通讯录接口的权限范围必须覆盖需要同步的部门和成员：选择全部同步或需要读取完整组织架构时，可将授权范围设置为全体员工；选择按部门同步时，授权范围需覆盖所选部门及其所有子部门。
确认所开通权限的状态列均显示为已开通。若某项权限显示需要审批，请等待企业管理员审批通过后再继续。
配置钉钉登录
从钉钉应用中获取 CorpId、Client ID（原 AppKey）和 Client Secret（原 AppSecret）。
在钉钉开放平台进入已创建应用的配置页面，在应用的左侧导航栏选择基础信息 > 凭证与基础信息，记录 Client ID 和 Client Secret。
获取企业 CorpId：单击页面右上角的企业头像，在展开的企业信息卡片内，单击 CorpId 将其复制。CorpId 是企业在钉钉的唯一标识，配置时不可省略。
在 AgentCore 控制台左侧，选择账号集成 > 钉钉，进入钉钉集成页面。
将获取的 CorpId、Client ID 和 Client Secret 填入钉钉集成页面，保存配置并等待完成。
将 AgentCore 提供的钉钉登录回调地址配置到钉钉应用安全设置的重定向 URL 中。
在应用的左侧导航栏，选择开发配置 > 安全设置，将钉钉登录回调地址粘贴到重定向 URL（回调域名）输入框，然后单击保存。若输入框内已有其他地址，请勿覆盖，按输入框下方提示的分隔符追加。
发布应用版本，使已开通的权限和已配置的重定向 URL 生效。
在应用的左侧导航栏，选择应用发布 > 版本管理与发布，创建并发布新版本。发布时，可用范围需覆盖需要登录的成员，通讯录接口的权限范围需覆盖需要同步的部门和成员。当前账号集成的钉钉应用最多支持100个用户，超出后账号集成将失败。
完成配置后，即可使用钉钉扫码登录 AgentCore。如需导入成员，请继续配置钉钉通讯录同步。
配置钉钉通讯录同步
通讯录同步支持同步钉钉应用授权范围内的全部成员，或按部门同步指定部门及其所有子部门的成员。首次导入成员需设置同步范围并执行同步；若需在组织架构变动时将用户变更（如成员增加、删除或展示名变更）自动同步至 AgentCore，还需配置增量同步（控制台的开关名称为通讯录自动同步）。
设置同步范围并执行同步
在钉钉集成页面的设置同步范围区域，选择全部同步或按部门同步。
全部同步：同步钉钉应用已授权范围内的全部成员。
按部门同步：展开部门树，勾选需要同步的部门，同步所选部门的直属成员及其所有子部门成员。同步人数超出配额限制时，可通过该方式缩小同步范围。
保存同步范围，等待配置完成。此操作仅保存同步范围，不会立即执行成员同步；首次导入成员或扩大同步范围后，还需单击执行同步。缩小同步范围不会自动清理已导入的用户。
单击执行同步，等待任务完成后，在用户列表查看同步的成员。
配置钉钉增量同步
增量同步依赖钉钉的事件订阅能力，配置需在钉钉开放平台和 AgentCore 控制台之间交替完成。请严格遵循以下顺序：先在钉钉侧生成加密 aes_key 和签名 token 并复制，此时不要保存；将其填入 AgentCore 并保存后，再回到钉钉侧保存事件订阅配置。
在钉钉开放平台应用的左侧导航栏，选择开发配置 > 事件订阅，进入事件订阅配置页面。推送方式选择 HTTP 推送。钉钉页面默认推荐 Stream 模式，此处请勿选择。
分别单击加密 aes_key 和签名 token 输入框右侧的刷新按钮，生成
aes_key和token，单击眼睛图标显示后复制备用。此时先不要单击保存。勾选以下三种通讯录事件：
通讯录用户增加
通讯录用户更改
通讯录用户离职
通讯录企业部门创建
通讯录企业部门修改
通讯录企业部门删除
返回 AgentCore 控制台的钉钉集成页面，启用通讯录自动同步，填写上一步获取的加密
aes_key和签名token，保存并等待配置完成。在钉钉集成页面获取事件订阅回调地址，返回钉钉开放平台应用的开发配置 > 事件订阅页面，将该地址填写到请求网址，保存配置并确认地址校验通过。
重要事件订阅回调地址用于接收通讯录变更，与钉钉登录回调地址不同，请勿混用。
发布钉钉应用版本，使事件订阅配置生效。发布时，可用范围和通讯录接口权限范围的要求与“配置钉钉登录”中的发布步骤一致，以免因应用可读取的通讯录范围不足导致成员同步不全。
增量同步用于处理后续变更，首次导入已有成员仍需执行同步。
验证钉钉登录与通讯录同步
打开 AgentCore 的登录入口，选择 Continue with dingtalk。
使用钉钉 App 扫描页面上的二维码完成认证。
授权后登录成功并返回 AgentCore，进入 Web 聊天页面，表示钉钉登录配置已生效。
如果已执行成员同步，在用户列表确认钉钉成员已同步；按部门同步时，检查所选部门及其子部门的成员是否已导入。
如果已配置增量同步，在钉钉管理后台新增测试成员或修改测试成员信息，不手动执行同步，等待一段时间后检查 AgentCore 用户列表的对应变化。