You need to enable JavaScript to run this app.
导航
接入钉钉应用
最近更新时间:2023.12.25 17:21:05首次发布时间:2021.08.17 11:04:48
1. 概述

可以通过在钉钉侧自建应用的方式,完成钉钉集成。

常见应用场景

  • 仪表盘订阅
  • 图表监控报警
  • 数据集同步结果通知推送

注意

  • 相关操作需要通过钉钉的开放平台自建应用的方式完成,钉钉开放平台的相关配置界面会不定期迭代,特此提醒您,请以最新的配置界面为准。
2. 前置配置说明

第一步:在钉钉租户中创建应用

https://oa.dingtalk.com/index.htm#/microApp/microAppList

打开链接后,点击「自建应用」。
alt
网页界面会跳转到如下图所示,点击「创建」。
alt
网页界面会跳转到如下图所示,点击「创建应用」。
alt

第二步:填写应用信息

可以使用您喜欢的应用名称和应用图标,创建应用。
alt

第三步:配置白名单

为调用钉钉的接口,需要进行相应的安全设置。

创建应用后,网页界面会跳转到如下图,点击「安全设置」。
alt

注意

在此步骤中,以下配置SaaS和私有化部署有所区分,请用户留意。

对于SaaS版本的用户,需要将下列IP设置为白名单,即「服务器出口IP」
180.184.64.81,180.184.87.232,180.184.102.141
同时,需要将重定向URL设置为:
https://console.volcengine.com/bi/datawind/#,https://console.volcengine.com/bi/datawind#/,https://console.volcengine.com/bi/datawind#/dataManage,https://console.volcengine.com/bi/datawind/#/dataManage,https://console.volcengine.com/bi/datawind/auth#/dataManage,https://console.volcengine.com/bi/datawind/auth/#/dataManage,https://console.volcengine.com/bi/datawind#/dataPrep,https://console.volcengine.com/bi/datawind/#/dataPrep,https://console.volcengine.com/bi/datawind/auth#/dataPrep,https://console.volcengine.com/bi/datawind/auth/#/dataPrep,https://console.volcengine.com/bi/datawind/#/prep/dataLink/authCallback/lark_sheet,https://console.volcengine.com/bi/datawind/#/prep/dataLink/authCallback/lark_bitable

对于私有化部署的用户,请根据公司内部的IP与URL进行相应设置。

第四步:设置权限
用户在左侧的权限管理处可以设置应用权限和可见范围,必选以下权限:

  • 通讯录部门信息读权限
  • 成员信息读权限
  • 根据手机号姓名获取成员信息的接口访问权限
  • 通讯录部门成员读权限
  • 企业外部联系人读取权限
  • chat相关接口的读取权限

alt

第五步:发布应用
点击「版本管理与发布」,然后点击右上角的「创建新版本」。

alt

在填写好版本信息后,点击「发布」,当前应用就上线了。
alt
第六步: 办公平台集成与用户账号绑定

在「凭证与基础信息」中,找到应用凭证,可以获取AgentId、Client ID(即AppKey)、Client Secret(即AppSecret)。

alt

点击左上角「首页」返回,找到CorpId。
alt
alt

然后在智能数据洞察完成办公平台集成,详见《办公平台集成》
再前往用户绑定帮助文档进行智能数据洞察与钉钉的用户绑定,详见《企业域管理-用户账号关联》

绑定之后用户就可以接收钉钉的消息推送了。

3. 接入移动端

完成「2. 前置配置说明」内的所有操作后,在钉钉的应用管理页面继续完成如下操作:

3.1 配置域名

在添加应用能力中,点击添加网页应用。
alt
然后在网页应用中配置应用地址等相关信息。
alt

  • 首页: https://【域名】/bi-h5/?corpId=$CORPID$
  • 示例:如果【域名】为 bi.xxx.com,首页为:https://bi.xxx.com/bi-h5/?corpId=$CORPID$
  • 修改完后记得再发布一下应用即可

3.2 手机工作台

将此应用固定到手机工作台首页,之后就可以方便地从手机版使用了~
alt

4. 消息推送

4.1 推送场景

支持订阅仪表盘截图发送至钉钉应用。
alt
图表监控消息和应用数据集同步结果会推送至钉钉应用。