> 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.

# Twilio 区域路由

## 概述

区域路由可确保电话数据保留在特定地理区域内。在隔离环境（如欧盟数据驻留）中将 Twilio 与 ElevenLabs 配合使用时，必须正确配置区域路由，以保持数据驻留合规。

本指南介绍区域路由是什么、为何重要，以及如何在 Twilio 和 ElevenLabs 中正确配置。

## 什么是区域路由？

区域路由是 Twilio 用于确保通话数据在特定地理区域内处理和存储的机制。可以将其视为电话基础设施的数据驻留。

> **Note**
>
> 默认情况下，Twilio 电话号码会配置为通过美国区域（`us1`）路由，**即使电话号码本身来自其他国家**。例如，意大利电话号码仍会通过美国路由，除非明确配置区域路由。

## 区域路由为何重要

在隔离环境（如欧盟数据驻留）中使用 ElevenLabs 时，所有数据处理都必须保留在指定区域内。如果未正确配置区域路由：

* **违反数据驻留要求**：通话数据可能会通过非预期区域路由
* **API 操作失败**：对进行中通话的操作（如转接、保持、恢复）会失败
* **SDK 路由不匹配**：Twilio SDK 默认使用 `us1` 区域，即使 Twilio 已在后端正确路由通话，API 调用仍会被发送到错误区域

## 工作原理

将 Twilio 电话号码导入 ElevenLabs 时：

1. **Twilio 路由通话**：Twilio 会自动将来电路由到 Twilio 账户中配置的区域（可以是 `us1`、爱尔兰的 `ie1`、澳大利亚的 `au1` 等）
2. **ElevenLabs 需要知道区域**：要对进行中通话执行操作（如转接），ElevenLabs 必须将 API 请求发送到 Twilio 路由该通话的同一区域
3. **指定区域可避免失败**：在 ElevenLabs 平台中指定路由区域后，可确保所有 API 调用都指向正确的 Twilio 区域

> **Warning**
>
> 如果未指定路由区域或区域不正确，通话转接等操作将会失败，因为 API 请求会被发送到默认的 `us1` 区域，而实际通话由其他区域处理。

## 配置

### 检查 Twilio 区域路由

首先，确认 Twilio 电话号码配置使用哪个区域：

1. 登录 [Twilio Console](https://console.twilio.com/)
2. 前往 **Phone Numbers** → **Manage** → **Active numbers**
3. 选择电话号码
4. 找到 **Voice & Fax** 配置部分
5. 查看 **Regional routing** 或 **Edge Location** 设置

常见的 Twilio 区域：

* `us1` - 美国（默认）
* `ie1` - 爱尔兰（欧洲）
* `au1` - 澳大利亚
* `br1` - 巴西
* `jp1` - 日本
* `sg1` - 新加坡

> **Tip**
>
> 如果使用隔离环境（如欧盟数据驻留），请确保 Twilio 号码配置为通过对应区域路由（例如欧盟使用 `ie1`）。

### 在 Twilio 中配置区域路由

如果电话号码未配置为正确区域：

1. 在 [Twilio Console](https://console.twilio.com/) 中，前往电话号码配置
2. 找到 **Voice & Fax** 部分
3. 将 **Edge Location** 设为所需区域
4. 保存配置

> **Note**
>
> 在 Twilio 中配置区域路由可能需要额外设置或账户权限。如需协助为账户启用区域路由，请联系 [Twilio Support](https://support.twilio.com/)。

### 在 ElevenLabs 中指定路由区域

在 ElevenLabs [Phone Numbers](https://elevenlabs.io/app/agents/phone-numbers) 页面中导入或配置 Twilio 电话号码时：

1. 前往电话号码配置
2. 如果使用隔离环境，会看到以下警告消息：“You are using a phone number in an isolated environment. Double check the routing region for this phone number in your provider.”
3. 确认 **路由区域** 与 Twilio 配置一致
4. 确保指定区域与 Twilio 账户中配置的区域一致
   > **Warning**
   >
   > 如果使用区域路由，必须使用 Twilio 中与路由区域对应的 **区域 API 密钥**。标准美国 API 密钥无法用于非美国区域，并会导致身份验证错误。请在 [Twilio Console](https://console.twilio.com/) 中生成区域专用 API 密钥。

## 验证配置

要确认区域路由配置正确：

1. **检查 Twilio Console**：确认电话号码显示正确的 Edge Location
2. **检查 ElevenLabs 平台**：确认路由区域设置与 Twilio 配置一致
3. **测试通话操作**：拨打测试电话，确认通话转接等操作正常运行

> **Tip**
>
> 配置区域路由后，请在 [Calls History dashboard](https://elevenlabs.io/app/agents/history) 中监控前几通电话，确保一切按预期运行。

## 常见问题

#### 通话转接失败

这通常表示区域路由不匹配。请确认：

* Twilio 电话号码配置了正确的 Edge Location
* ElevenLabs 中指定的路由区域与 Twilio 配置一致
* 使用的隔离环境与路由区域匹配

#### 我的电话号码来自欧洲，但却通过美国路由

电话号码的地理归属地不会决定路由行为。必须在 Twilio 中明确配置区域路由。默认情况下，所有号码（包括欧洲号码）都会通过 `us1` 路由，除非另行配置。

#### 我未使用隔离环境，还需要配置吗？

如果使用标准 ElevenLabs 环境（而非欧盟数据驻留或其他隔离环境），区域路由配置是可选的。

#### 如何确定该使用哪个区域？

请选择符合以下条件的区域：

* 满足数据驻留要求（例如欧盟数据驻留使用 `ie1`）
* 距离用户最近，可获得最佳延迟表现
* 与 ElevenLabs 隔离环境匹配（如适用）

#### 使用 Twilio 凭据时出现身份验证错误

如果使用区域路由时出现身份验证错误，请确认使用了正确的 **区域 API 密钥**：

* 区域路由需要 Twilio 提供的区域专用 API 密钥，而不是标准美国 API 密钥
* 在 Twilio Console 中生成限定目标区域（如 `ie1`、`au1`）的新 API 密钥
* 在 ElevenLabs 中使用区域 API 密钥更新凭据
* Account SID 保持不变，但 API 密钥必须与区域匹配

## 最佳实践

* **匹配区域**：确保 Twilio 区域路由与 ElevenLabs 环境一致
* **记录配置**：记录每个号码使用的区域
* **充分测试**：更改区域路由后，确认通话操作正常运行
* **监控通话**：留意 Calls History dashboard 中可能表示路由问题的失败记录
* **规划扩展**：如果计划扩展到新区域，请从一开始就考虑区域路由

## 其他资源

* [Twilio 区域路由文档](https://www.twilio.com/docs/global-infrastructure/edge-locations)
* [ElevenLabs 数据驻留指南](/docs/zh/overview/administration/data-residency)
* [Twilio 电话号码指南](/docs/zh/eleven-agents/phone-numbers/twilio-integration/native-integration)