SIP 中继

概览

SIP（会话发起协议）中继可将现有电话基础设施直接连接到 ElevenLabs Agents。 通过此集成，所有客户都能继续使用现有电话系统，同时利用 ElevenLabs 先进的 AI 语音功能。

使用 SIP 中继，你可以：

• 将专用分组交换机（PBX）或支持 SIP 的电话系统连接到 ElevenLabs 的 AI 语音平台
• 无需更改现有电话基础设施，即可将通话路由至 AI 智能体
• 处理呼入和呼出通话
• 使用加密 TLS 传输和媒体加密提升安全性

SIP 中继的工作原理

SIP 中继在电话基础设施与 ElevenLabs 平台之间建立直接连接：

1. 呼入通话：来自 SIP 中继的通话会使用配置的 SIP INVITE 地址路由至 ElevenLabs 平台。
2. 呼出通话：由 ElevenLabs 发起的通话会使用配置的主机名路由至 SIP 中继，使智能体能够拨打外线电话。
3. 身份验证：信令连接的安全性通过摘要身份验证（用户名/密码）或基于信令源 IP 的访问控制列表（ACL）身份验证来维持。
4. 信令和媒体：初始通话建立过程（信令）支持包括 TLS 在内的多种传输协议，以实现加密通信。通话建立后，实际音频数据（RTP 流）可根据媒体加密设置进行加密。

传输安全：证书和加密套件

使用 TLS 传输时，双方会在交换任何 SIP 信令前执行 TLS 握手。握手期间会验证证书并协商加密套件。接受连接的一方充当 TLS 服务器并提供证书；发起连接的一方充当 TLS 客户端并验证证书。ElevenLabs 要求使用 TLS 1.2 或更高版本。

角色取决于呼叫方向：

• 呼入 ElevenLabs 的电话：系统发起连接，因此 ElevenLabs 充当 TLS 服务器。ElevenLabs 会提供适用于 sip.rtc.elevenlabs.io 的有效证书，系统则作为 TLS 客户端进行验证。
• 从 ElevenLabs 呼出的电话：ElevenLabs 会向你配置的地址发起连接，因此 SIP 服务器或 SBC 充当 TLS 服务器。系统必须提供有效且受信任的证书，由 ElevenLabs 作为 TLS 客户端进行验证。

请确保双方互相信任对方证书，并且至少有一个共同的加密套件。否则，TLS 握手会在呼叫建立前失败。有关这些术语的定义，请参阅 SIP 参考。

后续连接

某些对话内请求，例如 BYE 或 REFER，在原始连接已关闭时可能需要建立新的 TLS 连接。这些后续连接的证书行为与初始呼叫建立过程不同：

• 连接到 ElevenLabs 的后续连接：系统会连接到响应中返回的 Contact 标头地址，该地址会解析为格式为 <ip>.hosts.rtc.elevenlabs.io 的特定 SIP 服务器。该服务器会提供适用于 *.hosts.rtc.elevenlabs.io 的证书，系统则作为 TLS 客户端进行验证。
• 来自 ElevenLabs 的后续连接：当 ElevenLabs 为 BYE 或 REFER 发起 TLS 连接时，会连接到最上层 Via 标头中的地址，该地址通常是 IP 地址。系统通常会返回适用于完全限定域名（FQDN）而非该 IP 地址的证书。要验证此证书，请在电话号码设置中配置 远程域名 字段。如果收到的证书所适用的任一域名与已配置的远程域名匹配，验证就会成功；否则会失败。

呼叫 ElevenLabs SIP 中继

向 ElevenLabs 平台发起呼叫时，需要使用正确的 SIP URI 格式。ElevenLabs SIP 中继 URI 取决于要用于信令的传输方式：

• TCP：sip:sip.rtc.elevenlabs.io:5060;transport=tcp
• TLS：sip:sip.rtc.elevenlabs.io:5061;transport=tls
• UDP：sip:sip.rtc.elevenlabs.io:5060;transport=udp（实验性功能；仅用于测试，请勿用于生产环境）

要发起呼叫，请构建包含标识符的完整 SIP URI。例如，要通过 TCP 呼叫电话号码 +19991234567：

