企业微信集成
仅适用于v3+
不管应用是http还是https协议都是适用的
1 环境条件
设置企业微信打开网页免登需要几个必备条件:
企业微信
备案的域名
以下面信息例子进行解说:
api服务器:47.106.123.123
端口: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的实际访问地址是
应用中填写的地址是
注意:
appid填写的是企业微信的企业ID,通过我的企业菜单中可以看到,如下图;
redirect_uri的地址需要加上https://;
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
最终企业微信菜单地址: