---
title: "排查语音序列问题"
description: "查找序列不可用、预览中止、发布失败、呼叫使用错误版本，或取消与报告持续挂起的原因。"
canonical: "https://bird.com/zh-sg/wendang/guides/voice/sequences/troubleshooting"
---

# 排查语音序列问题

> **警告：** 语音序列处于预览阶段。步骤、入口数据和序列定义格式可能会发生变化，导致现有序列和 API 请求无法正常工作。

从受影响的草稿或运行记录开始。预览描述的是模拟路径；真实运行保留了该次呼叫接受的定义和输入。

## 序列或编辑控件缺失

确认所选的工作区，并请其管理员检查 Voice management 访问权限。查看序列需要读取权限；编辑和发布需要写入权限。发起呼叫还需要 Voice calling 写入权限。

## 预览在预期结束之前中止

1. 检查中止的步骤及其准备好的输入。
2. 为媒体、按键输入、Dial、Pause 或托管转接提供示例结果。
3. 移除或修复引用了已删除步骤或已更改输出的示例。
4. 如果表达式使用了呼叫观测数据，请提供[数据指南](/docs/guides/voice/sequences/data#handle-missing-data-and-branches)中描述的执行示例。
5. 更改定义或示例后重新运行预览。

不完整的预览需要更多信息。配置的失败结局可以是测试静音或其他失败路径的有效结果。

## 发布被阻止

1. 完成未保存的编辑并保存草稿。
2. 打开 **Checks** 并修复缺失字段、无效引用、不可达步骤或普通连接循环。
3. 检查引用的音频是否仍然存在且在该工作区中可用。
4. 保留绑定号码所选的入口，包括它们接受空来电数据的能力。
5. 如果其他编辑者保存了更新的修订版本，请在重试前比较更改。

使用 **Transfer** 来重复菜单。普通连接回到之前的步骤会产生循环。

## 外呼被拒绝

同时检查 Voice management 和 Voice calling 写入权限。确认 **From** 号码归该工作区所有或已在该工作区中验证，且目标国家已启用。提供与所选 schema 匹配的显式入口数据对象。

生产呼叫需要一个已启用、未归档的序列以及一个活跃的发布版本。草稿测试使用已保存的修订版本；如果该修订版本已更改，请重新保存。按照[创建呼叫故障排查](/docs/guides/voice/create-calls#handle-errors-and-retries)处理 API 错误。

## 来电使用了错误的流程

1. 打开号码的 **Inbound routing**，检查其序列和呼叫入口。
2. 确认序列已启用且未归档。
3. 检查主叫方是否列在 **Draft testers** 中。
4. 测试前保存草稿更改，并注意发布会清除测试者列表。

其他呼叫者使用活跃版本。来电路由提供空的入口数据。暂停的序列不接受来电草稿测试。

## 按键输入走了错误的路径

将完整收集的数字与配置的匹配项进行对比。检查最大位数、结束键和输入超时。将可中断的菜单语音放在 Gather 的提示中。测试语音播放期间以及播放结束后的按键。

如果后续表达式无法读取数字，请检查 Gather 是否为私有，或者转接是否开启了新的入口作用域。

## 呼叫已被接受但未连接

接受操作预留了呼叫和运行记录，但不代表确认拨号或应答。先检查序列运行记录，再查看可用的呼叫或分支记录。在注册之前失败的呼叫可能没有可读的呼叫记录。

对于序列内失败的 Dial，检查所选的输出以及恢复是否可以安全继续。忙线或无应答路径需要自己的后续处理。

## 取消或指标持续挂起

取消请求在呼叫清理确认之前保持挂起状态。检查最终运行状态；已完成的呼叫或失败的清理可能产生不同的终态结果。

对于报告差异，比较时区、准入周期、模式和发布筛选条件。统计数据可能滞后于交互历史，无可用覆盖不等于零活动。过期的运行详情无法从指标中恢复。

## 删除被阻止

移除或替换绑定到该序列的号码路由，包括已禁用号码上的路由。在绑定保存后重试。如果需要可逆的停用而不移除历史记录，请归档该序列。

## 后续步骤

- [预览和检查序列](/docs/guides/voice/sequences/preview)。
- [使用真实呼叫进行测试](/docs/guides/voice/sequences/testing)。
- [检查序列运行记录](/docs/guides/voice/sequences/runs)。
- [浏览序列指南](/docs/guides/voice/sequence-builder)。

## Related resources

- [Preview your first voice sequence](/docs/get-started/voice-sequences) (docs)