作者:管理员  历史版本:1  最后编辑:龚清  更新时间:2024-09-20 15:13

企业微信集成

仅适用于v3+
不管应用是http还是https协议都是适用的

1 环境条件

设置企业微信打开网页免登需要几个必备条件:

  1. 企业微信

  2. 备案的域名

以下面信息例子进行解说:

api服务器:47.106.123.123

端口:280

企业微信:流辰信息

域名:cloud.bpmhome.cn:280

2 域名设置

1.域名必须经过备案,否则微信设置会失败;具体备案过程可以查看域名所在平台相关资料;

2.域名指向api服务器,如cloud.bpmhome.cn -> 47.106.123.123,阿里云中在域名解析中添加下图记录。

注意:域名解析变更有一定的时间才生效,请保持耐心。

3 企业微信设置

访问企业微信官网:http://work.weixin.qq.com 直接扫码登陆,即可进入下图操作页面,需要需要管理员权限。

通讯录设置

将相关使用人员的微信号收集其对应信息,手动添加方式录入在下图中操作菜单,或者员工扫一扫企业微信二维码申请加入企业微信,如图:

注意:加入后需要记住员工账号,后面ibps与企业微信员工对接需要使用;员工账号只能修改一次,请谨慎设置。

应用设置

创建应用

创建应用,填写好信息,点击创建应用,创建应用后界面会包含agentId和Secret,这两个数据会在api设置中应用到,如下图。

设置可信域名

点击“设置可信域名”,输入cloud.bpmhome.cn:280,然后申请校验,下载校验文件,将文件放置于app首页index.html同一目录下,勾选“已上传域名归属校验文件”,确定能通过

http://cloud.bpmhome.cn:280/WW_verify_gvolCG2XdhdYrBsv.txt正确访问文件,然后点击确定,成功后再次点击进去如下图:

注意:

1.域名填写不能带“https://”,只能有域名+端口号;

2.只能使用备案过的域名;

3.不能使用ip代替域名。

访问地址设置

企业微信免登录需要对访问地址作特殊的处理,将app的访问地址包含在企业微信提供的api地址中,例子如下:

app的实际访问地址是

cloud.bpmhome.cn:280/app

应用中填写的地址是

https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxfb97c28ad4dcd17f&redirect_uri=https%3A%2F%2Fcloud.bpmhome.cn%3A280%2Fapp&response_type=code&scope=snsapi_base&state=1#wechat_redirect

注意:

  1. appid填写的是企业微信的企业ID,通过我的企业菜单中可以看到,如下图;

  2. redirect_uri的地址需要加上https://;

  3. redirect_uri部分需要用URL Encode进行转换

参考网站:https://work.weixin.qq.com/api/doc#10028

设置应用主页

设置应用主页后,可以通过点击应用,访问页面:

如果想保留互动界面可以略过不设置。

设置菜单

点击“设置”自定义菜单,进入菜单选项,添加主菜单和子菜单,菜单选择“跳转到网页”,然后在输入框中填上访问地址,具体请查看访问地址设置,如下图:

注:
菜地地址格式(回调地址需要使用url转义):
https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxfb97c28ad4dcd17f&redirect_uri=[APP回调地址]&response_type=code&scope=snsapi_base&state=1#wechat_redirect
如:
https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxfb97c28ad4dcd17f&redirect_uri=https%3A%2F%2Fcloud.bpmhome.cn%3A280%2Fapp&response_type=code&scope=snsapi_base&state=1#wechat_redirect

4 后端设置

修改配置文件

1 修改aouth2server服务的application-app.yml配置文件中与企业微信相关的信息,文件路径如下:

wechat.corpid我的企业中的CorpID

wechat.corpsecret企业应用中自建应用的Secret,具体请看创建应用

wechat. agentId 企业应用中自建应用的AgentId,具体请看创建应用

根据实际企业微信情况修改以上三个参数。

2 修改platform服务的application-app.yml配置文件中与企业微信相关的信息,文件路径如下:

参数值同上第一点,用于

设置账号关联

设置企业微信登陆后与ibps的账号关联,在ibps后台中设置用户的企业微信号,具体步骤如下:

用户管理-员工管理-基本资料-企业微信账号,在企业微信账号中填入已加入企业微信的员工ID,员工ID请查看通讯录设置,如下图:

F&Q

如何设置直达功能模块

想点击app菜单直接到达待办事项列表,查看app路由文件可知待办列表路径为/bpmn/pending,那么在实际访问地址中加上/#/bpmn/pending,然后url encode转码,放到企业微信地址的redirect_url中,具体内容查看访问地址设置,例子如下:

app地址:

https://cloud.bpmhome.cn:280/app

待办列表地址:

https://cloud.bpmhome.cn:280/app/#/bpmn/pendingg

转码后的地址:

https%3A%2F%2Fcloud.bpmhome.cn%3A280%2Fapp%2F%23%2Fbpmn%2Fpending

最终企业微信菜单地址:

https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxfb97c28ad4dcd17f&redirect_uri= https%3A%2F%2Fcloud.bpmhome.cn%3A280%2Fapp%2F%23%2Fbpmn%2Fpending &response_type=code&scope=snsapi_base&state=1#wechat_redirect