← 返回配置页
MaxElms · 集成配置
钉钉打通 · 配置指南
按本指南操作，员工在钉钉里点开应用即可免登录进入系统。全程约 10 分钟，分两步：先在钉钉开放平台配置，再到系统配置页一键同步。
蓝色 = 在 钉钉开放平台 操作绿色 = 在 系统配置页 操作
开始前，请准备
- 钉钉管理员/开发者权限 —— 用于创建企业内部应用（钉钉开放平台）
- 系统的租户管理员账号 —— 用于同步通讯录、创建员工账号（手机号 + 密码）
登录 open-dev.dingtalk.com，按下面 5 步操作。
创建企业内部应用
应用开发 → 企业内部应用 → 创建应用，填名称/图标后创建。
记下 AppKey 和 AppSecret
应用 → 凭证与基础信息：AppKey（Client ID）+ AppSecret（Client Secret）。
申请「通讯录」权限
应用 → 权限管理，开通部门/成员信息读权限（读手机号需一并开通成员手机号权限）。
设置权限「可使用范围」
权限管理 → 每个权限的可使用范围，加入要同步的部门/成员（或全部）。范围为空会读到 0 个成员。
配置重定向 URL + 应用首页
安全设置 → 重定向URL（回调域名） 添加：
https://new.maxelms.com/dingtalk/callback
应用首页地址（员工点开即免登）填：
https://new.maxelms.com/dingtalk/login
打开系统的「钉钉打通」配置页，用你的系统管理员账号操作。全程只读写你自己企业的数据。
填写并测试连接
把 AppKey / AppSecret 填入，点 「测试连接」。系统会校验凭据 + 读通讯录 —— 有问题会用大白话提示去哪改。全绿后点「保存配置」。
用管理员账号登录
在「同步通讯录」区，填你的系统管理员手机号和密码，点登录。
先预览，再正式同步
点 「预览」 看将建多少部门/账号（不写入）；确认后点 「正式同步」：建组织 → 建账号 → 分配权限 → 启用。已存在的自动跳过，可重复运行。
完成 —— 员工可以用了
员工在钉钉工作台 点开应用即免登 进入系统。默认密码统一为 Max123456，建议提醒员工首次登录后修改。
常见问题
- 同步后提示部分成员被跳过？
- 应用没有成员手机号权限时读不到手机号，这些成员无法自动建登录账号，会被跳过。开通手机号权限后再同步即可。
- 会不会影响到别的企业的数据？
- 不会。同步用的是你登录产生的身份令牌，作用范围严格限定在你自己的企业租户内。
- 「测试连接」不通过？
- 最常见是通讯录权限没开或可使用范围为空。配置页会明确告诉你缺哪项、去钉钉后台哪里改，按提示补上再点一次。