高级数据导出
创建受权限范围约束的 CSV 或 XLSX 任务，跟踪任务并在文件到期前下载完整结果。
- 适用对象
- 管理员
- 内容更新
- 2026-09-09
先登录公司系统；文中的 /app/… 是加在公司系统网址后的页面路径。
开始前
- 在你自己的部署域名中登录用户会话；API Key 不能管理导出
- 进入工作区需要 integration.manage 的 view 权限；导出还需要 data_export.advanced 和所选来源模块的 export 权限
- 部署运行时开关已启用；池化部署还需要 Max 或 Enterprise 权益
操作步骤
打开已登录的导出工作区
打开你自己的部署域名下的 /app/int/docs?section=exports&lang=zh 或 /app/int/docs?section=exports&lang=en，登录后进入“开发者中心 → 数据导出”。管理导出使用已登录用户流程，不能用公开 API Key 代替。业务模块中的基础 CSV 仍用于简单列表导出。
预期结果: 你使用的是正确的管理入口和认证边界。
选择支持的数据集与范围
选择 customers、conversations、messages 或 service_report，再选择 CSV 或 XLSX。只使用实际支持的筛选和字段。customers 支持日期和团队；conversations、messages 与 service_report 还支持收件箱和状态。日期窗口按创建时间，messages 使用 createdAt 而不是 sentAt。浏览器本地或 UTC 日期时区会转换为精确 UTC 边界，界面所选日期包含首尾两天。
预期结果: 提交的范围与数据集及精确 UTC 时间窗口一致。
确认并跟踪任务
创建任务前检查范围摘要。页面会自动刷新排队中和运行中的任务。每个租户最多一个运行中任务、五个排队任务。上限为 10,000 行；超过上限会带原因失败，不会截断成不完整文件。排队中或运行中的任务可以取消。
预期结果: 你能看到任务是排队、运行、完成、取消还是失败，不会把部分结果当作成功。
下载并安全恢复
任务完成后确认行数，并在文件有效期内下载。执行和下载时都会检查用户状态与权限。文件七天后到期，每个签名 URL 五分钟后失效；文件到期后需要重新创建任务。存储或权限失败会显示原因。空值保持空白，ID 保持字符串，CSV/XLSX 中类似公式的文本会被转义。
预期结果: 下载文件完整、范围正确，并能安全地在表格软件中打开。
正确理解导出指标
service_report 导出包含 avgFirstResponseMinutes，即以分钟计的算术平均值。旧字段 averageFirstResponseSeconds（以秒计的中位数）属于公开 API 的服务报表 /api/v1/external/reports/service，不属于这个导出数据集。
预期结果: 运营人员会使用正确的字段、单位和来源比较客服指标。