企业微信集成 ~~v2.5

目前 RB 与企业微信集成的功能包括免登录与消息通知等,后期逐步开放更多集成功能。介于企业微信有着非常灵活的功能配置,因此 RB 仅能集成那些较为通用的功能,您也可以联系我们进行开发定制。

配置企业微信集成必须使用域名,企业微信禁止使用 IP 地址配置,如无域名可以考虑使用如花生壳之类的动态域名服务商

配置

创建应用 (1/4)

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

  1. “应用 logo”可直接 下载 RB 的图标使用
  2. “应用名称”随意填写,如 REBUILD
  3. “应用介绍”为选填,如 REBUILD
  4. “可见范围”表示哪些部门/用户可以使用,请根据实际需要添加

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

配置应用凭证 (2/4)

应用创建后会自动转入应用配置页面,如下图所示:

将“AgentId”“Secret”复制粘贴到 RB 管理中心 - 服务集成 - 企业微信,“应用凭证”区域的对应字段中。

请注意下方的“企业 ID”字段,需要至企业微信管理后台 - 我的企业 - 企业信息 中获取,如下图所示:

配置应用主页 (3/4)

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

  1. 选择“网页”
  2. 输入在 RB 管理中心 - 服务集成 - 企业微信 中的“应用主页”粘贴到此处
  3. 勾选“在微信插件中始终进入主页”
  4. 最后点击 [确定] 按钮

? “应用主页”与“可信域名”实际是使用了 RB 通用配置中的“主页地址/域名”,请确保其为正确的地址,且可以被外网访问

配置网页授权 (4/4)

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

  1. 输入在 RB 管理中心 - 服务集成 - 企业微信 中的“可信域名 ”粘贴到截图箭头所指出
  2. 下方的“可调用 JS-SDK、跳转小程序的可信域名”不用设置,留空即可
  3. 最后点击 [确定] 按钮

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

在企业微信中使用

手机端

登录手机版企业微信 - 工作台,即可看到已发布的 RB 应用,点击开始使用。

PC 端

登录 PC 版企业微信 - 工作台,即可看到已发布的 RB 应用,点击开始使用。

RB 会自动判断企业微信客户端环境,如使用手机访问将自动打开手机版

首次打开,系统会要求用户授权/绑定,请输入正确的 RB 用户名密码绑定即可。同时注意一个企业微信用户只能绑定一个 RB 用户,不可重复绑定。如需解除绑定,可以登录 RB(PC 端),点击右上角用户名 - 个人设置,在“安全设置”中进行解绑。

扫码登录配置

可以通过企业微信扫码登录 RB,此配置是可选的,如不需要可以忽略此配置。

配置企业微信授权登录

  1. 进入 RB 管理中心 - 服务集成 - 企业微信,然后复制“可信域名”备用
  2. 进入(上节中创建的)应用,拉动到页面底部“开发者接口”区域,点击“企业微信授权登录”下方的 [设置] 进入配置页
  3. 最后设置并保存“可信域名”即可

至此,配置完成。您可以通过扫码登录 RB 了。

常见问题

redirect_uri 需使用应用可信域名

出现此错误提示,说明相关域名配置不正确,请检查各域名配置有误。以下两种情况会遇到此问题:

  1. 在企业微信工作台中使用时,出现此问题的原因是“网页授权”未设置或设置错误,请参考 配置网页授权
  2. 扫码登录时,出现此问题的原因是“授权回调域”未设置或设置错误,请参考 配置企业微信授权登录

该文档内容对您是否有帮助?没有
如有任何疑问,请与我们的 社区QQ 群 联系
Updated 9/9/2021, 10:38:54 AM