> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Bandwidth SIP 中继

> **Note**
>
> 在阅读本指南前，建议先阅读 [SIP 中继 指南](/docs/zh/eleven-agents/phone-numbers/sip-trunking)，了解 ElevenLabs 如何支持 SIP
> 中继。

## 概览

本指南介绍如何将 Bandwidth SIP 中继直接连接到 ElevenLabs Agents。通过此集成，你可以使用现有的 Bandwidth 电话号码和基础设施，同时利用 ElevenLabs 的高级 AI 语音功能处理呼入和外呼通话。

## Bandwidth SIP 中继的工作原理

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

1. **呼入通话**：来自 Bandwidth 的通话会使用我们的呼入 URI 路由到 ElevenLabs 平台。你可在 Bandwidth App 中通过 Voice Configuration Package（VCP）进行配置。
2. **外呼通话**：ElevenLabs 发起的通话会通过 realm FQDN 或终端 SBC 地址路由到 Bandwidth SIP 中继，使智能体能够拨打外线电话。
3. **身份验证**：Bandwidth 为 Unified Communications（UC）中继提供基于 SIP 的身份验证，通过 SIP 凭据（网络桥接）使用摘要认证。这种方法对于支持 ElevenLabs 外呼并确保通信安全至关重要。
4. **信令和媒体**：初始呼叫建立（信令）使用 UDP/TLS。呼叫建立后，实际音频数据（RTP 流）通过 UDP 传输。

## 要求

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

