企业微信集成

目前 RB 与企业微信集成的功能包括用户认证（免登）、扫码登录、消息通知、组织架构同步等，后期逐步开放更多集成功能。介于企业微信有着非常灵活的功能配置，因此 RB 仅能集成那些较为通用的功能，如你有其他需求，也可以联系我们进行开发定制。

? 配置企业微信集成必须使用域名，且域名备案主体与微信认证主体一致，请提前准备

? 自 2022.06 起，企业微信将进行 安全性升级，你需要为新建应用 配置企业可信 IP 后方可使用

配置

创建应用 (1/5)

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

1. “应用 logo”可直接 下载 RB 的图标使用
2. “应用名称”随意填写，如 REBUILD
3. “应用介绍”为选填，如 REBUILD
4. “可见范围”表示哪些部门/用户可以使用（如需 同步组织架构 请选择根部门）

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

配置应用凭证 (2/5)

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

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

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

配置应用主页 (3/5)

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

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

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

配置网页授权 (4/5)

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

• 进入 RB 管理中心 - 服务集成 - 企业微信，复制“可信域名”粘贴到截图中 (1) (2) 处
• 下载 (3) 处的文件，将其上传至 RB 管理中心 - 服务集成 - 企业微信“可信域名效验文件”
• 最后点击 [确定] 即可

? 必须使用域名配置，且域名备案主体与微信认证主体一致。如未配置此项，扫码登录与字段扫码功能将不可用

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

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

至此，配置完成。

同步组织架构

你可以在 RB 中开启自动同步组织架构（用户、部门）功能，支持自动、手动同步。如果正确配置了 邮箱服务，且新同步用户邮箱已设置，系统会自动向新用户发送账户开通邮件提醒。

? 请注意仅支持同步“可见范围”内的部门/用户

1. 是否启用自动同步，开启后系统每小时自动同步 1 次。你也可以点击 [立即同步] 手动同步
2. 若首次使用同步，且 RB 中已添加过用户，采用何种方式与企业微信用户账户绑定，可选值包括邮箱、用户名或姓名
3. 指定新用户的默认角色，由于没有角色的用户不可用，因此如不填写将导致新同步用户不可直接使用，直到你为其指定了角色。此项应根据你的需求确定是否填写

同步后用户即自动绑定对应的企业微信账户，经由系统自动同步的用户/部门会显示同步标识。

? 请注意若使用“姓名”匹配，请确保无重名用户，否则绑定可能出错

? 从 V4.2 开始，对于已存在的部门，系统会使用部门名称进行匹配自动绑定

在企业微信中使用

手机端

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

PC 端

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

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

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

绑定后即可在企业微信中即可免登录使用（不用每次使用都输入用户名密码），同时 通知 也会自动推送到企业微信上

扫码登录配置

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

配置企业微信授权登录

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

至此，配置完成。现在可以通过扫码登录了。

AI 助手集成 ~~v4.5

REBUILD 支持将 AI 助手接入企业微信智能机器人，用户在企微单聊或群聊中 @机器人 发送消息即可获得 AI 回复。机器人会先回复"正在思考..."提示，AI 处理完成后再发送最终回答。

创建智能机器人

进入 企业微信管理后台 - 安全与管理 - 管理工具，进入“智能机器人”页面，点击 [创建机器人] 进入创建页面。

请填写名称、可见范围等信息，并记录下页面显示的 Token 和 EncodingAESKey。

配置回调地址

在上一步的机器人配置页选择"使用 URL 回调"，在 URL 处填入管理中心 - 服务集成 - 企业微信“AI 助手集成”中显示的 URL，然后将机器人页面的 Token 和 EncodingAESKey 填写到 REBUILD 对应字段中并保存。

保存后点击企业微信页面的 [验证] 按钮，REBUILD 会自动完成回调验证。验证通过即表示配置成功。

使用方式

在手机或 PC 端企业微信中，找到刚创建的智能机器人发起对话：

• 单聊：直接发送消息即可
• 群聊：需要 @机器人 发送消息

机器人收到消息后会立即回复"正在思考..."，AI 处理完成后自动发送最终回答。

常见问题

redirect_uri 需使用应用可信域名

出现此错误提示表示相关域名配置不正确，请检查各域名配置是否有误。以下两种情况会遇到此问题：

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

无法同步用户的手机、邮箱

手机、邮箱属于敏感数据，对于早期创建的（企业微信）应用，可以正常同步用户手机、邮箱。后期则不再支持获取，你可能需要手动维护用户的手机、邮箱。