转接通话

保存智能体可转接到的号码，然后通过冷转接为来电者路由，或保持在线并通过暖转接向对方介绍来电者。

智能体只能将通话转接到其转接号码：即您保存在智能体中的姓名和电话号码列表。提示词会通过名称引用每个号码，并说明何时转接以及应进行冷转还是热转。智能体只能看到名称，绝不会看到号码。没有转接号码的智能体无法转接通话。

如果智能体未指定模式，则使用冷转。

配置转接#

在控制台中：

1. 打开 语音智能体，选择该智能体，然后打开 配置。
2. 在 转接号码 下，为每个目标添加名称和电话号码，例如 账单 和 +1 415 555 2671。一个智能体最多可设置 50 个转接号码。
3. 在提示词中，按名称引用每个目标，并说明何时使用该目标以及使用 cold 还是 warm 模式，例如“将账单问题转接至账单”。无需创建自定义工具。
4. 对于预热转接，选择 连接前 要执行的操作，并可选择设置 简要说明 的内容。请参阅连接前。
5. 如有需要，将 高级 → 响铃时长 设置为 5 至 120 秒。
6. 选择 部署。

使用 API 时，通过 PATCH /v1/agents/{agent_id} 暂存 transfer_destinations、提示词以及可选的 warm_transfer_style、warm_transfer_briefing 和 ring_duration_seconds，然后调用 POST /v1/agents/{agent_id}/deploy：

{
  "transfer_destinations": [
    {"name": "Billing", "number": "+14155552671"},
    {"name": "Front desk", "number": "+19375551234"}
  ],
  "warm_transfer_style": "introduce",
  "warm_transfer_briefing": "The caller's name and what they need."
}

一次写入会替换整个列表，而 [] 会移除所有转接号码。有关字段规则和验证错误，请参阅 智能体 API。

名称和号码#

• 名称：1 到 60 个字符，在智能体中不区分大小写且唯一。这是提示词使用的名称。
• 号码：完整的电话号码。没有国家代码的号码会被视为美国号码，所有号码均以 E.164 格式存储。分机号以及虚构号码范围 555-0100 至 555-0199 均会被拒绝。
• 变量号码：不使用电话号码，而是单独使用一个 通话变量，例如 {{rep_phone}}。 通话开始时会从通话变量中填充该号码。如果该变量缺失，或在该通话中不是有效号码，则转接到该名称会被拒绝。

通话可接通的号码#

转接可接通哪些号码取决于承载它的线路。由 ThunderPhone 线路承载的转接只能接通美国号码，不包括高资费号码及其他特殊服务号码。由 您自己的运营商承载的转接可接通您保存的任何号码。

您自己运营商的号码只能通过其连接自身的呼出中继发起呼出通话和热转接分支：配置了呼出中继的手动 SIP 连接、已设置呼出功能的 Twilio 连接，以及 Telnyx 连接。没有该中继时，此号码完全无法呼出，因此仅支持冷转接。这些通话绝不会回退到 ThunderPhone 的线路。

如果您的组织没有使用自己运营商的号码，保存 ThunderPhone 线路无法接通的号码会失败并显示错误。连接您自己的运营商后，这些号码即可保存，并会标记为仅在由您的运营商承载的转接中可用（API 中为 platform_ok: false）。一个智能体可以同时接听两类号码，因此系统会在每次通话中执行检查。

连接前#

每个智能体都会选择转接目标接听热转接时的处理方式。该设置适用于智能体发起的每次热转接。

除非接听者需要能够拒接通话，或应在呼叫者接入通话前了解来电者信息，否则请使用在线介绍。先询问可让对方拒绝，但会使呼叫者等待更久；语音信箱、静默或拒绝都会将呼叫者转回智能体。 耳语可在不提问的情况下私下提供背景信息；语音信箱会将呼叫者转回智能体。

转接说明#

说明设置决定智能体向接听方介绍来电者时所说的内容。使用在线介绍时，这是双方接通后都会听到的介绍。默认内容非常简短：谁在来电以及来电原因，例如“您好，Alex 因订单事宜在线。Alex，请说。”使用先询问时，这是接通来电者前私下说的一句话，最后会询问对方是否方便接听；对方接受后进行的介绍遵循相同思路。使用耳语时，这是接通来电者前私下说的一句话，例如“Alex 正因延迟订单来电，我现在为您接通。”这是一句陈述，不是问题。

