混合存储

快速阅读

混合存储用来把通话录音文件落到企业自己的对象存储或文件服务器，而不是只留在 CTICloud 默认存储里。话单、系统日志不随这条能力搬家。

• 先开通能力，再提供 S3 兼容对象存储或 SFTP 的地址与凭证；配错表现为新通话没有企业侧文件，或页面试听失败。
• MP3 是主文件，一般必须配齐；WAV 是可选，且企业还要先打开额外存 wav。
• S3 协议下，平台按企业桶写入，页面试听 / 下载也从企业桶取。
• SFTP 协议下，平台先生成录音，再同步到企业目录；平台侧会按约定天数暂存，到期后以企业侧文件为准。
• 租户配置里的录音时机、格式、保留时长仍然先决定「有没有这份录音」；混合存储只决定「文件落到哪」。
• 推送产品给的是通知和临时地址，不是换存储位置。数据生命周期见下文「话单 / 录音 / 日志」三条。

阅读地图

• 先分清和默认存储、推送、加密存储、生命周期的边界：读“二”和“九”。
• 要选协议、填桶或目录：读“六”。
• 要看话单、录音、日志各落在哪：读“六.4”。
• 要验收：读“八”和“附录 C”。

一、文档说明

合规、归档或质检系统要自己管录音文件时，不能只靠页面下载。本文说明混合存储怎么定位、先开什么、S3 / SFTP 各怎么生效、失败怎么看。

适用：需要自管录音归档的技术负责人、实施顾问、安全与合规负责人。

录音何时生成、叫什么名字、页面怎么试听，结合 租户配置、查询通话记录与录音。平台默认保留策略见 数据存储生命周期。

二、产品总览

混合存储的对象是已经生成的录音文件，不是话单行，也不是实时媒体流。

通话结束后平台照常出录音；开通混合存储后，这份文件按约定写到企业自己的桶或目录。话单还在 CTICloud 里查。

开通后不是把历史录音批量搬家。已经结束的通话，仍按当时的存储位置取文件。

三、核心概念

四、对象关系与运行链路

租户配置：录音时机 / 格式 / 是否额外存 wav
        ↓
通话结束 → 平台生成录音文件
        ↓
未开通企业存储 → 只写默认存储 → 页面试听 / 下载
开通 S3 → 写入企业桶 → 页面试听 / 下载读企业桶
开通 SFTP → 写入默认存储并同步到企业目录 → 暂存期内平台可回放
        ↓
主话单 / 从话单仍在平台 → 推送（如已配）只通知，不换存储

四个层次不要混：

五、能力地图

常见录音类型会落到对应子目录，例如 record、voicemail、tsi、consult、threeway。SFTP 账户如果不能自动建目录，要在约定路径下预先建好这些文件夹。

六、配置项与生效

1. 配置来源与优先级

页面或接口里能看到话单，只说明记录已出。文件在企业侧还是平台侧，以当时开通的协议为准。

2. S3 兼容对象存储

平台用企业提供的访问密钥，把录音写到指定桶。试听、下载、接口取地址时，也按同一套桶去读。

桶策略至少允许平台上传和读取约定前缀下的对象。不要把桶配成对公网完全开放读写。

典型对象键按「日期 / 录音类型 / 企业编号 / 文件名」组织。企业侧归档、生命周期规则可以按这个前缀切。

3. SFTP

平台先在默认存储生成文件，再按目录同步到企业文件服务器。MP3 五要素必须齐；WAV 另配一套，且同样依赖额外存 wav。

同一套地址、端口、账号时，MP3 和 WAV 可以在一次连接里传完。账号无权建文件夹时，至少预先建立：

record、voicemail、tsi、consult、threeway

同步成功只表示企业目录里有文件。SFTP 协议下，控制台试听仍看平台暂存是否还在；暂存到期后，归档以企业目录为准。

4. 话单、录音、日志生命周期

数据存储生命周期 已写清话单 / 录音 / 日志生命周期怎么留。和混合存储的分工如下。

1. 话单生命周期
主话单、从话单、各类通话记录仍在 CTICloud。换桶、换 SFTP 不会把记录迁走，也不会改话单字段口径。查记录、导出、报表还走原来的页面和 OpenAPI。

2. 录音生命周期
这是混合存储真正改到的一层。