sip:+19991234567@sip.rtc.elevenlabs.io:5060

其中：

• +19991234567 是标识符（通常是 E.164 格式的电话号码）
• 标识符也可以是任意字符串值，例如 1000 或 john

要求

设置 SIP 中继前，请确保具备：

1. 与 SIP 兼容的 PBX 或电话系统
2. 要连接到 ElevenLabs 的电话号码
3. SIP 中继配置的管理员访问权限
4. 允许 SIP 流量通过的适当防火墙设置
5. TLS 支持：为增强安全性，请确保 SIP 中继提供商支持 TLS 传输
6. 音频编解码器兼容性： 系统必须至少支持 G.722 或 G.711（PCMU 或 PCMA）音频编解码器之一，或者能够在本端对音频进行重采样。这与智能体为直接 websocket 连接配置的任何音频格式无关。

设置 SIP 中继

1

前往电话号码

在 ElevenLabs Agents 控制台中，前往 电话号码部分。

2

导入 SIP 中继

点击“导入号码”按钮，然后选择“从 SIP 中继导入”，以打开配置对话框。

3

输入基本配置

使用以下信息完成基本配置：

• 标签：电话号码的描述性名称
• 电话号码：要连接的 E.164 格式电话号码（例如，+15551234567）

4

配置呼入设置

配置 ElevenLabs 如何处理到达 SIP 中继的呼叫，包括媒体加密和访问控制：

• 媒体加密：配置 RTP 媒体流加密：
  • 已禁用：不加密媒体
  • 允许：允许加密媒体流
  • 必需：强制加密媒体流
• 允许的号码（可选）：获准呼叫此号码的电话号码。留空以允许所有号码。
• 允许的源 IP 地址（可选）：仅适用于 TCP/TLS 传输，不适用于 UDP。允许向此中继发起呼叫的 IP 地址或 CIDR 范围。保留 0.0.0.0/0 以允许所有地址。
• 远程域名（可选）：指定发起呼叫的 SIP 服务器 FQDN 域名，例如 example.pstn.twilio.com。这些域名用于 TLS 证书验证。如果不使用 TLS，请留空此字段。
• 身份验证（可选）：提供用于验证呼入电话的摘要式身份验证凭据。
  • SIP 中继用户名：SIP 摘要式身份验证的用户名
  • SIP 中继密码：SIP 摘要式身份验证的密码

5

配置呼出设置

配置 ElevenLabs 应将电话号码的呼叫发送到哪里：

• 地址：发送 SIP INVITE 的主机名或 IP 地址（例如 sip.telnyx.com）。此处只能填写主机名或 IP 地址，不能填写完整 SIP URI。如果使用 TLS，请使用具有有效证书的主机名。

• 传输类型：选择 SIP 信令的传输协议：

  • TCP：标准 TCP 传输
  • TLS：增强安全性的加密 TLS 传输
  • UDP：无连接传输（实验性功能；生产环境请使用 TCP 或 TLS）

• 媒体加密：配置 RTP 媒体流加密：

  • 已禁用：不加密媒体
  • 允许：允许加密媒体流
  • 必需：强制加密媒体流

• 启用的编解码器：在呼出电话的 SDP 中提供的编解码器（G.722、PCMU、PCMA）。当 SIP 提供商仅支持特定编解码器时很有用。

• 自定义标头（可选）：添加要随呼出电话发送的自定义 SIP 标头。点击“添加标头”以输入提供商要求的标头名称和值；可按需添加多个标头。自定义标头可用于呼叫路由和识别、计费和跟踪，以及满足提供商特定要求。

• 身份验证（可选）：如果 SIP 中继提供商要求，请提供摘要式身份验证凭据。

  • SIP 中继用户名：SIP 摘要式身份验证的用户名
  • SIP 中继密码：SIP 摘要式身份验证的密码

  如果留空，将使用访问控制列表（ACL）身份验证，这要求你在提供商设置中将 ElevenLabs IP 地址加入允许列表。

安全最佳实践：为获得最高安全性，请使用 TLS 传输和必需媒体加密。这样可确保信令和媒体均为端到端加密。

身份验证方式：

