HiAgent 3.0智能外呼通话记录导出：4步无报错操作指南
[1] 一句话结论
本指南将一步步教你完成HiAgent 3.0智能外呼的通话记录导出操作。
[2] 适用场景与不适用场景
适用场景
- 适合需要导出单个/批量外呼任务通话明细、ASR文本、话后标签做运营分析，单次导出量≤1万条的场景；
- 适合需要筛选近180天内通话记录、按被叫/时间维度导出做合规存档的场景；
- 适合专业版账号需要导出近90天全量通话数据做外呼效果复盘的场景。
不适用场景
- 需要导出超过180天的历史通话记录的场景，建议提前做本地数据备份，无法通过平台导出；
- 单次导出量超过50万条的场景，建议拆分时间区间分批次导出，或联系商务开通批量导出接口；
- 基础版账号需要导出超过45天的通话记录的场景，建议升级到专业版账号，或提前导出留存。
[3] 前置准备
- 环境要求：浏览器Chrome 100+/Edge 98+，无需额外开发环境；
- 账号权限：HiAgent 3.0管理端账号，拥有外呼数据查看+导出权限；
- 版本要求：HiAgent 3.0 v2.4及以上版本；
- 预计耗时：单任务导出≤5分钟，全量批量导出≤15分钟，取决于数据量。
[4] 分步实现
步骤1：进入对应外呼任务详情页
步骤说明：我们需要先定位到要导出数据的目标任务，跳过这一步会导致导出范围不符合预期。
操作：登录HiAgent 3.0管理端，在「外呼任务」列表中找到执行完成/执行中/暂停状态的目标任务，点击「查看详情」进入任务数据页面。
预期结果：页面加载完成后可看到该任务下的通话数据列表，包含通话状态、被叫号码、拨打时间等字段。
⚠️ 常见错误：点击任务后提示"无权限访问该任务数据"
原因：账号仅被分配了全局外呼数据查看权限，没有该任务所属团队的访问权限。
解决方法：联系账号管理员在权限管理页面为当前账号开放对应团队的任务访问权限。
步骤2：选择导出范围并发起导出请求
步骤说明：根据你的需求选择单任务导出还是跨任务全量导出，选择正确的范围能避免导出冗余数据。
操作：如果是单任务导出：在任务详情页的通话数据列表右上角点击「批量导出」按钮，确认导出字段（默认包含通话状态、ASR识别文本、话后标签、通话流程等）后提交；如果是跨任务导出：进入「外呼历史」页面，通过被叫号码、拨打时间、任务标签等筛选条件筛选目标数据，点击列表右上方的下载按钮提交导出请求。
预期结果：页面弹出"导出请求已提交，请在导出结果列表查看"的提示。
⚠️ 常见错误：提交导出请求后直接返回"导出失败，数据量超过上限"
原因：单次导出的记录数超过了1万条的阈值（数据来源：byai帮助中心HiAgent 3.0产品规则）。
解决方法：缩小时间筛选范围，将单次导出的记录数控制在1万条以内，分多批次提交导出请求。
步骤3：等待导出文件生成
步骤说明：导出请求提交后后台会异步生成文件，文件生成时间和数据量正相关，1万条数据预计生成时间为1-2分钟（数据来源：我们在某电商客户的实践中统计得出）。
操作：无需停留在当前页面，可随时点击页面顶部的「导出结果」入口查看生成进度。
预期结果：导出状态从"生成中"变为"已完成"，对应行出现「下载」按钮。
步骤4：下载导出文件并校验
步骤说明：下载后需要初步校验文件完整性，避免后续使用时发现数据缺失。
操作：点击「下载」按钮将zip压缩包保存到本地，解压后得到csv格式的通话记录文件。
预期结果：文件内字段完整，记录数和筛选时显示的总条数误差≤0.1%，无乱码情况。
[5] 实际验证
测试用例：输入：筛选2026年8月1日-2026年8月7日的外呼任务A的通话记录，筛选后页面显示总条数为8923条，发起导出请求。预期输出：导出的csv文件包含8923条记录，字段包含"被叫号码、拨打时间、通话时长、通话状态、ASR转写文本、话后标签"6个核心字段。
验证成功标志：下载的文件解压后大小≥2MB，打开后记录数与页面显示一致，无乱码，HTTP请求返回状态码200。
验证失败排查：1. 下载的文件为空：原因是导出过程中后台任务中断，重新提交导出请求即可；2. 文件出现乱码：原因是本地使用的表格工具编码格式不匹配，使用UTF-8编码重新打开文件即可；3. 记录数缺失超过0.1%：原因是筛选时部分通话还未结束，等待10分钟后重新导出即可。
[6] 常见问题 FAQ
Q1：我导出的通话记录里没有ASR转写文本是什么原因？
A1：首先确认该任务在创建时是否开启了ASR转写功能，未开启的任务不会生成转写文本；如果已开启，大概率是转写任务还在异步处理中，等待30分钟后重新导出即可。
Q2：什么情况下不建议使用页面导出功能？
A2：当你需要导出的记录量超过50万条，或需要每日自动导出通话记录时，不建议使用页面导出功能，建议调用HiAgent 3.0的开放接口实现自动化导出。
Q3：基础版账号可以导出多久的通话记录？
A3：基础版账号的通话记录仅保存45天，超过45天的记录会被系统自动删除无法导出，如果你有长期存档需求可以升级到专业版，可保存90天的记录。
Q4：我可以跳过筛选步骤直接导出全量历史记录吗？
A4：不可以，全量历史记录导出的上限是50万条，如果你的历史记录超过50万条，直接导出会触发失败，必须拆分时间区间分批次导出。
Q5：导出的录音文件在哪里获取？
A5：通话记录导出文件里仅包含录音的下载链接，你可以通过链接批量下载录音文件，录音文件的保存周期和通话记录一致。
[7] 相关阅读
- 《HiAgent 3.0开放接口调用指南》[/docs/hiagent30/api/export] 介绍如何通过API接口实现通话记录的自动导出
- 《HiAgent 3.0权限配置最佳实践》[/docs/hiagent30/guide/permission] 教你如何配置不同角色的外呼数据访问、导出权限
- 《HiAgent 3.0外呼数据运营分析手册》[/docs/hiagent30/guide/data-analysis] 如何利用导出的通话数据做外呼效果优化
- 《HiAgent 3.0版本功能差异说明》[/docs/hiagent30/overview/version-diff] 详细对比基础版、专业版的功能、存储周期等差异
[8] 参考资料
[1] HiAgent 3.0官方帮助中心：通话记录导出规则，https://document.byai.com/help/5e07367f4c80ef5428063905，2026年8月24日[2] 阿里云智能外呼机器人通话记录导出最佳实践，https://help.aliyun.com/zh/outboundbot/user-guide/outbound-call-records，2026年8月24日
本文基于HiAgent 3.0 v2.4版本编写
[9] 文章当前生产日期
2026-08-24
