企业微信集成移动BOS应用（代理）

栏目：eas cloud知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：3

企业微信集成移动BOS应用（代理）

一、前言：

移动BOS应用可集成到企业微信，暂不支持微信小程序；

移动BOS是公网应用，要求客户的EAS服务器有公网可访问的地址；

EAS服务器会访问企业微信的接口，需要EAS能访问到https://qyapi.weixin.qq.com，一般能访问公网就没有问题；

本集成过程适用于EAS8.0及以上版本，EAS7.5以下的将不再支持，建议升级EAS。

二、移动BOS应用配置

1、获取客户企业微信的企业id

企业id（eid）用作客户在移动BOS平台的唯一标识，对应客户唯一的eas服务，要用企业微信管理人员登录管理后台查看，如下图：

2、企业微信上创建应用

企业微信管理人员登录管理后台,创建应用，如下图：

3、配置可信域名

可信域名是mbos应用链接域名

4、配置企业可信ip

即EAS服务器出口ip，配置上客户已知的所有出口ip，

不知道出口ip？----> windows：eas服务器上百度ip。linux：控制终端命令：curl ifconfig.me。

这里查询到的出口ip不一定正确，那就等集成完应用报错了去看apusic日志吧！

5、记录agentid和secret，

这两参数部署时使用，如下图

上传图片

6、配置应用主页链接

应用使用自定义菜单，保存并发布应用就生效了；因应用都有可见范围，不建议一个应用使用多菜单配置多个移动bos应用

主菜单可命名为应用主页；为方便说明，网址链接的参数都做了换行处理，红色字体的都是需要修改的部分

https://open.weixin.qq.com/connect/oauth2/authorize?

redirect_uri=https://mbos……

&response_type=code

&scope=SCOPE

&agentid=1000002

&appid=wwf364e607……b0

&state=wwf364e607……b0

#wechat_redirect

agentid参数改为应用实际生成的；
appid和state参数使用企业微信的eid；
redirect_uri是移动BOS应用的链接地址，需要编码（urlencode）；
不知道如何编码？点击这里来这里学一下！

以下是标准应用在编码之前链接接，需要修改eid和agentid，编码后作为redirect_uri参数

1）、流程助手：https://mbos.........com/mbos/page/loadPage?storeEid=21231&path=lczs2&name=lczslist.custom&eid=ww8d8b37d48d.....8&agentid=1000002

2）、现场开发的应用：在移动BOS上的开发的应用,可在预览页面获取到应用的链接，在链接后面加上agentid参数即可。

3）、SHR标准应用：员工自主、经理人自助、天天勤等，可通过专项服务咨询相关人员提供，提供的链接修改一下agentid参数。

流程助手为例，处理后得到的菜单网址链接为:

https://open.weixin.qq.com/connect/oauth2/authorize?redirect_uri=https%3a%2f%2fmbos........com %2fmbos%2fpage%2floadPage%3fstoreEid%3d21231%26path%3dlczs2%26name%3dlczslist.custom%26appid%3d10036%26eid%3dww8d8b37d48d83b0c8%26agentid%3d1000002&response_type=code&scope=SCOPE&agentid=1000002&appid=ww8d8xxxxxxxxxxx&state=ww8d8xxxxxxxxxxx#wechat_redirect

需要说明的是，用户初次在企业微信上使用移动BOS应用时没有绑EAS账号，会弹出绑定EAS账号的界面，手动输入账号密码进行绑定，有绑定的账号以后都能实现单点登录。

用户绑定关系表为：t_pm_easwxusermap，要解除绑定可以删除这个表中对应用户的记录。