企业微信集成
巴克励步
概述
Baklib 通过 企业微信 OAuth2 支持成员使用企业微信扫码登录、在工作台打开应用等协同场景。与钉钉类似，集成在 组织管理后台 → 第三方集成 安装配置，需同时在企业微信管理后台创建自建应用并填写回调域。
本篇说明安装入口与企业微信侧参数获取、Baklib 表单填写。钉钉集成见 钉钉集成。
操作步骤
步骤一：进入集成市场
- 打开 组织管理后台 → 第三方集成。
- 点击 添加集成，进入集成市场。
- 找到 企业微信 OAuth2（oauth2，说明：让用户可以通过企业微信扫码登录）。
预期结果：可见企业微信 OAuth2 卡片及 安装 入口。
步骤二：在企业微信创建自建应用
在 Baklib 安装前，先在企业微信管理后台准备应用凭证（表单页亦提供简要指引）：
- 登录 企业微信管理后台。
- 管理企业 → 应用管理 → 自建 → 创建应用，填写应用名称。
- 进入该应用 详情，查看 AgentId 与 Secret。
- 开发者接口 → 企业微信授权登录 → 设置 Web 网页 授权回调域，填入
https://baklib.com。 - 在 我的企业 底部查看 企业 ID。
- 开发者接口 → 企业可信 IP，添加 Baklib 服务器 IP（安装页会提示当前 IP，如
106.75.21.253）。 - 若提示需先验证域名，可到 组织管理 → 域名管理 添加验证地址完成所有权验证。
步骤三：填写 Baklib 安装表单
点击 企业微信 OAuth2 的 安装，填写：
| 字段 | 说明 |
|---|---|
| 企业 ID | 企业微信「我的企业」中的企业 ID |
| AgentId | 自建应用 AgentId |
| Secret | 自建应用 Secret |
| 备注 | 选填 |
- 核对三项与企微后台一致。
- 保存后返回 第三方集成 列表，确认已安装。
- 组织登录页应出现 通过企业微信登录（具体文案以界面为准）。
预期结果：集成列表显示企业微信 OAuth2；测试账号可扫码登录。
步骤四：成员绑定与登录
- 成员在 个人中心 → 账号绑定 中绑定企业微信（若产品要求预绑定）。
- 在组织登录页选择企业微信登录，扫码并确认授权。
- 首次授权按企微提示点击 同意。
预期结果：进入组织内对应 Baklib 成员账号。
步骤五：企业微信工作台快捷应用
- 管理员登录 企业微信管理后台 → 应用管理 → 自建 → 创建应用。
- 填写 Logo、名称、描述与 可见范围，创建应用。
- 在应用详情中配置 自定义菜单：添加主菜单与子菜单，跳转链接可设为组织登录页或对外站点 URL。
- 保存并发布 后，成员在企业微信工作台可见该快捷方式。
预期结果：工作台出现 Baklib 快捷入口，点击可打开配置的 H5 链接。
步骤六：企业微信智能机器人 + Baklib 知识库（可选）
适合在群内 @机器人 自动检索 Baklib 文档并返回原文链接：
方案一：智能机器人绑定 Baklib 公开站点（推荐）
- 企业微信工作台搜索 智能机器人 AI → 新建机器人。
- 在机器人 知识 模块添加知识：
- 网页（实时同步）：粘贴 Baklib 知识库公开站点或分类页 URL，机器人自动抓取文档（可添加多个站点）。
- 本地文件：从 Baklib 导出 Markdown/Word/PDF 后批量上传。
- 开启 引用原文链接；保存后将机器人添加到业务群。
- 群内 @机器人 提问即可返回步骤说明与 Baklib 文档链接。
方案二：文档更新 Webhook 推送
- 在企业微信群 群机器人 中获取 Webhook 地址。
- 在 Baklib 应用 消息通知 / Webhook 中新增企业微信推送，配置触发条件（文档发布、修改等）。
方案三：API 深度对接
步骤七：同步组织架构与员工
与钉钉相同：须先安装 企业微信 OAuth2。在 组织管理后台 → 部门/员工 中执行 同步部门 与 同步员工；部门同步不含员工，员工绑定企微后扫码登录自动归入部门。详细步骤与注意事项见 钉钉集成 步骤六（操作路径一致，来源改为企业微信）。
常见问题
Q：授权回调域填什么？
A：一般填组织工作台根域（如
A：一般填组织工作台根域（如
https://baklib.com），须与 Baklib 实际访问域名一致；私有化部署使用自有域名。Q：提示 IP 不在可信列表？
A：在企微后台 企业可信 IP 中添加安装页给出的服务器 IP。
A：在企微后台 企业可信 IP 中添加安装页给出的服务器 IP。
Q：微信 OAuth2 与企业微信 OAuth2 选哪个？
A：微信 OAuth2 面向个人微信扫码；企业微信 OAuth2 面向企业成员。按登录人群选择，勿混装。
A：微信 OAuth2 面向个人微信扫码；企业微信 OAuth2 面向企业成员。按登录人群选择，勿混装。
Q：与应用访问控制里的登录方式冲突吗？
A：不冲突。集成解决进组织；应用 访问控制 解决进站点，见 访问控制与授权。
A：不冲突。集成解决进组织；应用 访问控制 解决进站点，见 访问控制与授权。