SRM接入企业微信文档
参考官网地址:https://developer.work.weixin.qq.com/tutorial/detail/56
maven及代码参考:https://gitee.com/binary/weixin-java-tools
# 一、登录企业版企业微信
访问网址https://work.weixin.qq.com/登录企业微信.如下图所示.
# 二、创建应用
选择【应用管理】TAB,创建自建应用.如下图所示.
填写应用基本信息。例如:应用LOGO、应用名称、应用介绍、可见范围,填写完成后点击创建应用.如下图所示.
# 三、开启企业微信接入SRM相关配置
开启企业微信授权登录
点击设置按钮,设置授权回调域.填写回调地址并保存.例如:SRM测试环境回调域名为:sso.ith-test.ithcloud.com
开启网页授权及JS-SDK.点击【网页授权及JS-SDK】.填写登录(SSO)对应的域名地址.按下图所示设置.
配置企业可信IP.点击配置【企业可信IP】,如下图所示。例如配置:112.123.8.160。该ip调用企业微信接口时会提示.
# 四、Nacos中配置企业微信参数
接入企业微信需要配置corpId(企业微信ID)、agentId(应用ID)、corpSecret(应用密钥)、redirectUri(回调地址)等参数.
corpId: 登录企业版企业微信,点击我的企业,获取企业ID.如下图所示.
agentId: 点击应用管理,点击上述新创建的应用。获取应用ID.如下图所示.
corpSecret: 点击应用管理,点击创建的应用.点击查看获取应用密钥.如图下图所示.
redirectUri:上述配置的回调地址->http://sso.ith-test.ithcloud.com
将corpId、agentId、corpSecret、redirectUri配置到nacos中weixin-{active}.yaml中.如下图所示.
Nacos中配置好参数后,需要重启Message服务.将会自动加载企业微信的配置信息.
# 五、单点登录绑定接入案例
企业微信扫码会携带code重定向到redirectUri。格式为:redirectUri?code=xxxxx,根据code调用企业微信获取用于接口获取用户信息。如下图所示.
根据获取的唯一表示校验第三方登录关系绑定表(sys_account_threelogin)是否存在数据,不存在则将唯一表示返回给前端并重定向到登录页面,如下图所示,输入账号及密码登录即可绑定.
# 六、消息通知接入案例
通过上述已经将企业微信和SRM中账号进行了绑定。根据SRM中唯一表示即可找到为企业微信唯一标识。通过企业微信唯一表示即可发送消息.如下图所示.
# 七、企业微信接受消息展示
消息模板可以自行配置,下列只展示部分模板。
审批流节点变化模板:您发起的审批:${procName},审批编号:${executionNo}有了新的进度,请及时关注!
供应商审核订单模板:您发布的订单:${orderNumber},供应商${resultMsg},请及时关注!
招标审核模板:您有一个招标项目${biddingId}需要审核,请及时处理
效果: