配置钉钉账号集成

更新时间:
复制 MD 格式

AgentTeams 支持通过钉钉账号集成实现企业成员使用钉钉扫码登录,并自动同步钉钉通讯录中的用户信息。配置钉钉账号集成后,可免去手动创建用户的操作,实现成员统一认证和自动化用户管理。

配置钉钉应用权限

钉钉的应用中配置权限,并且发布钉钉应用版本。此步骤需要在AgentTeams控制台上配置钉钉集成前完成。

权限信息

权限点 code

对应功能

获取钉钉开放接口用户访问凭证的基础权限

open_app_api_base

登录

通讯录个人信息读权限

Contact.User.Read

登录

通讯录部门成员读权限

qyapi_get_department_member

同步用户信息

通讯录部门信息读权限

qyapi_get_department_list

同步用户信息

成员信息读权限

qyapi_get_member

同步用户信息

根据手机号获取成员基本信息权限

qyapi_get_member_by_mobile

同步用户信息

企业员工手机号信息

fieldMobile

同步用户信息

配置钉钉登录

  1. 从钉钉应用中获取 CorpId、AppKey 和 AppSecret。

  2. Agent Teams控制台中,选择左侧的账号集成 > 钉钉

  3. 将获取的 CorpId、AppKey 和 AppSecret 配置在 AgentTeams 的钉钉集成页面中。

  4. 将 AgentTeams 提供的钉钉登录回调地址配置到钉钉应用安全设置的重定向 URL 中。

  5. 发布应用版本。

完成配置后,AgentTeams 会在用户通过钉钉扫码登录时,自动从钉钉拉取用户信息并创建对应的账号。

使用钉钉扫码登录 AgentTeams

  1. AgentTeams会从钉钉拉取钉钉用户信息,并在AgentTeams创建对应的用户。

  2. 选择Continue with dingtalk,使用钉钉扫码登录。授权后进入web聊天页面。

配置钉钉通讯录同步

钉钉登录配置实现了用户登录时的账号自动创建。若需在组织架构变动时自动同步用户变更至 AgentTeams(如成员增加、删除或展示名变更),需额外配置通讯录增量同步。

配置钉钉增量同步

  1. 进入钉钉应用的事件订阅配置,选择 HTTP 推送。

  2. 单击刷新按钮,生成 aes_key 和签名 token。

  3. 勾选以下三种通讯录事件:

    • 通讯录用户增加

    • 通讯录用户更改

    • 通讯录用户离职

  4. 在 AgentTeams控制台左侧的账号集成页面填写对应的钉钉配置并保存。

  5. 在钉钉集成页面获取事件订阅回调地址,将该地址填写在钉钉事件订阅的请求网址中并保存配置。

  6. 发布钉钉应用版本。