集成钉钉

有数提供了钉钉集成的能力,目前仅私有部署版本支持钉钉小程序集成功能。通过钉钉配置可以实现有数与钉钉用户的打通,实现免密登录,登录后可在钉钉端轻松查看有数报告。

  通过在钉钉开发者后台和有数后台的配置,即可实现钉钉集成功能,具体操作步骤如下:

  • 钉钉开发者后台
    • 创建小程序
    • 创建有数小程序
  • 有数后台
    • 有数后台填写钉钉小程序相关配置信息
    • 用户绑定

1.在钉钉开发者后台创建企业小程序

  企业使用管理员账号登录钉钉开发者后台https://ding-doc.dingtalk.com/,登录后进入应用开发-企业内部开发-小程序页面:

集成钉钉 - 图1

  点击[创建应用],进入创建企业自主开发小程序的流程,示例如下:

集成钉钉 - 图2

  企业可填写自己公司的应用名称,上传logo,填写应用简介,选择开发方式为:企业内部自主开发;填写完以上基本信息后,点击下一步,进入如下页面:

集成钉钉 - 图3

  选择开发模式为[开发应用],开发应用类型为[小程序],服务器出口IP需填写有数部署的服务器出口IP,完成后点击[创建],即成功创建小程序。

集成钉钉 - 图4

2.在钉钉工作台上传有数小程序

  创建完成后,进入应用首页-应用开发,可见下图页面,点击应用信息的[查看详情]按钮,可看到小程序的三个重要参数:AgentId、AppKey、AppSecret。

  特别注意:这三个参数后续将填写至有数管理后台!

集成钉钉 - 图5

集成钉钉 - 图6

  接着,进行如下的相关设置:

  • 人员设置

添加开发人员,将企业域内的员工添加为应用开发人员。

集成钉钉 - 图7

  • 设置安全域名

事先设置一个可以进行网络通信的通讯域名和可以被 webview 组件加载的 URL 的域名或IP。

注意:每个企业的具体域名可联系有数的技术支持同事进行设置。

集成钉钉 - 图8

  • 版本管理

在版本管理tab页下上传有数小程序的代码,即可发布小程序的版本。

集成钉钉 - 图9

  添加小程序后,可在如下页面管理开发版本,并设置小程序的可用范围。

集成钉钉 - 图10

  • 接口权限

为了保证有数小程序的正常登录及其他功能,企业必须在[接口权限]tab页下申请开通企业通讯录权限:

集成钉钉 - 图11

3.在有数后台进行钉钉小程序的相关配置

  在有数的管理后台的设置页面,可以对钉钉集成的开启进行控制,若要在钉钉中启用有数小程序,

  首先在[钉钉集成设置]下打开集成开关,其次填写正确的配置信息:钉钉开发者后台提供的AgentId、AppKey、AppSecret。

集成钉钉 - 图12

4.有数用户与钉钉账号的匹配

  有数用户在钉钉上首次登录小程序后,在企业域管理-人员信息页面的人员列表可以看到已匹配用户的基本信息,且该用户下次即可在钉钉端免密登录有数小程序。

集成钉钉 - 图13

  对于部分用户,管理员可手动[设置钉钉匹配],通过钉钉用户的手机号或者姓名与有数用户进行匹配,匹配完成后的用户可以直接在钉钉端免密登录有数小程序。

集成钉钉 - 图14