企业微信集成移动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_ty