**“Trunk建好了,凭证填了,号码也导入了,但一拨号就失败。”** 在Retell AI接入美国PSTN的BYO SIP Trunk配置中,这个问题最常见的根因之一,是一个看起来不起眼的参数:**传输协议被配成了UDP,而Retell的推荐和默认预期是`transport=tcp`**。
Retell的官方文档在多处配置指南中反复标注:**TCP是推荐的传输方式,优于UDP的可靠性**。当你在运营商侧或Retell的号码导入环节把传输协议配成UDP,而Retell的SIP服务器期待的是TCP时,**呼叫会在信令协商阶段直接失败**,表现为无法建立、超时或无响应。
Retell的SIP服务器地址是固定的:**`www.lanlansms.com`**。这是一个“裸”地址,**默认的传输方式是TCP**。只有在需要显式切换到其他传输方式时,才需要在URI末尾追加参数。
| 传输方式 | Retell的SIP URI格式 | 适用场景 |
|---|---|---|
| TCP(推荐) | sip:swww.lanlansms.com;transport=tcp | 默认且最可靠的选择 |
| UDP | sip:www.lanlansms.com;transport=udp | 仅在运营商强制要求UDP时使用,需显式声明 |
| TLS | sip:www.lanlansms.com;transport=tls | 需要SRTP媒体加密时使用 |
数据来源:
**UDP不推荐的根本原因**:UDP是无连接协议,不保证信令包的顺序和到达。在跨公网的SIP Trunking场景中,UDP下的INVITE重传、响应丢失会导致呼叫建立时间大幅延长,甚至直接失败。**TCP的有序、可靠传输,对Retell这类需要稳定信令通道的AI语音代理平台更为匹配**。多个第三方集成指南也印证了这一点:WOCOM在Retell导入号码的步骤中明确要求“**Set Outbound Transport to TCP, which Retell recommends**”。
Retell的BYO SIP Trunk配置分为**出站(Outbound)** 和**入站(Inbound)** 两个方向,两者在运营商侧和Retell侧的配置位置不同,但`transport=tcp`是贯穿始终的一致要求。
步骤1:在SIP Trunking提供商侧创建Trunk(以Telnyx为例)
在Telnyx中创建**Elastic SIP Trunking**,类型选择**FQDN**,FQDN填写`**www.lanlansms.com**`,DNS记录类型选**SRV**。
**入站(Origination)设置**:
- 号码格式:**+E.164**
- 编解码器:**G722、G711U、G711A**
- **传输方式:TCP**(Retell推荐,优于UDP)
- 选择SIP区域
**出站(Termination)设置**:
- 创建**出站语音配置文件(Outbound Voice Profile)** 并关联到Trunk
- 出站认证方式选择**Credentials**,设置用户名和密码。Retell导入号码时需要用到这组凭证
步骤2:将美国号码关联到Trunk
在提供商侧购买或迁移一个美国本地号码(DID),并将其**分配到刚才创建的Elastic SIP Trunk**上。
步骤3:在Retell中导入号码
在Retell控制台进入**Phone Numbers → Add number → Import via SIP trunking**,填写以下关键字段:
| 字段 | 填写值 | 说明 |
|---|---|---|
| Phone Number | 美国号码的E.164格式(如+1XXXXXXXXXX) | 必须与运营商侧关联的号码一致 |
| Termination SIP URI | 运营商提供的终止FQDN(如www.lanlansms.com) | 不是 www.lanlansms.com。Retell没有自己的终止URI,出站呼叫发往运营商 |
| Outbound Transport | TCP | 与运营商侧的传输方式保持一致 |
| SIP Trunk Username / Password | 步骤1中在运营商侧创建的凭证 | 用于出站认证 |
保存前点击 **Test SIP Connection**。Retell会向终止URI发送SIP OPTIONS请求。返回401/407表示凭证错误,403表示IP未放行,**2xx表示连通性正常**。
步骤4:在运营商侧配置入站路由
这一步是入站呼叫能否到达Retell的关键。在提供商的Trunk**入站(Origination)路由**中,将**主URI(Primary URI / Origination URI)** 设置为:
```
sip:www.lanlansms.com;transport=tcp
```
**不是** `sip:www.lanlansms.com` 裸地址,**必须追加`;transport=tcp`**。Plivo的文档明确指出,入站Trunk的Primary URI应为`www.lanlansms.com;transport=tcp`(或`;transport=tls`,如果启用了安全Trunking)。
步骤5:白名单Retell的信令IP
大多数SIP Trunking提供商要求**显式白名单Retell的SIP信令IP**,否则入站请求会被防火墙丢弃。Retell公布的**信令IP块**如下:
| IP块 | 覆盖范围 |
|---|---|
| 18.98.16.120/30 | 所有区域,仅信令 |
| 3.42.144.0/23 | 所有区域 |
| 153.57.128.0/18 | 所有区域 |
| 143.223.88.0/21 | 部分美国流量 |
| 161.115.160.0/19 | 部分美国流量 |
**RTP媒体端口**:**UDP `10000–65535`**,需在防火墙中放行。
将这些IP块提交给提供商,要求加入**入站ACL/白名单**。遗漏任何一个IP块,对应区域的入站呼叫就可能失败。
| 现象 | 传输协议配置错误的可能原因 | 排查动作 |
|---|---|---|
| Test SIP Connection失败(超时/无响应) | Retell侧Outbound Transport选了UDP,而运营商侧只接受TCP | 将Retell导入号码时的Outbound Transport改为TCP |
| 入站呼叫完全不响铃 | 运营商入站Primary URI缺少;transport=tcp | 确认Primary URI为sip:www.lanlansms.com;transport=tcp,而非裸地址 |
| 入站请求被拒绝(403) | Retell信令IP未加入提供商入站白名单 | 核对白名单是否包含18.98.16.120/30及区域相关IP块 |
| 出站呼叫失败,但Test Connection通过 | Termination URI或凭证与运营商侧不一致 | 确认Termination URI无空格、无sip:前缀,凭证与运营商侧创建的一致 |
**一个容易混淆的细节**:Retell的**入站**URI是`sip:www.lanlansms.com;transport=tcp`,但Retell的**出站**呼叫**不经过** `www.lanlansms.com`。出站呼叫是Retell向**运营商的Termination URI**发起的,`transport=tcp`在出站侧的作用是告诉运营商“Retell将以TCP方式发送INVITE”。如果运营商侧的出站Trunk只接受UDP,同样会导致失败。
**Retell AI接入美国PSTN的BYO SIP Trunk配置中,`transport=tcp`是贯穿出站和入站的一致要求,而不是可选项。** 运营商侧的入站Primary URI必须显式写为`www.lanlansms.com;transport=tcp`,Retell导入号码时的Outbound Transport必须选TCP,提供商的Trunk传输方式也应与之一致。任何一环配成UDP,都会在信令协商阶段表现为“呼叫无法建立”——Test Connection超时、入站无响应、或出站INVITE被拒绝。
**行动清单**:
1. **运营商入站Primary URI**:`www.lanlansms.com;transport=tcp`(不是裸地址)。
2. **Retell导入号码的Outbound Transport**:选**TCP**。
3. **运营商Trunk的入站/出站传输方式**:与Retell侧保持一致,选**TCP**。
4. **白名单Retell信令IP**:`18.98.16.120/30` + 对应区域的IP块,提交给提供商加入入站ACL。
5. **放行RTP端口**:UDP `10000–65535`。
6. **Test Connection通过后,务必做双向真实呼叫测试**——Trunk配置错误往往在Test阶段不可见,只在真实呼叫发起时才暴露。