接入钉钉应用

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

常见应用场景

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

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

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

打开链接后，点击「自建应用」。

网页界面会跳转到如下图所示，点击「创建」。

网页界面会跳转到如下图所示，点击「创建应用」。

第二步：填写应用信息

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

第三步：配置白名单

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

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

对于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相关接口的读取权限

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

在填写好版本信息后，点击「发布」，当前应用就上线了。

第六步： 办公平台集成与用户账号绑定

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

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

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

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

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

3.1 配置域名

在添加应用能力中，点击添加网页应用。

然后在网页应用中配置应用地址等相关信息。

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

3.2 手机工作台

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

4.1 推送场景

支持订阅仪表盘截图发送至钉钉应用。

图表监控消息和应用数据集同步结果会推送至钉钉应用。