钉钉工作台打开 Baklib（管理员配置指南）
适用对象：企业 IT 管理员、Baklib 组织管理员、信息化负责人
本文用于指导你在钉钉工作台配置网页应用，让成员可直接进入 Baklib 后台或站点页面， 并完成免登与组织架构同步。目标是把知识库入口放进员工日常协作平台，减少跳转与账号管理成本。
说明：菜单名称、权限项、开关文案请以你的钉钉后台和 Baklib 控制台实际界面为准。
1. 适用场景
在钉钉工作台配置网页应用后，成员可直接打开 Baklib 后台或站点页面，并完成免登与组织架构同步。 把 Baklib 放进钉钉日常入口后，知识内容不再依赖“发链接 + 重复搜索”，使用路径更短、触达更稳定。
- 统一访问入口（后台 + 站点）：通过钉钉工作台网页应用直接进入 Baklib 后台或指定站点页面。
- 打开 Baklib 后台：用于组织管理、内容管理、资源管理（DAM）和成员管理。
- 打开 Baklib 站点：不仅可用于知识库阅读，也可结合 Baklib 模板能力承载帮助中心、品牌官网、活动专题等页面访问与对外触达。
- 钉钉免登与账号绑定：成员在钉钉端内可直接建立 Baklib 登录态，并与已有账号完成绑定。基于钉钉身份完成免登，减少重复账号与密码风险。
- 知识内容集中与分发：钉钉文档可导入 Baklib 知识库统一发布，再通过工作台或群入口稳定分发。
- 群内触达 Baklib 页面：通过群快捷入口直达 Baklib 已发布页面，形成“群内访问 + 站点承载”的组合。
- 组织与权限联动：可通过事件订阅自动同步部门和员工变更。打通组织同步：钉钉有变更，Baklib 侧可自动更新组织架构。也支持后台手动同步。用于支撑按组织可见范围控制后台与内容访问权限。
2. 实施前检查清单
2.1 钉钉侧
- 已具备管理员权限，可创建或维护企业内部应用。
- 已确认应用可见范围（哪些部门/成员需要使用平台）。
- 若涉及网页免登，已准备好可信域名与 HTTPS 访问能力。
2.2 Baklib 侧
- 已明确组织（租户）与钉钉企业的对应关系（一对一为主）。
- 已梳理访问策略：后台管理、内部知识、外部站点分别如何授权。
3. 配置流程（推荐顺序）
步骤 1：登录钉钉工作台并创建应用
- 登录钉钉开放平台/工作台管理后台。
- 创建企业内部应用（或选择已有应用）。
- 进入应用配置页，准备添加网页应用能力。
步骤 2：配置网页应用地址（后台/站点）
- 打开组织后台页面：
https://你的组织域名/-/third_party/dingtalk/entry - 打开站点页面：
https://你的组织域名/-/third_party/dingtalk/entry?back_to=站点地址
地址配置完成并发布应用后，即可在钉钉工作台打开 Baklib 后台或站点页面。
步骤 3：在 Baklib 后台创建第三方集成
- 在 Baklib 控制台进入第三方集成配置页。（应用创建后，在应用信息，点击应用详情进入应用页面，在“凭证与基础信息”可获取AppKey和AppSecret。）
- 录入应用所需字段并保存。
钉钉信息获取
Baklib 后台信息填入
步骤 4：开启对应权限（必须）
需要按钉钉权限列表逐项开启，免登和组织架构同步才能正常工作。可按下列清单在“权限管理”页核对：
- 用户身份与基础信息：
Contact.User.Read、Contact.User.mobile（或等价用户读取权限）。 - 通讯录字段读取：
fieldMobile、fieldEmail（用于手机号/邮箱等字段同步）。 - 部门读取：
qyapi_get_department_list（获取部门列表）。 - 成员读取：
qyapi_get_member、qyapi_get_department_member（按部门获取成员与详情）。 - 接口调用基础权限：
qyapi_base（AccessToken 与基础 API 调用）。 - 端内开放能力：
open_app_api_base（端内开放能力调用，名称可能随后台版本略有差异）。
如果你的后台显示名称与上面不完全一致，请以“权限点 code”匹配为准。
步骤 5：配置事件订阅（组织自动同步）
配置事件订阅后，可接收钉钉通知并自动同步组织架构变更，包括：
- 部门变更
- 员工添加
- 员工删除
步骤 6：发布应用并验证打开
- 完成以上配置后发布应用。
- 在钉钉工作台验证是否可正常打开 Baklib 后台或站点页面。
- 若打开异常，优先回查网页地址、第三方集成配置与权限项是否一致。
配图占位：/uploads/placeholder-dingtalk-workbench-step5.png
4. 可选：钉钉文档 → Baklib
这一部分用于把钉钉里已有文档集中沉淀到 Baklib，统一整理和发布。
- 在钉钉文档中导出 Markdown： 支持单篇文档导出；有批量迁移需求时，也可以按钉钉当前能力批量导出文档集合。
- 在 Baklib 知识库选择“导入”→“从文件导入”，上传导出的 Markdown 文件： 可上传单个
.md文件，也可上传包含多个 Markdown 文档的.zip压缩包。 - 如果上传的是带目录层级的文档集合，Baklib 会按文件夹层级在知识库中创建对应结构， 便于保持原有文档导航关系。
- 完成导入后检查内容并发布页面。
5. 常见问题（FAQ）
Q1：集成后还需要单独注册 Baklib 吗？
通常以钉钉身份访问为主，若页面提示补充绑定信息，按页面指引完成即可。
通常以钉钉身份访问为主，若页面提示补充绑定信息，按页面指引完成即可。
Q2：组织架构变更后多久同步？
组织架构变更后，若已开启事件订阅通常会自动同步；若未开启，请在 Baklib 后台手动同步。
组织架构变更后，若已开启事件订阅通常会自动同步；若未开启，请在 Baklib 后台手动同步。
Q3：对外帮助中心也必须走钉钉登录吗？
可以用其他登录方式
可以用其他登录方式
Q4：无法登录时先查什么？
优先检查应用可见范围、入口 URL、免登权限、Baklib 集成配置是否一致且未过期。
优先检查应用可见范围、入口 URL、免登权限、Baklib 集成配置是否一致且未过期。