应用对接

何谓应用对接

所谓应用对接，即我们要让飞书自建应用和Excel服务器应用互相能找到对方。

在Excel服务器应用中，我们要登记飞书自建应用的几个参数：App ID和App Secret。

在飞书自建应用中，我们要登记Excel服务器应用首页网址等。

以下具体看两方的设置方法。

在Excel服务器中登记飞书信息

以管理员身份登录到Excel服务器填报网站ESWeb，点击上方工具栏中的【移动端设计】按钮，进入移动端设计门户，点击左侧菜单【集成】-【飞书】，进入飞书配置页面，如下图:

设置服务器

看“配置飞书”页面上“前期准备”的部分第3项，如果显示“还未设置过”，则点击右侧的【设置】按钮，去设置服务器（也就是Excel服务器填报网站所在的域名和外网ip地址）。

登记飞书应用信息

打开自建应用页面，选中“凭证与基础信息”，复制粘贴App ID和App Secret，到配置飞书页面的第三部分。

注意复制了之后，第四部分的“应用首页地址”也随即变化。

点击【完成】，页面不要关闭，接下来需要把第四部分的信息复制到飞书中去。

在飞书中登记Excel服务器信息

添加应用能力

回到飞书开放平台，点击左侧菜单栏的【添加应用能力】，添加“网页应用”、“机器人”。

添加网页应用：

将Excel服务器配置飞书页面上的“应用首页地址”，填到飞书网页应用当中的桌面端主页和移动端主页当中，点【保存】。

添加机器人：

开通机器人，发送消息需要机器人

权限管理

选中左侧【权限管理】菜单，右侧点击【开通权限】：

勾选获取用户User ID contact:user.employee_id:readonly；

更新服务台资源详情helpdesk:all；

获取与发送单聊、群组消息 im:message；

以应用的身份发送消息 im:message:send_as_bot。

安全设置

选择“安全设置”菜单，添加两条重定向URL：

https://完整域名(非443端口的需要添加端口号)/ESWeb/FsLink

https://完整域名(非443端口的需要添加端口号)/ ESWeb/FsLink/本应用AppId

注意：一定要和实际使用的网站地址大小写一样。

配置H5可信域名，需要配置两条：

https://完整域名(非443端口的需要添加端口号)/ESWeb/iesweb/m.html

https://完整域名(非443端口的需要添加端口号)/ESWeb/FsLink/本应用AppId。