企业微信集成

前提准备

1、注册企业微信账号

注册地址：https://work.weixin.qq.com

2、创建应用

• 上传logo、填写名称并选择可见范围

3、添加可信域名

在开发者接口找到网页授权及JS-SDK，设置可信域名，可信域名为后端访问地址，本地测试可以使用ngrok映射

4、添加可信ip

• 在开发者接口找到企业可信ip

• 如果是测试环境，可以去百度上搜索自己的外网IP（见下图），如果是线上环境，直接填写线上的公网IP即可。

5、配置网页应用

在应用主页中点击设置

前端访问地址/tenantId/租户id

租户id可以在系统管理->租户管理或者我的租户中获取

同步用户部门到本地

找到企业微信的配置AgentId、Secret

找到企业微信的配置AppKey企业ID

将AgentId、AppKey、AppSecret分别录入，录入位置系统管理->第三方配置->企业微信集成

• AgentId对应的是企业微信应用的AgentId，AppKey对应企业微信的企业ID，AppSecret对应的是企业微信应用的Secret

• 请确保AppKey是否在其他组织里未被使用，否则会提示AppKey重复。

点击同步按钮

由于企业微信的通讯录的限制，JEECG在获取用户信息的时候，获取不到用户的手机号、邮箱等敏感信息，JEECG会根据企业微信的姓名去匹配当前组织的系统用户，再由管理员员决定是否关联，如果匹配不正确管理员可以手动关联。

• 点击同步按钮，系统只会匹配没有绑定过的用户
  • 左侧是JEECG当前租户下的账号，右侧是需要绑定的企业微信账号
  • JEECG会根据姓名进行匹配，如果不对，可以移除重新绑定

确认同步，如果用户没被绑定，系统会自动生成一个用户

企业微信同步规则

• 部门及用户均可同步
• 当用户没有注册的时候，系统自动创建成员，默认账号即组织门牌号加上企业微信的账号，默认密码一致，租户门牌号管理员可以在租户管理中中找到

• 企业微信的账号可以在成员信息中找到

• 当成员存在系统中，但当前租户中没有该成员，则默认审核中，由管理员审核通过后方可加入租户
• 当成员存在系统中，存在当前租户中，直接做更新操作
• 同步成功之后可以在“已绑定的企业微信用户”中查看，点击移出则取消绑定系统用户

发送企业微信模板消息

1. 推送接口说明

• 请求路径：/sys/thirdApp/sendMessageTest
• 请求参数：
  • app：'第三方app类型'，必填(WECHAT_ENTERPRISE)
  • receiver：'用户账号，选填（admin）,该用户账号需要和企业微信同步过
  • sendAll：是否发给所有人，选填 true或false，与receiver需要填写其中一个
  • content：必填，文本内容
• 请求头
  • X-Access-Token：token认证，必填
  • X-Tenant-Id：租户id，选填，默认为0，但必须该租户下已对接企业微信配置
• 请求方式：POST

2. 发送消息

• 使用postman发送企业微信测试消息

• 效果展示