• 未开通：文件只在平台默认存储，按租户录音保留时长和平台策略过期。
• S3：新文件以企业桶为准；企业桶自己的生命周期规则、冷热分层由企业管。平台试听依赖企业桶里文件还在、凭证还有效。
• SFTP：企业目录是归档位置；平台暂存天数决定控制台还能播多久。暂存和租户「录音文件保留时长」不是同一个旋钮，开通时要一次对齐。

录音文件生成晚于话单是正常的。记录在、文件不在，先核录音时机，再核企业存储是否写出。

3. 日志生命周期
座席工作日志、API 请求日志、事件回调日志等仍按平台日志策略保留。混合存储不把日志写到企业桶，也不用企业 SFTP 接日志。

保留天数、过期删除见 数据存储生命周期。本页只定「三类数据谁来存」。

七、典型场景

合规归档到企业对象存储
开通 S3，配齐 MP3 桶；需要双声道或质检原件时再开 WAV。验收：新打一通，企业桶出现对象，话单页能试听。

文件落到企业机房目录
开通 SFTP，预先建好类型目录，暂存天数按回放窗口设。验收：目录里有 MP3；暂存期内页面能播。

平台查记录、企业自管文件
话单、报表继续用 CTICloud；录音由企业存储做长期归档。需要业务系统感知「文件好了」时，再配 推送产品 的录音状态推送。

只改脱敏、不换桶
客户号码脱敏、加密存储走 租户配置，不要开通混合存储。

八、上线准备与运营建议

1. 先在租户配置里把录音时机和格式打通，确认默认存储下能出文件。
2. 选定 S3 或 SFTP，准备桶策略或目录权限；SFTP 预建类型文件夹。
3. 开通后用新通话验收，不要用开通前的历史话单判断有没有写出。
4. 同时打一通能出 WAV 的场景（若需要），确认额外存 wav 已开。
5. 对齐三件事：企业桶 / 目录的保留、平台录音保留时长、SFTP 暂存天数。
6. 密钥或口令轮换后立刻同步到开通配置，避免只改云控制台、平台还用旧凭证。
7. 上线后抽查：话单在、企业侧文件在、页面或接口能取到地址。

运营上把「记录查不到」和「文件取不到」分开看。前者先核话单权限和时间范围，后者核存储协议、凭证和生命周期。

九、相关能力

十、常见问题

开通后，以前的录音会迁到企业桶吗？
不会。混合存储对之后新产生的录音生效。历史文件仍按当时的位置取。

话单在，企业存储没有文件？
先看这通按租户配置该不该录；再看协议参数、凭证、目录是否可写。SFTP 还要等同步完成。WAV 还要额外存 wav。

S3 配好了，页面试听失败？
S3 下试听读企业桶。核对象是否已写入、平台密钥是否仍有读权限、企业是否用生命周期规则提前删了对象。

SFTP 目录有文件，过几天页面不能播？
符合预期：暂存到期后平台不再留副本。长期回放请在企业目录取，或把暂存天数和保留策略一次设好。

推送里的录音地址能不能当企业归档？
不能。那是临时访问地址。归档用本文的企业桶或 SFTP 目录。

加密存储开了，是不是就已经混合存储？
不是。加密存储管字段落库方式；混合存储管录音文件落在谁的存储。

十一、总结

混合存储解决的是「录音文件放在企业自己的存储里」。先把录音生成打通，再开通 S3 或 SFTP，用新通话验收写出和回放。话单和日志仍在平台，三条生命周期不要和换桶混成一件事。

附录 A. 入口与权限

附录 B. 字段定义

密钥类字段只用于开通和轮换，不要写进话单自定义字段或推送明文。

附录 C. 实施检查清单

• 默认存储下已能出 MP3（录音时机、格式已通）
• 已选定 S3 或 SFTP，参数成套、凭证可写可读
• 需要 WAV 时，额外存 wav 已开，且 WAV 桶或目录已配
• SFTP 已预建 record、voicemail、tsi、consult、threeway
• 企业桶策略或防火墙已放行平台
• 新通话：企业侧有文件；S3 能试听；SFTP 在暂存期内能试听
• 话单仍能在平台查询；未误把推送地址当归档
• 平台保留、企业保留、SFTP 暂存三天对齐

附录 D. 快速排障