Chat BI钉钉H5集成方案

1. 概述

本文指导如何将 ChatBI 集成钉钉H5应用，进行智能问数。

2. 前提条件

客户在BI平台已配置完成钉钉账户集成，钉钉账户集成方案见钉钉完全集成方案。

3. 集成方案

方案一：在BI移动门户中添加Chat BI问数

在BI移动门户轻应用中添加Chat BI问数，目前是通过「移动端门户添加应用 > 应用页面中添加外链 > 外链卡片中内嵌/chatbi路由」实现。

操作步骤

入口：数据应用 > 移动端 > 门户

点击「编辑」进入编辑界面。

找到需要放置Chat BI入口的应用组，点击「添加 > 外链」，移动门户相关操作可参考移动门户。
配置外链「名称」和「链接」后单击「确定」，每个主题对应一个外链。
- 名称：自定义应用名称，建议与主题名称保持统一。
- 链接：{环境域名}/m/chatbi/{主题ID}，主题ID如何获取请参考获取主题ID。
点击「保存」完成配置。

实现效果

在门户中区分不同Chat BI问数主题入口，用户根据实际需求进入具体主题进行问数。

注意事项

如果iOS手机出现卡片滑动的情况，可以通过添加前端插件的方式解决（需要iOS版本在16.0.0以上）。

前端插件添加入口

管理中心 > 开放平台 > 插件管理，详细操作请参考插件管理。

代码示例

GD.on('gd-ready', () => {

// pageMobileLayout

GD.dispatch('style', { title: '黑白', content: 'html, body, body *{ overscroll-behavior: none; }' })

})

方案二：在钉钉开放平台进行应用集成

操作步骤

登录钉钉开发者后台，申请「开发者权限」后，在「应用开发 > 企业内部应用 > 钉钉应用」界面，找到已与观远数据完成集成的ChatBI应用，点击右侧「... > 应用详情」，进入应用详情界面。
找到「添加应用能力 > 网页应用」，点击下方「添加」。
填入「应用首页地址」后点击「保存」，首页地址：{环境域名}/chatbi/地址。

如需免密登录，则需配置免密登录链接，免密登录链接从BI平台「管理中心 > 系统集成 > 办公OA > 钉钉」界面复制，并拼接高亮部分内容。
- 应用首页地址示例：https://oapi.dingtalk.com/connect/oauth2/sns_authorize?appid=dingkyrvdtjmuozxwwaq&response_type=code&scope=snsapi_auth&state=app&redirect_uri=https%3A%2F%2Fapp.guandata.com%2F==m%2FchatBI%2F==%3Fprovider%3Ddingtalk%26domain%3Djpyy`
- PC端首页地址示例：https://oapi.dingtalk.com/connect/oauth2/sns_authorize?appid=dingkyrvdtjmuozxwwaq&response_type=code&scope=snsapi_auth&state=pc&redirect_uri=https%3A%2F%2Fapp.guandata.com%2F==chatBI%2F==%3Fprovider%3Ddingtalk%26domain%3Djpyy&ddtab=true
在「开发配置 > 权限管理」界面，开通「成员信息读权限：qyapi_get_member」。