要更改其说法，请在智能体上编写一条说明指令 （warm_transfer_briefing，最多 300 个字符），例如“来电者的姓名、其账户编号以及他们需要什么。”智能体会在撰写每次介绍或说明时遵循该指令。请仅保留几个重要事实：超过约 40 个词的介绍或耳语句子，或超过约 25 个词的先询问说明，会被替换为简短的标准话术。留空即可使用默认内容。

暖转期间的处理方式#

使用 在线介绍（默认）时：

1. 智能体会告知来电者正在开始转接。通话录音会停止，且智能体仍在说话时，ThunderPhone 会立即从处理该通话的号码呼叫目标号码。
2. 目标号码响铃期间，来电者会短暂静默等待。此方式不播放等待音乐。
3. 目标号码一接听，来电者已在线，因此会从第一句话开始听到问候语。
4. 接听人说完并等待回复时，智能体会用一两句话向双方介绍来电者，例如：“您好，我这里有 Alex，他是来咨询订单的。Alex，请说。”智能体根据对方所说的内容而非停顿来判断：录音提示或“请稍候”并不代表对方已说完，“有什么可以帮您？”才代表对方已说完。如果对方未说话，智能体会在约 3 秒后开始介绍。如果对方在介绍过程中插话，智能体会停止，待对方说完后再次介绍。约 15 秒后，例如遇到较长的电话菜单时，智能体仍会介绍来电者。缺失或过长的介绍会替换为一条简短的标准话术，并使用通话语言播报。
5. 智能体会自动退出；不会再说任何内容。

无论谁接听，都会被接通。如果是语音信箱问候语，智能体不会向其说任何内容并会退出，因此来电者可以留言。如果目标号码未接听、忙线、无法拨通，或接听人在介绍结束前挂断，ThunderPhone 会结束该通话，来电者将返回智能体。智能体会收到结果并继续原始对话。它可以记录留言、建议其他转接方式，或在来电者仍希望转接时进行冷转接。

使用先询问#

1. 智能体会告诉来电者正在开始转接，然后在目标号码响铃期间，来电者会听到等待音乐。
2. 当目标号码接听后，智能体会先让接听方完成问候，其判断方式与上文相同。如果智能体已开启同意声明，接听方会先听到该声明。随后，智能体会说出说明，并询问对方是否方便接听。处于等待状态的来电者不会听到这些内容。
3. 对方可以提问，智能体会根据截至目前的对话作答。如果对方接受，来电者会被接通，智能体会用双方都能听到的一两句话介绍来电者，然后退出通话。
4. 如果对方拒绝、未回应，或通话转入语音信箱，ThunderPhone 会结束该通话并解除来电者的等待状态。智能体会获得结果，包括对方要求转达的任何信息，并继续与来电者对话。

在这种模式下，转接不会停止通话录音。如果智能体录制通话，与接听方的私下对话和接通后的通话都会被录制。如果智能体未开启通话录音，两者都不会被录制。

使用耳语#

1. 智能体会告诉来电者正在开始转接，然后在目标号码响铃期间，来电者会听到等待音乐。
2. 当目标号码接听后，智能体会等待接听方完成问候。如果智能体已开启同意声明，接听方会先听到该声明。随后，智能体会用一句简短的话告诉对方谁在来电以及来电原因。它不会询问对方是否方便接听。处于等待状态的来电者不会听到这些内容。
3. 来电者会被接通，智能体退出通话。线路上不会再说任何内容。
4. 如果通话转入语音信箱，智能体会挂断该通话并解除来电者的等待状态。如果目标号码未接听、占线，或无法发起通话，来电者也会返回智能体。智能体会获得结果，并继续与来电者对话。

录音方式与先询问相同：如果智能体录制通话，私下说明和接通后的通话都会被录制。

提示智能体妥善转接#

将路由规则写入智能体提示词，并将每个目标名称准确写成其在 转接号码 下显示的名称。请勿在提示词中写入电话号码；智能体会按名称转接。为每条路由指定转接模式，并为热转接失败时提供备用方案。

Transfer policy
 
Confirm the caller's name and reason for calling before any transfer.
 
| Caller needs | Destination | Transfer mode |
| --- | --- | --- |
| A new purchase or plan change | Sales | warm |
| Help with an existing order | Order support | warm |
| The main office | Front desk | cold |
 
For a warm transfer:
- Keep the introduction to one or two short sentences: who is calling and
  why.
- Do not plan to speak after the introduction because you will be dropped.
- If the target does not answer or is busy, tell the caller what happened,
  then offer to take a message or try another route. Do not cold-transfer
  unless the caller asks.

智能体在调用内置操作时会提供以下字段：

