跳到主要内容

钉钉集成

前提准备​

1. 注册钉钉账号​

注册地址：https://oa.dingtalk.com/register_new.htm 输入手机号，点击注册

2. 创建钉钉应用（H5微应用）​

3. 新版本钉钉应用配置​

3.1 添加网页应用​

  • 在添加应用能力，找到“网页应用”，点击配置

  • 配置网页应用

  • ① 应用首页地址：移动端钉钉访问的前端地址

    • 如：http://192.168.1.6:3100/tenantId/租户id

  • ② PC端首页地址：pc端钉钉访问的前端地址

    • 如：http://192.168.1.6:3100/tenantId/租户id

租户id可以在系统管理->租户管理或者我的租户中获取

3.2 配置开发者IP白名单及免登录回调地址​

  • ① 在安全配置中配置“服务器出口IP”和“重定向URL”
  • ② 服务器出口IP：123.125.121.209，如果是测试环境，可以去百度上搜索自己的外网IP（见下图），如果是线上环境，直接填写线上的公网IP即可。
  • ③ 重定向URL：本地测试可以采用ngrok或者花生壳进行映射

3.3 接口权限的授权​

需要申请钉钉权限，必须添加以下权限

  • 企业员工手机号信息
  • 邮箱等个人信息
  • 通讯录部门信息读权限
  • 成员信息读权限
  • 通讯录部门成员读权限
  • 个人手机号信息
  • 通讯录个人信息读权限
  • 维护通讯录的接口访问权限
  • 例：搜索个人手机号信息，点击申请权限即可

3.4 版本发布​

  • 在版本管理预发布中，点击创建新版本

  • 填写完信息之后，选择使用范围，保存即可

4. 旧版钉钉应用配置​

4.1 开发者IP白名单配置及首页地址配置​

  • 在新创建的应用详情里，找到左侧导航栏的开发管理，并单击右侧的修改按钮，将数据填写进去，如步骤①②
  • ③ 出口ip：123.125.121.209，如果是测试环境，可以去百度上搜索自己的外网IP（见下图），如果是线上环境，直接填写线上的公网IP即可。

  • ④ 应用首页地址：移动端钉钉访问的前端地址

    • 如：http://192.168.1.6:3100/tenantId/租户id

  • ⑤ PC端首页地址：pc端钉钉访问的前端地址

    • 如：http://192.168.1.6:3100/tenantId/租户id

租户id可以在系统管理->租户管理或者我的租户中获取

4.2 接口权限的授权​

需要申请钉钉权限，必须添加以下权限

  • 企业员工手机号信息
  • 邮箱等个人信息
  • 通讯录部门信息读权限
  • 成员信息读权限
  • 通讯录部门成员读权限
  • 个人手机号信息
  • 通讯录个人信息读权限
  • 维护通讯录的接口访问权限
  • 例：搜索个人手机号信息，点击申请权限即可

4.3 配置免登录回调地址​

  • 配置免登录回调地址，本地测试可以采用ngrok或者花生壳进行映射

4.4 版本发布​

发布成功之后可以选择使用范围

钉钉同步用户部门到本地​

找到钉钉配置AgentId、AppKey、AppSecret

新版钉钉应用配置在这里：凭证与基础信息，原企业内部应用AgentId、Client ID (对应原AppKey)、Client Secret（对应原AppSecret）

将AgentId、AppKey、AppSecret分别录入

  • 请确保AppKey是否在其他组织里未被使用，否则会提示AppKey重复。 系统管理->第三方配置

点击同步即可完成钉钉同步

钉钉同步到敲敲云规则：

  • 部门及用户均可同步
  • 当用户没有注册的时候，系统自动创建成员，默认账号即手机号，默认密码即租户门牌号+手机号，租户门牌号管理员可以在租户管理中找到

  • 当成员存在系统中，但当前租户中没有该成员，则默认加入当前租户
  • 当成员存在系统中，存在当前租户中，直接做更新操作

注意：当部门同步出现多条数据时（即重复数据），请查看一个企业下是否存在多个应用id对应不同的租户

发送钉钉模板消息​

1. 推送接口说明​

  • 请求路径：/sys/thirdApp/sendMessageTest
  • 请求参数：
    • app：'第三方app类型'，必填(DINGTALK)
    • receiver：'用户账号，选填（admin）,该用户账号需要和钉钉同步过
    • sendAll：是否发给所有人，选填 true或false，与receiver需要填写其中一个
    • content：必填，文本内容
  • 请求头
    • X-Access-Token：token认证，必填
    • X-Tenant-Id：租户id，选填，默认为0，但必须该租户下已对接钉钉配置
  • 请求方式：POST

2. 发送消息​

  • 使用postman发送钉钉测试消息

  • 效果展示