• 摘要式身份验证：使用用户名/密码凭据进行安全身份验证（推荐）
• ACL 身份验证：使用 IP 地址允许列表进行访问控制

强烈建议使用摘要式身份验证，因为它无需依赖 IP 允许列表即可提供更好的安全性，而动态 IP 地址的允许列表管理可能较为复杂。

地址 字段指定 ElevenLabs 从 AI 智能体发出呼叫时的目标地址。仅输入主机名或 IP 地址，不要包含 sip: 协议前缀。

6

完成设置

点击“导入”以完成配置。

客户端数据与个性化

为确保正确转发和追踪呼叫元数据，请在 webhook 负载和 SIP INVITE 请求中包含以下自定义 SIP 标头：

• X-CALL-ID：呼叫的唯一标识符
• X-CALLER-ID：呼叫方标识符

这些标头可让系统将呼叫元数据与对话关联，并为个性化提供上下文。

后备标头支持

如果上述标准标头不存在，系统会自动查找 Twilio 专用 SIP 标头：

• sip.twilio.callSid：Twilio 的唯一呼叫标识符

此后备机制无需更改配置，即可确保与 Twilio Elastic SIP Trunking 兼容。

处理流程

通过任一受支持标头收到相关元数据后，caller_id 和/或 call_id 将在对话发起 webhook中可用，并可作为系统动态变量使用。

作为动态变量的呼入自定义标头

来自呼入 SIP 中继电话的自定义 SIP X- 标头会自动作为对话中的动态变量公开。

标头名称会通过以下方式规范化：移除 X- 前缀，将名称转换为小写，将连字符替换为下划线，并添加 sip_ 前缀。例如，X-Contact-ID 会变为 {{sip_contact_id}}，X-Campaign-ID 会变为 {{sip_campaign_id}}。

可在智能体提示词、首条消息和工具中使用这些变量，根据呼叫方提供的上下文个性化对话。这些值也可在对话历史的 电话呼叫 标签页中查看。

来自动态变量的 BYE 标头

呼叫结束时，ElevenLabs 会发送 SIP BYE 以终止对话。你可以通过在 SIP 中继配置中将动态变量映射到标头名称，为该 BYE 附加自定义标头。

通过 API 创建或更新 SIP 中继电话号码时，在 inbound_trunk_config 或 outbound_trunk_config 上设置 attributes_to_headers。每个条目将动态变量名称映射到要包含在 BYE 中的 SIP 标头名称：

"inbound_trunk_config": {
  "attributes_to_headers": {
    "dynamic_variable_name": "bye_header_name"
  }
}

标头值是对话结束时动态变量的最终值。呼叫期间设置的值（通过智能体工具、webhook 覆盖或其他运行时更新）也会反映在 BYE 中。

例如，如果 attributes_to_headers 包含 "disposition_code": "X-Disposition"，且对话结束时 disposition_code 动态变量为 resolved，则 BYE 会包含 X-Disposition: resolved。

将智能体分配给电话号码

导入 SIP 中继电话号码后，可以将其分配给 ElevenLabs 智能体：

1. 前往 ElevenAgents 控制台中的电话号码部分
2. 选择导入的 SIP 中继电话号码
3. 点击“分配智能体”
4. 选择要处理此号码呼叫的智能体

故障排除

限制与注意事项

• 支持的并发呼叫数量取决于订阅套餐。达到上限时，可启用呼叫排队以保留呼入者，而非直接拒绝
• 可使用呼叫录音和分析功能，但可能需要额外配置
• 呼出能力可能受 SIP 中继提供商限制
• TLS 支持：确保 SIP 中继提供商支持 TLS 1.2 或更高版本，以进行加密传输
• 媒体加密：SRTP 支持因提供商而异；要求加密前请验证兼容性
• 音频格式：ElevenLabs 的 SIP 部署使用 PCMU 或 PCMA（G.711，8kHz）或 G.722（16kHz）编解码器发送和接收音频。这与智能体为直接 websocket 连接配置的任何音频格式无关。SIP 中继系统必须原生支持这些编解码器之一，或执行重采样以符合系统要求

常见问题

后续步骤

• SIP 参考：SIP 和网络术语词汇表
• 了解如何创建 ElevenLabs 智能体