您无需定义或附加名为 transfer_call 的自定义工具。该操作的说明会遵循智能体的 连接前 和 说明 设置，因此提示词无需重复这些内容。

转接被拒绝时#

ThunderPhone 会在发起每次转接前进行检查。如果名称不在智能体的转接号码名称列表中、变量号码在本次通话中没有有效值，或者通过 ThunderPhone 线路进行的转接将拨打美国境外的号码或高资费号码，ThunderPhone 会拒绝该转接。

被拒绝的转接不会结束通话。智能体不会告知来电者将进行转接，而是会收到拒绝原因（当名称不匹配时，还会包括有效名称列表），并继续与来电者交谈。在提示词中告知智能体应改为执行什么操作，例如记录留言。拒绝会以工具错误的形式显示在通话记录中。

耳语转接#

“密语转接”是行业中对预热转接的常用称呼：在接通来电者之前，转接目标会先听到私密背景信息，无需被询问是否接听电话。这对应于连接前下的 Whisper 设置。

这不同于 POST /v1/calls/{id}/whisper。 该端点允许员工或所有者在实时通话期间向 AI 智能体发送私密文本指导。它不会呼叫或向转接目标提供说明。

要求、限制与测试#

Webhook 和结束原因#

完成载荷会在 transfer_number 中记录目标号码，并使用以下 结束原因之一：

未接听、占线或失败的暖转接尝试不属于已完成的转接。来电方会返回智能体，因此最终的结束原因反映的是导致原始通话结束的事件。

对于成功的暖转接，双方接通后智能体退出时，会记录完成事件和 AI 通话的结束原因。 使用 在线介绍 时，录音会覆盖至转接发生时并在此结束（recording_stopped_at）；两人之间的对话既不会被录音，也不会被转写。使用 先询问 和 耳语 时，录音（如果智能体录制通话）会持续到已接通的通话结束。

有关完整载荷和旧版行为，请参阅完成 Webhook。

故障排除#

智能体转接时通话中断#

检查目标号码所在的国家/地区。ThunderPhone 号码上的通话仅支持转接至美国号码。运营商可能会拒绝转接至其他国家/地区，这会导致来电者断线，并且通话仍会以 ai_transfer 结束。若要拨打其他国家/地区，请接入您自己的运营商，并通过从该运营商导入的号码路由通话。该运营商必须接受通话转接，并允许拨打该国家/地区。在 Twilio SIP 中继上，启用 通话转接 和 启用至 PSTN 的通话转接。

智能体执行了冷转接，而不是暖转接#

确认通话使用的号码可以拨打外线：已验证且已导入、出站路由正常的 VoIP 号码，或已获批可进行出站呼叫的 ThunderPhone 号码。对于其他号码和非电话会话，工具选项中不会提供暖转模式。此外，请在提示词的路由表中明确指定该模式。

目标号码始终未接听#

确认您的 VoIP 中继能够向目标号码发起外呼，并且其身份验证和路由规则均为最新。检查 转接号码 下保存的号码。如果 45 秒对于热转接来说过短，请增加 ring_duration_seconds。

目标号码转入语音信箱#

使用 在线介绍 时，来电者会接通至任何应答方， 包括语音信箱问候语。智能体会识别问候语，不会向语音信箱留言并挂断，来电者则可以留言。使用 先询问 和 耳语 时，智能体会在接通语音信箱后挂断，来电者将返回智能体。如果某个目标号码经常转入语音信箱，请在提示词中为智能体提供另一条转接路径。

冷转接在接通前等待#

如果您使用旧版单 URL webhook，请检查其是否返回了 {"transfer_ready": false}。ThunderPhone 等待期间，呼叫方会听到保持音乐。在目标方准备就绪后，更新该通话的转接就绪状态。

智能体表示无法转接#

检查智能体是否配置了转接号码，以及提示词是否使用了相同的名称。未配置转接号码的智能体完全没有转接操作。如果转接通过 ThunderPhone 的线路进行（请参阅通话可拨打哪些号码），目标号码必须是非高资费的美国号码。对于变量号码，请检查通话变量是否包含该号码的有效电话号码。

部署因转接号码错误而失败#

每次部署都会重新检查已保存的转接号码。如果您的组织曾在自有运营商处拥有号码时保存了非美国号码，那么一旦该组织不再拥有此类号码，该号码将无法通过检查。请删除该号码，或再次接入您自己的运营商。

员工耳语不会启动转接#

实时通话耳语功能仅用于指导 AI。请在智能体提示词中添加转接说明，并让其调用 transfer_call。请参阅 监控实时通话。