企业微信、钉钉及飞书接入指南

巴别鸟企业微信、钉钉、飞书接入指南

企业微信接入配置说明

获得相关信息（提供给巴别鸟）

1）企业 CropId

在此获得企业的cropId

2）应用 AngentId， Secret

通过创建内部

添加完自己的应用后，点开 san

获得agentId 与secret

配置工作台主

点击工作台应用主页

https://open.weixin.qq.com/connect/oauth2/authorize?appid=XXXXXXXXXXX&redirect_uri=http%3A%2F%2Fprivate.babel.cc%2Faccount%2FentWechatInnerSigninRedirect.do&response_type=code&scope=snsapi_base&state=STATE#wechat_redirect

替换其中的 appid = “XXXXXXXXXXXX”;更改为自己的cropId

//redirct_uri替换成自己的 scheme 和 domain 如 http , private.babel.cc

开发者接口

1). 网页授权及JS-SDK 配置可信域名如 private.babel.cc （需要使用微信JS-SDK, 需完成域名归属验证，并将验证文件发给巴别鸟）

点击网页授权及JS-SDK

可信域名中输入自己的域名

再申请域名校验，并获得验证文件

2). 企业微信授权登录

点击企业微信授权登录

配置web网页，扫码登录，在授权回调域中输入自己的企业域名(同可信域名)

如 private.babel.cc

配置 ios应用，输入的BundleID 需从巴别鸟获得, 并将生成的schema 发送给巴别鸟

配置 android应用，输入的应用签名与应用包名需从巴别鸟获得，并将生成的schema 发送给巴别鸟 (android 的schema 同ios 的schema)

钉钉企业内部应用配置说明

第一部分新建H5微应用

登录钉钉企业管理后台

钉钉企业管理后台登录网址https://oa.dingtalk.com/#/login，没有企业账号的，先注册，注册按照钉钉的注册流程即可。注意需要钉钉的管理员账号登录，因为后面新建内部应用需要有管理员权限。

新建企业内部H5微应用

1，登录钉钉开放平台

第一种方式，管理员登录成功后，点击顶部的【工作台】，找到【自建应用】，然后点击自建应用按钮。

第二种方式，管理员登录成功后，在同一个浏览器中输入https://open-dev.dingtalk.com/#/index，打开网址，进入到开钉钉开放平台，如果你未登录，再登录一次。

2，新建H5微应用

进入到开钉钉开放平台后，点击顶部的【应用开发】，然后在侧边栏点击【企业内部开发】下的【H5微应用】，最后点击【创建应用按钮】

按照钉钉的要求填写应用的基本信息，开发方式选择【企业内部自主开发】

点击下一步，进入以下界面，配置开发信息界面。开发模式选【开发应用】，开发应用类型选【微应用】，其它的按钉钉要求填写。应用首页地址填写巴别鸟文档管理系统私有化后的服务器网站首页网址，服务器出口IP填写上述网址对应的IP地址，这个地址必须填写正确，否则钉钉很多功能将无法使用。点击【创建】按钮，创建应用成功。

给应用开启权限

创建应用成功后进入以下界面。点击【接口权限】

在【接口权限】界面，基础权限是默认开通的。

高级权限-企业通信录权限，需要我们手动开通，点击后面每行权限对应的按钮开通相应的权限，我们需要企业通信录的所有权限，以实现巴别鸟账号与钉钉账号打通。权限开通后如下：

至此，应用的创建与配置已经完毕。

接入巴别鸟文档管理系统

巴别鸟文档管理系统与钉钉对接，需要提供钉钉应用的信息，CorpId，AppKey，AppSecret。

获取CorpId。

登录钉钉开放平台后，点击顶部【首页】，在首页页面就可以查看CorpId。

获取AppKey，AppSecret。

登录钉钉开放平台后，点击顶部【应用开发】，左边侧栏选择【企业内部开发】--> 【H5微应用】，然后点击自己新建的应用，进入应用详细页面。

应用详情页面：

在这里便可以查到AppKey，AppSecret：

将获取到的CorpId，AppKey，AppSecret提供给巴别鸟的相关人员即可。

应用发布

相关配置及巴别鸟文档管理服务器准备就绪后，就可以发布H5应用了。进入应用详情页面，选择【应用发布】，然后点击【确认发布按钮】。

第二部分钉钉扫码登录

钉钉授权登录配置

登录钉钉开放平台后，点击顶部【应用开发】，左边侧栏选择【移动应用接入】--> 【登录】，然后点击按钮【创建扫码登录应用授权】，创建扫码登录应用授权。

获取登录appId，appSecret

创建扫码登录应用授权成功后，在【登录】页面的列表里可以查询到应用的appId，appSecret。

将获取到的appId，appSecret提供给巴别鸟的相关人员即可。

飞书企业内部应用配置说明

第一部分新建H5微应用

一、登陆飞书管理后台，点击应用管理

创建企业自建应用

输入相应的信息并确定创建

获取凭证与基础信息，并将获得的APP ID与APP Secret 发给巴别鸟

在应用功能项下点击网页输入网页配置，配置相应的地址

https://open.feishu.cn/open-apis/authen/v1/index?app_id=XXXXXXXXXX&redirect_uri=http%3a%2F%2Fprivate.babel.cc%2Faccount%2FfeishuQRScanRedirect.do&state=STATE

app_id与地址需要替换成相应自己应用的

应用功能下打开机器人功能，以实现消息发送

需打开相应的权限，在下面权限设置中添加

应用功能下打开移动应用登录功能，以实现巴别鸟APP端，以飞书应用授权登录

用户登录协议 OAuth2.0

iOS应用配置 iOS Bundle ID 联系巴别鸟获取

android应用配置请联系巴别鸟获取

安全设置，需要设置重定向URL 与IP 白名单

重定向URL http://private.babel.cc/account/feishuQRScanRedirect.do，用自己网盘地址及http/https 替换private.babel.cc

IP 白名单，为部署是务器的公网IP地址

H5 可信域名设置为相应的网盘服务器地址

权限管理，暂时开通的权限有：

以应用身份读取通讯录

获取部门基础信息

获取部门组织架构信息

获取用户基本信息

获取用户组织架构信息

获取用户邮箱信息

获取用户 user ID

通过手机号或邮箱获取用户 ID

获取用户手机号

获取与发送单聊、群组消息

获取用户在群组中@机器人的消息

接收群聊中@机器人消息事件

获取用户发给机器人的单聊消息

以应用的身份发消息

给一个或多个部门的成员批量发消息

给多个用户批量发消息

发布应用

创建版本，提交版本