本文为您介绍如何将 DataWind 接入钉钉应用。

可以通过在钉钉侧自建应用的方式，完成钉钉集成。
常见应用场景：

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

1. 在钉钉租户中创建应用。
   1. 打开链接后，点击「自建应用」。
      
   2. 网页界面会跳转到如下图所示，点击「创建」。
      
   3. 网页界面会跳转到如下图所示，点击「创建应用」。
      
2. 填写应用信息。
   可以使用您喜欢的应用名称和应用图标，创建应用。
   
3. 配置白名单。
   为调用钉钉的接口，需要进行相应的安全设置。
   创建应用后，网页界面会跳转到如下图，点击「安全设置」。
   

   注意

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

   • 对于SaaS版本的用户，需要将下列IP设置为白名单，即「服务器出口IP」：
     180.184.64.81,180.184.87.232,180.184.102.141,14.103.128.84
     同时，需要将重定向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进行相应设置。
4. 设置权限。
   
   用户在左侧的权限管理处可以设置应用权限和可见范围，必选以下权限：
   • 通讯录部门信息读权限
   • 成员信息读权限
   • 根据手机号获取成员基本信息权限
   • 通讯录部门成员读权限
   • 企业外部联系人读取权限
   • 钉钉群基础信息读权限
5. 发布应用。
   点击「版本管理与发布」，然后点击右上角的「创建新版本」。
   
   在填写好版本信息后，点击「发布」，当前应用就上线了。
   
6. 办公平台集成与用户账号绑定。
   在「凭证与基础信息」中，找到应用凭证，可以获取AgentId、Client ID（即AppKey）、Client Secret（即AppSecret）。
   
   点击左上角「首页」返回。
   
   在页面右侧找到CorpId。
   
   然后在智能数据洞察完成办公平台集成，详见办公平台集成；
   再前往用户绑定帮助文档进行智能数据洞察与钉钉的用户绑定，详见系统管理概述-SaaS版；
   绑定之后用户就可以接收钉钉的消息推送了。

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

配置域名

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

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

• 首页：https://【域名】/bi-h5/?corpId=$CORPID$&【地域】
• 示例：如果【域名】为 console.volcengine.com，CORPID为12345，【地域】为上海，那么首页网址为：https://console.volcengine.com/bi-h5/?corpId=12345&region=cn-shanghai；

  说明

  SaaS 版本的访问地域信息如下，更多可查看访问地域与火山云内网连接：

  • 华北2-北京：region=cn-beijing
  • 华东2-上海：region=cn-shanghai
  • 亚太东南-柔佛：region=ap-southeast-1
• 修改完后记得再发布一下应用即可。

手机工作台

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

推送场景

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