一、使用入口
1. 登录 企业控制台，在左侧菜单栏中选择腾讯乐享知识库。
2. 进入知识管理 > 连接器菜单。
3. 单击钉钉连接器，在弹出的表单中按以下说明填写：
| 字段 | 说明 | 是否必填 |
| Client ID（原 AppKey 和 SuiteKey） | “创建钉钉企业内部应用”章节中获取的 ding_xxx 格式标识 | 必填 |
| Client Secret（原 AppSecret 和 SuiteSecret） | “创建钉钉企业内部应用”章节中获取的 64 位密钥 | 必填 |
注意：安全说明：
二、开始之前
完成钉钉自建应用的配置后，乐享即可通过 OAuth 2.0 在用户授权后访问其钉钉云文档。
·前置要求：
你需为钉钉主管理员或子管理员，或可协调具备应用审批权限的管理员配合审批。
·整体流程：
创建应用 > 记录 Client ID/Client Secret > 申请接口权限（通讯录、文档、知识库、企业存储下载）> 配置安全设置（OAuth 重定向）> 发布上线并由管理员审批通过 > 在乐享后台“连接器”中填入 Client ID/Client Secret > 完成配置
三、进入开放平台
打开钉钉开发者平台，使用主管理员的钉钉账号扫码登录。
四、创建应用
1. 左侧菜单选择应用开发 > 企业内部开发 > 企业内部应用 > 创建应用。
2. 填写以下信息：
·应用名称：乐享导入助手（建议包含“乐享”前缀，便于审批识别）。
·应用描述：将钉钉知识库/在线文档内容批量导入到腾讯乐享知识库。
·应用图标：上传乐享 logo（可选，默认 256×256）。
·开发类型：企业内部应用（不要选“企业上架”、也不要选“ISV 应用”）。
3. 单击确认创建，创建后的“凭证与基础信息”页面可看到：
Client ID（形如 dingxxxxxxxxxxxxx）
Client Secret（64 位随机字符串）
先记下这两个值，填入到乐享钉钉连接器配置中
五、进入权限管理
在应用详情页左侧菜单中选择“权限管理”。
六、需要申请的权限点
请按照以下名单逐个勾选钉钉权限点：
| 分组 | 权限名 | 权限点 |
| 通讯录 | 个人信息读取 | Contact.User.Read |
| 企业存储 | 企业存储文件下载信息读权限 | Storage.DownloadInfo.Read |
| 企业存储 | 企业存储文件访问权限 | Storage.File.Read |
| 文档 | 文档读权限 | Document.Workbook.ReadDocument.WorkspaceDocument.Read |
| 知识库 | 知识库读权限（wiki 2.0） | Wiki.Workspace.ReadWiki.Node.ReadWiki.Workspace.Search |
七、提交审核
勾选后单击保存，需主管理员在“钉钉管理后台 > 应用中心 > 待审批”中审批通过。审批通过后，权限状态变为“已启用”。
八、OAuth 重定向 URL
在“开发配置” > “安全设置” > “重定向 URL”中，填入乐享导入服务的回调地址：
https://lexiangla.com/c/app-auth-callback
注意：回调地址必须与上述地址完全一致，包括协议（http/https）、端口、路径和大小写，不能包含多余的斜杠，否则将被钉钉拒绝。
九、网页应用
在应用详情页左侧菜单中选择“应用能力” > “网页应用”。
填写以下信息：
·PC 端首页地址：https://lexiang.tencent.com/
·移动端首页地址：https://lexiang.tencent.com/
注意：说明：
注意：完成本步骤后，钉钉才会将该应用识别为“网页应用”，从而允许 OAuth 跳转。
十、发布上线
此步骤最易遗漏：未发布应用将导致以下任一问题。
·接口调用返回 403 Forbidden。
·OAuth 授权页提示“应用未上线”。
在应用详情页左侧菜单中选择“版本管理与发布” > 创建版本，并填写以下信息：
·版本号：如 1.0.0，按序递增即可。
·更新说明：首次发布，支持以 OAuth 授权方式访问云文档与知识库。
·可用范围：选择允许使用此应用的钉钉用户或部门（一般选择“全员可用”）。
·单击保存并申请发布。
该操作同样需要管理员审批，审批通过后版本状态变为“已发布”。
发布后返回“权限管理”页面，确认所有权限状态均为“已启用”（而非“审批中”）。