钉钉文档写入
钉钉文档写入能力用于把产品内容、AI 生成结果或业务数据同步到钉钉知识库文档中。它适合自动生成会议纪要、项目周报、客户记录、知识库文章和流程归档。适合什么场景
- 将产品中的记录自动生成钉钉知识库文档。
- 把 AI 生成的总结、方案或报告写入钉钉文档。
- 根据业务状态更新已有文档内容。
- 在团队协作流程中，把重要资料沉淀到钉钉知识库。
接入前需要准备
创建知识库下的空白文档、更新文档内容、读取知识库列表属于不同场景，所需权限和授权方式可能不同。启用时请把目标流程描述清楚。
钉钉后台需要开通的权限
打开 钉钉开放平台 →「企业内部开发」→ 进入你的应用 →「权限管理」，按实际场景开通知识库和文档权限。 钉钉文档写入通常同时用到企业级 access_token 和用户级 access_token。简单判断：接口路径里有/me/ 的，一般需要用户授权；没有 /me/ 的，通常使用企业应用凭证。
建议开通范围
如果只是把内容写入某个已有知识库，通常先开通“已有知识库下创建并写入文档”这一组即可。目标知识库还需要给执行写入的钉钉用户查看或编辑权限。
最小必需权限
钉钉「覆写文档内容」属于个人授权接口，后台可能不是以固定权限 code 的形式展示。配置时请在钉钉开放平台的文档应用权限中搜索“文档写入 / 覆写文档 / 更新文档内容”等权限项，并确保执行写入的钉钉用户完成授权。
可选权限
如何在 superun 中启用
1
点击「钉钉文档写入」
在「研发」→「技能库」中打开「钉钉文档写入」，点击使用，并说明你希望产品在哪些流程中创建或更新文档。
2
按引导完成基础配置
如果项目还没有配置钉钉基础插件，对话框会引导你填写 Client ID、Client Secret 等应用凭证；如果已经配置过，会直接复用已有配置。
3
开通知识库和文档权限
按照 superun 给出的权限清单，在 钉钉开放平台 开通知识库读写、知识库文档写入等权限，并发布应用。
4
确认知识库和授权人
提供目标知识库、文档归档位置和执行写入操作的钉钉用户授权方式。
5
测试创建和更新
完成权限配置后，先测试创建一篇文档，再测试后续内容更新。
常见限制
- 没有知识库读写权限时，可能无法列出目标知识库或创建文档。
- 文档内容更新通常依赖用户授权，不只是企业应用凭证。
- 如果目标知识库或文档权限变更，需要重新检查钉钉开放平台权限和可见范围。
- 创建接口只负责创建空白文档，正文内容需要再走文档内容写入或覆写流程。