Twilio 区域路由
Twilio 区域路由
为 Twilio 电话号码配置区域路由,确保符合数据驻留要求。
概述
区域路由可确保电话数据保留在特定地理区域内。在隔离环境(如欧盟数据驻留)中将 Twilio 与 ElevenLabs 配合使用时,必须正确配置区域路由,以保持数据驻留合规。
本指南介绍区域路由是什么、为何重要,以及如何在 Twilio 和 ElevenLabs 中正确配置。
什么是区域路由?
区域路由是 Twilio 用于确保通话数据在特定地理区域内处理和存储的机制。可以将其视为电话基础设施的数据驻留。
默认情况下,Twilio 电话号码会配置为通过美国区域(us1)路由,即使电话号码本身来自其他国家。例如,意大利电话号码仍会通过美国路由,除非明确配置区域路由。
区域路由为何重要
在隔离环境(如欧盟数据驻留)中使用 ElevenLabs 时,所有数据处理都必须保留在指定区域内。如果未正确配置区域路由:
- 违反数据驻留要求:通话数据可能会通过非预期区域路由
- API 操作失败:对进行中通话的操作(如转接、保持、恢复)会失败
- SDK 路由不匹配:Twilio SDK 默认使用
us1区域,即使 Twilio 已在后端正确路由通话,API 调用仍会被发送到错误区域
工作原理
将 Twilio 电话号码导入 ElevenLabs 时:
- Twilio 路由通话:Twilio 会自动将来电路由到 Twilio 账户中配置的区域(可以是
us1、爱尔兰的ie1、澳大利亚的au1等) - ElevenLabs 需要知道区域:要对进行中通话执行操作(如转接),ElevenLabs 必须将 API 请求发送到 Twilio 路由该通话的同一区域
- 指定区域可避免失败:在 ElevenLabs 平台中指定路由区域后,可确保所有 API 调用都指向正确的 Twilio 区域
如果未指定路由区域或区域不正确,通话转接等操作将会失败,因为 API 请求会被发送到默认的 us1 区域,而实际通话由其他区域处理。
配置
检查 Twilio 区域路由
首先,确认 Twilio 电话号码配置使用哪个区域:
- 登录 Twilio Console
- 前往 Phone Numbers → Manage → Active numbers
- 选择电话号码
- 找到 Voice & Fax 配置部分
- 查看 Regional routing 或 Edge Location 设置
常见的 Twilio 区域:
us1- 美国(默认)ie1- 爱尔兰(欧洲)au1- 澳大利亚br1- 巴西jp1- 日本sg1- 新加坡
如果使用隔离环境(如欧盟数据驻留),请确保 Twilio 号码配置为通过对应区域路由(例如欧盟使用 ie1)。
在 Twilio 中配置区域路由
如果电话号码未配置为正确区域:
- 在 Twilio Console 中,前往电话号码配置
- 找到 Voice & Fax 部分
- 将 Edge Location 设为所需区域
- 保存配置
在 Twilio 中配置区域路由可能需要额外设置或账户权限。如需协助为账户启用区域路由,请联系 Twilio Support。
在 ElevenLabs 中指定路由区域
在 ElevenLabs Phone Numbers 页面中导入或配置 Twilio 电话号码时:
- 前往电话号码配置
- 如果使用隔离环境,会看到以下警告消息:“You are using a phone number in an isolated environment. Double check the routing region for this phone number in your provider.”
- 确认 路由区域 与 Twilio 配置一致
- 确保指定区域与 Twilio 账户中配置的区域一致
如果使用区域路由,必须使用 Twilio 中与路由区域对应的 区域 API 密钥。标准美国 API 密钥无法用于非美国区域,并会导致身份验证错误。请在 Twilio Console 中生成区域专用 API 密钥。
验证配置
要确认区域路由配置正确:
- 检查 Twilio Console:确认电话号码显示正确的 Edge Location
- 检查 ElevenLabs 平台:确认路由区域设置与 Twilio 配置一致
- 测试通话操作:拨打测试电话,确认通话转接等操作正常运行
配置区域路由后,请在 Calls History dashboard 中监控前几通电话,确保一切按预期运行。
常见问题
通话转接失败
这通常表示区域路由不匹配。请确认:
- 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 中可能表示路由问题的失败记录
- 规划扩展:如果计划扩展到新区域,请从一开始就考虑区域路由