Skip to content

企业微信对接


目前,美乐低代码 与企业微信集成的功能包括用户认证(免登)、消息通知、组织架构同步等,后期逐步开放更多集成功能。由于企业微信有着非常灵活的功能配置,因此 美乐低代码 仅能集成那些较为通用的功能,您也可以联系我们进行开发定制。

配置

创建应用 (1/5)

使用管理员账户登录并进入 企业微信管理后台 - 应用管理,在页面底部“自建”区域点击 [创建应用] 可进入如下页面。

应用管理

  • “应用 logo”根据需求上传。
  • “应用名称”随意填写,如美乐低代码。
  • “应用介绍”为选填,如美乐低代码介绍。
  • “可见范围”表示哪些部门/用户可以使用,请根据实际需要添加

最后点击 [创建应用] 即可。

配置应用凭证 (2/5)

应用创建后会自动转入应用配置页面,获取"企业微信应用id"和"企业微信应用密钥" 如下图所示:

企业微信应用id和企业微信应用密钥

还需获取 获取"企业微信id",在企业微信管理后台 - 我的企业 - 企业信息 中获取,如下图所示:

配置应用凭证

将得到“企业微信应用id”、“企业微信应用密钥”、“企业微信id”信息复制粘贴到 美乐低代码 开发应用 - 系统通用配置 - 企业微信集成 的对应字段中,然后点击保存。

保存企业微信配置

最后将 “应用首页地址” 保存备用:

保存备用

注意:“应用首页地址”实际上使用了通用配置中的“主页地址/域名”,请确保其为正确的地址,且可以被外网访问。

配置应用主页 (3/5)

进入应用配置页,点击“应用主页”后面的 [设置] 按钮打开设置页。

配置应用主页

  • 选择“网页”
  • 将上一步中复制的“应用首页地址”粘贴到网页地址中
  • 勾选“在微信插件中始终进入主页”
  • 最后点击 [确定] 按钮

配置网页授权 (4/5)

进入应用配置页,在页面最下方找到“开发者接口”-“网页授权及 JS-SDK”,点击“设置可信域名”打开设置页。

配置网页授权

  • 进入美乐低代码 开发应用 - 系统通用配置 - 企业微信集成,复制 “回调域名“ 粘贴到截图(1)(2)处
  • 下载 (3) 处的“可信域名效验文件”,将其上传至 服务器下,确保外网可以直接访问
  • 最后点击 [确定] 按钮

必须使用域名配置且域名备案主体与微信认证主体一致。如未配置此项,企业微信功能不可用

如果服务器使用nginx配置,可参考如下命令:

javascript
  location /WW_verify_J2BZDvAayJT4HnCV.txt {
    alias /data/wechat/WW_verify_J2BZDvAayJT4HnCV.txt;
}

配置企业可信 IP (5/5)

进入应用配置页,在页面最下方找到“企业可信 IP”,点击 [配置] 设置您的服务器 IP 地址。

配置企业可信 IP

至此,配置完成。您现在可以在钉钉客户端中使用 美乐低代码 并通过企业微信接收通知了。

同步组织架构

企业微信的同步组织架构与钉钉逻辑类似,可参考钉钉集成中的同步组织架构

企业微信内部应用

可以在 企业微信 - 工作台 中找到之前配置的应用名称,打开应用即可。

企业微信内部应用

企业微信消息机器人

新增群机器人(1/2)

  • 打开企业微信客户端,进入指定群,单击群设置。
  • 找到 “添加群机器人”。
  • 点击 “新创建一个机器人”, 输入 机器人名称 (必填)后,点击添加 “添加机器人” 按钮。
  • 在新的弹出页面找到“复制地址” 点击备用。如图所示:

新增群机器人

触发器配置机器人(2/2)

  • 进入 美乐低代码 开发应用 - 应用高级设置 - 触发器列表 ,找到自己触发类型为 发送通知 的触发器。
  • 复制上述备用字段 复制到“Webhook地址”,如下图所示:

配置企业微信触发器机器人

  • 输入机器人发送消息内容(支持字段变量)。
  • 配置完成后,点击“保存”,等待触发器触发事件即可,发送成功后效果如下:

企业微信机器人消息效果