1. 有效的 ElevenLabs 账户
2. 已启用 SIP 中继（且已启用 sip-auth）的有效 Bandwidth Universal Platform 账户
3. 至少 1 个已购买或转入 Bandwidth 账户的电话号码
4. [Bandwidth App](https://app.bandwidth.com/) 中账户的管理员权限

## 配置呼入通话（Bandwidth 到 ElevenLabs）

配置 Bandwidth 呼入设置，将呼入通话路由至 ElevenLabs。

#### 登录 Bandwidth App

登录 [Bandwidth App](https://app.bandwidth.com/)。

#### 创建 Voice Configuration Package

1. 前往 **Service Management** 选项卡并选择 **Voice Configuration**。
2. 点击 **Create New**，开始创建新的 Voice Configuration Package。
3. 输入唯一的 Package Name。
4. 点击 **Add Route**。
5. 选择 **Route to Domain Name**。
6. 在提供的字段中输入 ElevenLabs 提供的 FQDN。通常为 `sip.rtc.elevenlabs.io`。如果 ElevenLabs 账户使用独立的数据驻留区域或静态 SIP 基础设施，请改用相应的 SIP 端点。可参阅[数据驻留](/docs/zh/overview/administration/data-residency)了解可用区域。
7. 点击 **Save** 完成 Voice Configuration Package 的创建。

> **Note**
>
> 更多详情请参阅 [Bandwidth VCP 文档](https://dev.bandwidth.com/docs/universal-platform/create-a-vcp)。

#### 验证 E.164 格式

Bandwidth 会以 E.164 格式发送呼入通话。在 ElevenLabs 中导入电话号码时，也请使用带前导 `+` 的相同格式（例如，`+15551234567`）。

## 配置外呼通话（ElevenLabs 到 Bandwidth）

对于外呼通话，ElevenLabs 必须通过 Bandwidth 身份验证。推荐使用带 realm 和凭据的 SIP 摘要认证。

#### 创建 realm

1. 在 Bandwidth App 中，选择 **Account** 并点击 **SIP Credentials**。
2. 滚动至 **Manage Realms** 并点击 **Add**。
3. 输入 realm 名称和可选描述，然后点击 **Add**。

Bandwidth 会创建格式为 `{realmname}.{hash}.auth.bandwidth.com` 的 realm FQDN。请记录此 FQDN — 你将在 ElevenLabs 中将其用作外呼地址。

> **Note**
>
> 如果未看到 **SIP Credentials** 选项卡，请联系 Bandwidth 客户经理，或向
> Bandwidth Support 提交工单，为账户启用 SIP 身份验证。

#### 创建 SIP 凭据

1. 在 **SIP Credentials** 部分，点击 **Add**。
2. 输入 **Username** 和 **Password**。
3. 选择在上一步创建的 realm。
4. 点击 **Add SIP Credentials**。

请妥善保存用户名和密码。你需要在 ElevenLabs SIP 中继配置中输入这些信息。

#### 记录 realm FQDN

外呼终端地址是创建后显示的 realm FQDN（例如，`myrealm-a1b2c3.auth.bandwidth.com`）。在 ElevenLabs 中配置外呼设置时，请在 **Address** 字段中输入该主机名。

要验证与 realm 关联的 SBC IP 地址，请运行 SRV 查询：

```bash
nslookup -type=SRV _sip._{udp/tls}.{realm_FQDN}
```

Bandwidth 会提供一对配对 SBC IP 以实现冗余。外呼流量必须能够访问两个 IP。

## 在 ElevenLabs 中完成设置

在 Bandwidth App 中配置这些设置后，请在 ElevenLabs 中导入电话号码：

#### 导入 SIP 中继电话号码

按照 [SIP 中继指南](/docs/zh/eleven-agents/phone-numbers/sip-trunking)导入 Bandwidth 电话号码。请使用以下设置：

* **传输类型**：UDP（如果 Bandwidth 中继使用加密信令，则选择 TLS）
* **媒体加密**：与 Bandwidth 中继配置保持一致
* **外呼地址**：realm FQDN（例如，`myrealm-a1b2c3.auth.bandwidth.com`）
* **SIP 中继用户名和密码**：在 Bandwidth App 中创建的凭据

#### 分配智能体

导入后，在[电话号码控制台](https://elevenlabs.io/app/agents/phone-numbers)中为该电话号码分配智能体。

> **Warning**
>
> 设置 Bandwidth SIP 中继后，请按照 [SIP 中继 指南](/docs/zh/eleven-agents/phone-numbers/sip-trunking)完成 ElevenLabs 中的
> 配置。

## 故障排除

#### 呼入通话无法接通

* 确认在 Bandwidth VCP 呼入设置中，已将 `sip.rtc.elevenlabs.io` 填为路由目标。
* 确认电话号码已使用正确的呼入设置分配至 VCP。
* 确保 ElevenLabs 中的电话号码格式与 Bandwidth 发送的 E.164 格式一致（带前导 `+`）。
* 检查防火墙是否允许已配置传输协议和端口上的 SIP 信令流量（UDP 使用 5060，TLS 使用 5061），并确认 RTP 端口未被阻止。

#### 外呼通话收到 407 或身份验证错误

* 确认 ElevenLabs 中的 **SIP 中继用户名**、**密码**和 **realm** 与 Bandwidth App 中创建的凭据一致。
* 确认 **Address** 字段仅包含 realm FQDN 主机名，不包含 `sip:` 前缀。
* 确保 ElevenLabs 外呼设置中的传输类型与 Bandwidth 中继配置一致（UDP 或 TLS）。

#### 单向音频或无音频

* 确认用于媒体流量的 RTP 端口已开放，且未被防火墙阻止。
* 验证 G711ulaw 编解码器兼容性。Bandwidth 和 ElevenLabs 均支持 G711。

## 常见问题

#### Bandwidth 要求使用什么信令传输方式和端口？

Bandwidth 和 ElevenLabs 使用端口 5060 上的 UDP 进行 SIP 信令。如果 Bandwidth 中继配置为加密传输，请改用端口 5061 上的 TLS。

#### 应使用什么电话号码格式？

请使用带前导 `+` 的 E.164 格式（例如，`+19192971100`）。Bandwidth 会以此格式发送号码，并要求号码采用此格式。

#### 哪些音频编解码器兼容？

ElevenLabs 支持 G711 和 G722。Bandwidth 支持 G711ulaw 和 G729a。建议使用 G711ulaw，以确保两个平台之间的兼容性。

## 实用链接

* [SIP 中继指南](/docs/zh/eleven-agents/phone-numbers/sip-trunking)
* [SIP 参考](/docs/zh/eleven-agents/phone-numbers/sip-reference)
* [Bandwidth UC 中继集成指南](https://www.bandwidth.com/support/en/articles/12822954-uc-trunking-integration-guide)
* [Bandwidth SIP 身份验证设置](https://www.bandwidth.com/support/en/articles/12823069-sip-authentication-network-bridge-setup-and-configuration)
* [管理 Bandwidth Voice Configuration Packages](https://www.bandwidth.com/support/en/articles/12823404-managing-voice-configuration-packages-on-the-universal-platform)
* [Universal Platform 指南](https://www.bandwidth.com/support/en/collections/12889706-universal-platform)