高阶教程-集成企业微信

本节内容将详细展示如何将本平台以自建应用的形式集成到企业微信，同时支持使用工作流向指定企微成员发送消息

1.创建自建应用

点击登录企微管理后台，并进入应用管理

滑到页面最底部，点击创建应用

上传logo、并填写相关信息后创建应用

填写应用的主页地址（这里填写应用的访问地址）

提示

至此，企微自建应用就创建完成了，被授权的企微用户就可以在工作台使用刚刚创建的企微应用了

2.配置可信域名与IP白名单

特别说明

企业微信限制：如果自建应用需要调用企微API，则必须配置可信域名与IP白名单

此部分需要对nginx有一定的了解

2.1 配置可信域名

这里的域名需要填写当前企业已经备案通过的域名，填写的域名需要能够正常打开会众云平台

注意

这里需要在服务器上配置域名的nginx反向代理，配置后才可以使用域名访问平台

下载上面的校验文件：WW_verify_uIIikz7JD9fvnWZg.txt，并配置到nginx中

配置示例

# 在nginx的server内添加以下内容（名字及内容需要替换）
location ^~ /WW_verify_uIIikz7JD9fvnWZg.txt {
  default_type text/html;
  return 200 '5358d4854e04cfa7e93c252486e33361';
}

配置完成后，重启nginx服务，可以在浏览器中输入完整地址测试获取文件内容

2.2 配置企业可信IP

配置完可信域名后，就可以配置可信IP

3.获取接口访问凭据

企微的接口请求都需要接口凭据：accessToken。获取到的accessToken有效期为两个小时，我们需要在凭据失效对其进行刷新

点击查看获取accessToken文档

3.1 创建企微配置表

创建一张企微配置表，用于保存企微的相关参数，以及获取到的accessToken

参数说明

企微corpid：企业ID（每个企微组织有且仅有一个唯一的ID）

企微agentid：企微应用ID（每个自建应用都有一个唯一的应用ID）
企微corpsecret：企微应用秘钥

3.2 循环获取凭据

由于企微accessToken的有效期是两个小时，所以我们需要创建一个定时触发工作流，然后每小时去重新获取一下accessToken

触发节点配置

查询节点配置

请求节点配置

更新节点配置

4.调用企微接口

当获取到accessToken后，就可以调用企微的接口进行业务处理了

4.1 发送应用消息

点击查看企微发送应用消息接口文档

创建一个业务流程，用于向指定成员发送消息