目前 RB 与企业微信集成的功能包括用户认证(免登)、扫码登录、消息通知、组织架构同步等,后期逐步开放更多集成功能。介于企业微信有着非常灵活的功能配置,因此 RB 仅能集成那些较为通用的功能,您也可以联系我们进行开发定制。
配置企业微信集成必须使用域名,企业微信禁止使用 IP 地址配置,如无域名可以考虑使用如花生壳之类的动态域名服务商
使用管理员账户登录并进入 企业微信管理后台 - 应用管理,在页面底部“自建”区域点击 [创建应用] 可进入如下页面:
最后点击 [创建应用] 即可。
应用创建后会自动转入应用配置页面,如下图所示:
将“AgentId”“Secret”复制粘贴到 RB 管理中心 - 服务集成 - 企业微信,“应用凭证”区域的对应字段中。
请注意下方的“企业 ID”字段,需要至企业微信管理后台 - 我的企业 - 企业信息 中获取,如下图所示:
进入应用配置页,点击“应用主页”后面的 [设置] 按钮打开设置页。
? “应用主页”与“可信域名”实际是使用了 RB 通用配置中的“主页地址/域名”,请确保其为正确的地址,且可以被外网访问
进入应用配置页,在页面最下方找到“开发者接口”-“网页授权及 JS-SDK”,点击“设置可信域名”打开设置页。
? 必须使用域名配置,且域名备案主体与微信认证主体一致。如未配置此项,扫码登录与字段扫码功能将不可用
进入应用配置页,在页面最下方找到“企业可信 IP”,点击 [配置] 设置您的服务器 IP 地址。
至此,配置完成。
您可以在 RB 中开启自动同步组织架构(用户、部门)功能,支持自动、手动同步。如果正确配置了 邮箱服务,且新同步用户邮箱已设置,系统会自动向新用户发送账户开通邮件提醒。
? 请注意仅支持同步“可见范围”内的部门、用户
?
如用户已在 RB 中添加过,建议先让用户 绑定 企业微信账号,同步时系统会自动建立关联,否则可能出现账号重复
V3.6 可设置“同步用户匹配方式”
同步后用户即自动绑定对应的企业微信账户,经由系统自动同步的用户/部门会显示同步标识。
登录手机版企业微信 - 工作台,即可看到已发布的 RB 应用,点击开始使用。
登录 PC 版企业微信 - 工作台,即可看到已发布的 RB 应用,点击开始使用。
RB 会自动判断企业微信客户端环境,如使用手机访问将自动打开手机版
首次打开,系统会要求用户授权/绑定,请输入正确的 RB 用户名密码绑定即可。同时注意一个企业微信用户只能绑定一个 RB 用户,不可重复绑定。如需解除绑定,可以登录 RB(PC 端),点击右上角用户名 - 个人设置,在“安全设置”中进行解绑。
绑定后即可在企业微信中即可免登录使用(不用每次使用都输入用户名密码),同时 通知 也会自动推送到企业微信上
可以通过企业微信扫码登录,此配置是可选的,如不需要可以忽略此配置。
至此,配置完成。现在可以通过扫码登录了。
出现此错误提示表示相关域名配置不正确,请检查各域名配置是否有误。以下两种情况会遇到此问题: