배포전화Twilio

Twilio 리전 라우팅

데이터 레지던시 규정을 준수하도록 Twilio 전화번호의 리전 라우팅을 구성하세요.

개요

리전 라우팅을 사용하면 전화 통신 데이터가 특정 지리적 리전 내에 유지됩니다. 격리된 환경(예: EU 데이터 레지던시)에서 Twilio와 ElevenLabs를 함께 사용하는 경우, 데이터 레지던시 규정을 준수하려면 리전 라우팅을 올바르게 구성해야 합니다.

이 가이드에서는 리전 라우팅의 개념과 중요성, 그리고 Twilio와 ElevenLabs에서 이를 올바르게 구성하는 방법을 설명합니다.

리전 라우팅이란?

리전 라우팅은 통화 데이터가 특정 지리적 리전 내에서 처리되고 저장되도록 하는 Twilio의 메커니즘입니다. 전화 통신 인프라를 위한 데이터 레지던시라고 생각하면 됩니다.

기본적으로 Twilio 전화번호는 US 리전(us1)을 통해 라우팅되도록 구성됩니다. **전화번호 자체가 다른 국가의 번호인 경우에도 마찬가지입니다 **. 예를 들어 이탈리아 전화번호도 리전 라우팅을 명시적으로 구성하지 않으면 US를 통해 라우팅됩니다.

리전 라우팅이 중요한 이유

격리된 환경(예: EU 데이터 레지던시)에서 ElevenLabs를 사용하는 경우, 모든 데이터 처리는 지정된 리전 내에 유지되어야 합니다. 리전 라우팅을 올바르게 구성하지 않으면 다음과 같은 문제가 발생할 수 있습니다.

  • 데이터 레지던시 위반: 통화 데이터가 의도하지 않은 리전을 통해 라우팅될 수 있습니다.
  • API 작업 실패: 진행 중인 통화에 대한 작업(예: 전환, 보류, 재개)이 실패합니다.
  • SDK 라우팅 불일치: Twilio SDK는 기본적으로 us1 리전을 사용하므로, Twilio가 백엔드에서 통화를 올바르게 라우팅했더라도 API 호출이 잘못된 리전으로 전송될 수 있습니다.

작동 방식

Twilio 전화번호를 ElevenLabs로 가져올 때:

  1. Twilio가 통화를 라우팅합니다: Twilio는 수신 통화를 Twilio 계정에 구성된 리전으로 자동 라우팅합니다(us1, 아일랜드의 ie1, 오스트레일리아의 au1 등).
  2. ElevenLabs가 리전을 알아야 합니다: 통화 전환과 같이 진행 중인 통화에 대한 작업을 수행하려면 ElevenLabs가 Twilio가 통화를 라우팅한 동일한 리전으로 API 요청을 보내야 합니다.
  3. 리전을 지정하면 실패를 방지합니다: ElevenLabs 플랫폼에서 라우팅 리전을 지정하면 모든 API 호출이 올바른 Twilio 리전을 대상으로 하도록 보장합니다.

라우팅 리전을 지정하지 않았거나 올바르지 않은 경우, 실제 통화는 다른 리전에서 처리되고 있는데 API 요청은 기본 us1 리전으로 전송되므로 통화 전환과 같은 작업이 실패합니다.

구성

1

Twilio 리전 라우팅 확인

먼저 Twilio 전화번호가 사용하도록 구성된 리전을 확인합니다.

  1. Twilio Console에 로그인합니다.
  2. Phone Numbers → Manage → Active numbers로 이동합니다.
  3. 전화번호를 선택합니다.
  4. Voice & Fax 구성 섹션을 찾습니다.
  5. Regional routing 또는 Edge Location 설정을 확인합니다.

일반적인 Twilio 리전:

  • us1 - 미국(기본값)
  • ie1 - 아일랜드(유럽)
  • au1 - 오스트레일리아
  • br1 - 브라질
  • jp1 - 일본
  • sg1 - 싱가포르

격리된 환경(예: EU 데이터 레지던시)을 사용하는 경우, Twilio 번호가 일치하는 리전(예: EU의 경우 ie1)을 통해 라우팅되도록 구성되어 있는지 확인하세요.

2

Twilio에서 리전 라우팅 구성

전화번호가 올바른 리전으로 구성되지 않은 경우:

  1. Twilio Console에서 전화번호 구성으로 이동합니다.
  2. Voice & Fax 섹션을 찾습니다.
  3. Edge Location을 원하는 리전에 맞게 설정합니다.
  4. 구성을 저장합니다.

Twilio의 리전 라우팅 구성에는 추가 설정 또는 계정 권한이 필요할 수 있습니다. 계정에서 리전 라우팅을 활성화하는 데 도움이 필요하면 Twilio Support에 문의하세요.

3

ElevenLabs에서 라우팅 리전 지정

ElevenLabs Phone Numbers 페이지에서 Twilio 전화번호를 가져오거나 구성할 때:

  1. 전화번호 구성으로 이동합니다.
  2. 격리된 환경을 사용하는 경우 다음과 같은 경고 메시지가 표시됩니다. “격리된 환경에서 전화번호를 사용하고 있습니다. 제공업체에서 이 전화번호의 라우팅 리전을 다시 확인하세요.”
  3. 라우팅 리전이 Twilio 구성과 일치하는지 확인합니다.
  4. 지정된 리전이 Twilio 계정에 구성된 리전과 일치하는지 확인합니다.

    리전 라우팅을 사용하는 경우 라우팅 리전에 해당하는 Twilio의 리전별 API 키를 사용해야 합니다. 표준 US API 키는 US 이외 리전에서 작동하지 않으며 인증 오류가 발생합니다. Twilio Console에서 리전별 API 키를 생성하세요.

구성 확인

리전 라우팅이 올바르게 구성되었는지 확인하려면:

  1. Twilio Console 확인: 전화번호에 올바른 Edge Location이 표시되는지 확인합니다.
  2. ElevenLabs 플랫폼 확인: 라우팅 리전 설정이 Twilio 구성과 일치하는지 확인합니다.
  3. 통화 작업 테스트: 테스트 통화를 걸고 통화 전환과 같은 작업이 올바르게 작동하는지 확인합니다.

리전 라우팅을 구성한 후 처음 몇 건의 통화를 Calls History dashboard에서 모니터링하여 모든 것이 예상대로 작동하는지 확인하세요.

일반적인 문제

이는 일반적으로 리전 라우팅 불일치를 의미합니다. 다음을 확인하세요.

  • Twilio 전화번호에 올바른 Edge Location이 구성되어 있는지
  • ElevenLabs에 지정된 라우팅 리전이 Twilio 구성과 일치하는지
  • 라우팅 리전과 일치하는 격리된 환경을 사용하고 있는지

전화번호의 지리적 발급 국가가 라우팅 동작을 결정하지는 않습니다. Twilio에서 리전 라우팅을 명시적으로 구성해야 합니다. 기본적으로 모든 번호(유럽 번호 포함)는 별도로 구성하지 않는 한 us1을 통해 라우팅됩니다.

표준 ElevenLabs 환경(EU 데이터 레지던시 또는 다른 격리된 환경이 아님)을 사용하는 경우, 리전 라우팅 구성은 선택 사항입니다.

다음 조건에 맞는 리전을 선택하세요.

  • 데이터 레지던시 요구 사항에 부합하는 리전(예: EU 데이터 레지던시의 경우 ie1)
  • 최적의 지연 시간을 위해 사용자와 가장 가까운 리전
  • ElevenLabs 격리된 환경과 일치하는 리전(해당하는 경우)

리전 라우팅 사용 중 인증 오류가 발생하면 올바른 리전별 API 키를 사용하고 있는지 확인하세요.

  • 리전 라우팅에는 표준 US API 키가 아닌 Twilio의 리전별 API 키가 필요합니다.
  • Twilio Console에서 대상 리전(예: ie1, au1)으로 범위가 지정된 새 API 키를 생성합니다.
  • ElevenLabs의 자격 증명을 리전별 API 키로 업데이트합니다.
  • Account SID는 동일하게 유지되지만 API 키는 리전과 일치해야 합니다.

모범 사례

  • 리전 일치: Twilio 리전 라우팅이 ElevenLabs 환경과 일치하도록 하세요.
  • 구성 문서화: 어떤 번호가 어떤 리전을 사용하는지 기록해 두세요.
  • 철저히 테스트: 리전 라우팅을 변경한 후 통화 작업이 올바르게 작동하는지 확인하세요.
  • 통화 모니터링: 라우팅 문제를 나타낼 수 있는 실패가 Calls History dashboard에 있는지 확인하세요.
  • 확장 계획: 새 리전으로 확장할 계획이라면 처음부터 리전 라우팅을 고려하세요.

추가 리소스