탐색으로 건너뛰기

전화번호로 연결 전환

정의된 조건에 따라 통화를 외부 전화번호 또는 SIP URI로 전환합니다.

개요

transfer_to_number 시스템 도구를 사용하면 특정 조건이 충족되었을 때 ElevenLabs 에이전트가 진행 중인 통화를 지정된 전화번호 또는 SIP URI로 전환할 수 있습니다. 이를 통해 에이전트는 복잡한 문제, 특정 요청 또는 사람의 개입이 필요한 상황을 실시간 상담원에게 넘길 수 있습니다.

이 기능은 전화번호를 통한 전환을 지원합니다. 트리거되면 에이전트는 사용자가 대기하는 동안 들을 메시지와 전화를 받는 상담원에게 상황을 요약하는 별도의 메시지를 제공할 수 있습니다.

transfer_to_number 시스템 도구는 전화 통화에서만 사용할 수 있으며 채팅 위젯에서는 사용할 수 없습니다.

전환 규칙

  • 전환 규칙은 에이전트가 언제 전환해야 하는지와 각 전화 서비스 제공업체가 전환을 어떻게 수행하는지를 정의합니다.

  • 각 규칙에는 조건 하나와 제공업체별 설정 하나가 있습니다.

  • 도구는 여러 전환 규칙으로 구성할 수 있습니다.

  • 통화 중 에이전트는 통화가 진행 중인 제공업체의 규칙만 확인합니다.

  • 조건: 동적 변수를 지원하는 일반 텍스트로, 이 전환 방식을 사용해야 하는 시점을 설명합니다. 예: “발신자가 청구에 관해 문의함”

  • 제공업체 구성은 제공업체당 최대 하나의 항목으로 이루어진 목록입니다. 규칙에 특정 제공업체의 항목이 없으면 해당 제공업체의 통화에서는 존재하지 않습니다.

전환 유형

  • 컨퍼런스: 대상에 전화를 걸고 발신자와 상담원을 컨퍼런스 룸에 연결하는 기본 동작입니다.
  • SIP REFER: SIP REFER 프로토콜을 사용하여 통화를 대상에게 직접 전환합니다. 전화번호와 SIP URI를 모두 지원하지만, 대화 중 SIP 프로토콜을 사용하는 경우에만 이용할 수 있으며 SIP Trunk에서 SIP REFER를 통한 전환을 허용해야 합니다.

전환 전략

  • 콜드: 전화를 받는 상담원에게 상황 요약을 전달하지 않고 통화를 직접 전환합니다.
  • 웜: 전화를 받는 상담원에게 상황을 요약하여 전달한 후 통화를 전환합니다.

제공업체별 사용 가능한 전환 옵션

SIP

  • 콜드 컨퍼런스: (sip_cold_conference_transfer) 안내 없이 수신자를 통화에 추가합니다.
    • 전화번호만 지원
  • SIP REFER: (sip_cold_refer_transfer) 안내 없이 SIP REFER를 통해 통화를 대상에게 넘깁니다.
    • 전화번호와 SIP URI 모두 지원
    • 정적 또는 동적 변수인 사용자 지정 SIP 헤더
    • CRM ID 등의 컨텍스트를 전달하기 위한 UUI(User-to-User Information)
    • 벨소리 재생(기본적으로 활성화): 전환이 완료되는 동안 발신자에게 벨소리가 들립니다. 비활성화하면 무음이 들립니다.

Twilio

  • 콜드: (twilio_cold_blind_transfer) 안내 없이 수신자를 통화에 추가합니다.
    • 전화번호만 지원
    • 다이얼 후 숫자: 통화 연결 후 전송되는 DTMF 톤
  • 웜: (twilio_warm_conference_transfer) 수신자가 에이전트의 요약을 들은 후 연결됩니다.
    • 전화번호만 지원
    • 다이얼 후 숫자: 통화 연결 후 전송되는 DTMF 톤

Exotel

  • 콜드: (exotel_warm_transfer) 안내 없이 수신자를 통화에 추가합니다.
    • 전화번호만 지원
  • 웜: (twilio_warm_conference_transfer) 수신자가 에이전트의 요약을 들은 후 연결됩니다.
    • 전화번호만 지원

추가 구성 세부 정보

다이얼 후 숫자

  • 통화 연결 후 전송되는 DTMF 톤입니다. 예: w1W234
  • 각 w는 0.5초 대기입니다.
  • 각 W는 1초 대기입니다.

사용자 지정 SIP 헤더

전환과 함께 전송되는 추가 SIP 헤더로, 수신 시스템(PBX, 컨택 센터)이 데이터를 받을 수 있습니다. 예: X-Customer-ID: 12345.

  • 사용 위치: SIP trunk, SIP REFER 전용
  • 제한:
    • 전환당 최대 20개 헤더
    • 이름: 최대 64자. 문자, 숫자, 단일 하이픈만 허용

시스템 헤더 X-Conversation-ID 및 X-Caller-ID는 ElevenLabs에서 자동으로 포함하며, 이름이 같은 사용자 지정 헤더(대소문자 구분 없음)를 재정의합니다.

UUI(User-to-User Information)

uui 객체를 사용하여 전환 규칙별로 UUI를 구성합니다.

  • data: 일반 텍스트로 전송할 페이로드입니다. ElevenLabs가 이를 16진수로 인코딩하고 ;encoding=hex를 추가합니다. 정적 텍스트 또는 동적 변수를 포함할 수 있습니다. 최대 256바이트(UTF-8)이며, 동적 변수가 대체된 후 적용됩니다. 일반 ASCII의 경우 256자이며, 멀티바이트 문자는 더 적습니다.
  • protocol_discriminator: 예를 들어 04와 같은 단일 16진수 옥텟입니다. 플랫폼이 페이로드의 첫 번째 옥텟을 제거하는 경우 포함하고, 페이로드를 그대로 전달하는 플랫폼에서는 생략합니다.
  • protocol_discriminator_mode: prefix(기본값)는 옥텟을 앞에 추가하여 04<hex>;encoding=hex를 생성합니다. pd_parameter는 별도 매개변수로 추가하여 <hex>;pd=04;encoding=hex를 생성합니다.

Talkdesk는 값을 변경하지 않고 그대로 전달하므로 프로토콜 식별자를 생략하세요. Genesys Cloud는 식별자가 없으면 페이로드의 첫 번째 옥텟을 제거하므로 protocol_discriminator를 포함하세요. Genesys UUI 데이터 형식을 참조하세요.

256바이트 제한은 동적 변수가 대체된 후 적용됩니다. 전체 통화 요약처럼 제한을 초과하여 전환에서 제외되는 자유 형식 텍스트 대신 계정 ID와 같은 식별자 또는 짧은 코드를 전달하세요.

수신 SIP 통화에서 UUI를 받기 위해 별도 구성은 필요하지 않습니다. 수신 INVITE에 User-to-User 헤더가 포함된 경우, 해당 값은 에이전트에 {{sip_uui_raw}} 및 {{sip_uui_data}} 동적 변수로 노출됩니다. SIP 레퍼런스를 참조하세요.

상담원 전환 활성화

1

전환 도구 추가

Agent 탭의 에이전트 구성에서 transfer_to_number 시스템 도구를 선택하여 상담원 전환을 활성화하세요. 도구를 추가할 때 “사람에게 전환”을 선택하세요.

2

도구 설명 구성(선택 사항)

LLM이 전환을 트리거해야 하는 시점을 알 수 있도록 사용자 지정 설명을 제공할 수 있습니다. 비워 두면 현재 통화의 전화 서비스 제공업체에 대한 전환 규칙을 나열하는 기본 설명이 사용됩니다.

3

(레거시 구성에만 해당) 제공업체별 전환 규칙으로 전환

도구가 여전히 레거시 전환을 사용하는 경우가 아니라면 이 단계를 건너뛰세요. 상담원 전환 규칙에서 제공업체별을 선택하세요. 제공업체별 규칙을 사용하면 에이전트가 사용하는 모든 전화 서비스 제공업체(Twilio, SIP trunk, Exotel)에서 각 전환의 실행 방식을 구성할 수 있으며, 모든 새 전환 옵션을 사용할 수 있습니다.

전환하면 기존 레거시 전환이 동등한 제공업체별 규칙으로 변환됩니다. 규칙을 수정하기 전까지 기존 통화의 동작은 변경되지 않습니다.

도구는 레거시 전환 또는 제공업체별 규칙 중 하나만 사용하며, 둘 다 사용할 수는 없습니다. 레거시 설정은 모든 제공업체에 하나의 전환 유형을 적용하며 새 제공업체나 전환 옵션을 지원하지 않습니다.

4

규칙 및 조건 추가

규칙 추가를 클릭하고 에이전트가 이 전환을 사용해야 하는 시점에 대한 자연어 설명인 조건을 입력하세요(예: “사용자가 상담원과 통화하기를 명시적으로 요청함” 또는 “사용자가 민감한 계정 정보를 업데이트해야 함”). 조건에는 동적 변수를 포함할 수 있습니다.

LLM은 도구 설명과 함께 이러한 조건을 사용하여 전환 시점과 대상을 결정합니다. 에이전트가 존재하지 않는 대상을 선택했는데 하나만 구성되어 있으면 해당 대상이 사용됩니다. 여러 대상이 있으면 전환이 거부되고 에이전트에 유효한 옵션이 안내됩니다.

5

각 전화 서비스 제공업체의 구성 추가

제공업체 구성에서 에이전트가 통화를 받을 수 있는 모든 전화 서비스 제공업체에 대해 항목을 하나씩 추가하세요. 새 규칙은 에이전트에 할당된 전화번호의 제공업체로 시작합니다. 더 추가하려면 +를 클릭하세요.

각 제공업체는 규칙당 한 번만 구성할 수 있습니다.

그런 다음 대상을 설정하세요.

  • 대상 유형: 전화번호 또는 SIP URI. SIP URI로 전환할 수 있는 방식은 SIP REFER뿐입니다. 그 외 모든 전환 유형은 전화번호를 사용합니다.
  • 전화번호 / SIP URI: 적절한 형식의 대상으로, 직접 입력하거나 동적 변수(예: {{phone_number}})로 입력합니다.

규칙은 구성이 있는 제공업체의 통화에서만 존재합니다. 통화가 SIP trunk 번호에서 진행되는데 규칙에 Twilio 구성만 있다면, 에이전트는 해당 통화에서 그 전환을 제공할 수 없습니다.

SIP REFER 전환을 사용하려면 대화 중 SIP 프로토콜을 사용해야 하며 SIP Trunk에서 SIP REFER를 통한 전환을 허용해야 합니다.

에이전트가 구분할 수 없으므로 동일한 제공업체에서 두 규칙이 같은 대상을 가리킬 수는 없습니다. 언제든 조건을 변경하여 두 경우를 모두 포함할 수 있습니다.

API 구현

API를 통해 에이전트를 생성하거나 업데이트할 때 transfer_to_number 시스템 도구를 구성할 수 있습니다(에이전트 생성, 에이전트 업데이트). 이 도구를 사용하면 클라이언트(전환되는 사용자)와 에이전트(전화를 받는 상담원) 모두에게 전달할 메시지를 지정할 수 있습니다.

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
billing_destination = {"type": "phone", "destination": "+15551234567"}
human_destination = {"type": "phone", "destination": "+15559876543"}
# Each rule lists one config per telephony provider. A call only sees the rules
# that have a config for its provider (twilio, sip_trunk or exotel).
transfer_rules = [
{
"condition": "When the user asks for billing support.",
"provider_configs": [
{
"type": "twilio",
"config": {
"type": "twilio_warm_conference_transfer",
"transfer_destination": billing_destination,
# Wait 1s, then dial extension 1234 (Twilio only)
"post_dial_digits": {"type": "static", "value": "ww1234"},
},
},
{
"type": "sip_trunk",
"config": {
"type": "sip_cold_conference_transfer",
"transfer_destination": billing_destination,
},
},
{
"type": "exotel",
"config": {
"type": "exotel_warm_transfer",
"transfer_destination": billing_destination,
},
},
],
},
{
"condition": "When the user asks to speak to a human.",
"provider_configs": [
{
"type": "twilio",
"config": {
# Preserves caller ID, no warm transfer message
"type": "twilio_cold_blind_transfer",
"transfer_destination": human_destination,
},
},
{
"type": "exotel",
"config": {
"type": "exotel_cold_blind_transfer",
"transfer_destination": human_destination,
},
},
],
},
{
"condition": "When the user requests to file a formal complaint.",
"provider_configs": [
{
"type": "sip_trunk",
"config": {
"type": "sip_cold_refer_transfer",
"transfer_destination": {"type": "sip_uri", "destination": "sip:support@example.com"},
"custom_sip_headers": [
{"type": "static", "key": "X-Department", "value": "complaints"},
{"type": "static", "key": "X-Priority", "value": "high"},
# "dynamic" takes the dynamic variable's name, without {{ }}
{"type": "dynamic", "key": "X-Customer-ID", "value": "customer_id"},
],
"uui": {
"data": "account_id={{customer_id}}",
"protocol_discriminator": "04", # Genesys Cloud; omit for Talkdesk
"protocol_discriminator_mode": "prefix", # or "pd_parameter"
},
},
},
],
},
]
response = elevenlabs.conversational_ai.agents.create(
conversation_config=ConversationalConfig(
agent=AgentConfig(
first_message="Hi, how can I help you today?",
prompt={
"prompt": "You are a helpful assistant.",
"built_in_tools": {
"transfer_to_number": {
"type": "system",
"name": "transfer_to_number",
"description": "Transfer the user to a human operator based on their request.",
"params": {
"system_tool_type": "transfer_to_number",
# Still required, and must be empty when transfer_rules is set
"transfers": [],
"transfer_rules": transfer_rules,
},
}
},
},
),
),
)

API 문서 레퍼런스

레거시 설정

전송 유형

시스템은 세 가지 전송 유형을 지원합니다.

  • 컨퍼런스 전송: 대상에 전화를 걸어 참가자를 컨퍼런스 룸에 추가한 후 AI 에이전트를 제거하는 기본 동작입니다. 이후에는 발신자와 전송된 참가자만 남습니다. 네이티브 Twilio 통합을 사용하는 경우, 상담원에게 전달되는 웜 전송 메시지(agent_message)를 지원합니다.
  • 블라인드 전송: 상담원에게 웜 전송 메시지를 보내지 않고 통화를 대상에게 직접 전송합니다. 원래 발신자 ID가 유지됩니다. 에이전트의 전화번호를 네이티브 Twilio 통합을 통해 가져온 경우에만 사용할 수 있습니다.
  • SIP REFER 전송: SIP REFER 프로토콜을 사용하여 통화를 대상에게 직접 전송합니다. 전화번호와 SIP URI 모두에서 작동하지만, 대화 중 SIP 프로토콜을 사용하는 경우에만 이용할 수 있으며 SIP 트렁크에서 SIP REFER를 통한 전송을 허용해야 합니다. 웜 전송 메시지는 지원하지 않습니다.

웜 전송 메시지(agent_message)는 에이전트의 전화번호를 네이티브 Twilio 통합을 통해 가져온 경우에만 사용할 수 있습니다. SIP 기반 전송은 웜 전송 메시지를 지원하지 않습니다.

블라인드 전송은 에이전트의 전화번호를 네이티브 Twilio 통합을 통해 가져온 경우에만 사용할 수 있으며, 현재는 UI의 JSON 편집기를 통해 구성해야 합니다. 전송 도구 구성에서 “Edit as JSON”을 선택한 후, 원하는 전송 규칙에 "transfer_type": "blind"를 설정하세요.

목적: AI 지원만으로 부족할 때 대화를 상담원에게 원활하게 연결합니다.

실행 조건: 다음 경우 LLM이 이 도구를 호출해야 합니다.

  • 사람의 판단이 필요한 복잡한 문제인 경우
  • 사용자가 상담원 지원을 명시적으로 요청한 경우
  • 특정 요청에 대해 AI의 역량 한계에 도달한 경우
  • 에스컬레이션 프로토콜이 실행된 경우

매개변수:

  • reason (문자열, 선택): 연결을 전환하는 이유
  • transfer_number (문자열, 필수): 연결을 전환할 전화번호(구성된 번호와 일치해야 함)
  • client_message (문자열, 필수): 연결을 기다리는 동안 고객에게 읽어줄 메시지
  • agent_message (문자열, 필수): 통화를 받는 상담원에게 전달할 메시지

함수 호출 형식:

{
"type": "function",
"function": {
"name": "transfer_to_number",
"arguments": "{\"reason\": \"Complex billing issue\", \"transfer_number\": \"+15551234567\", \"client_message\": \"I'm transferring you to a billing specialist who can help with your account.\", \"agent_message\": \"Customer has a complex billing dispute about order #12345 from last month.\"}"
}
}

구현: 연결 전환 전화번호와 조건을 구성하세요. 고객과 통화를 받는 상담원 모두에게 전달할 메시지를 정의하세요. Twilio와 SIP 트렁킹을 모두 지원합니다.

전송 가능한 번호

상담원 전송은 SIP 트렁킹과 Twilio 전화번호를 모두 사용하여 외부 전화번호로 전송할 수 있습니다.

상담원 전송 활성화

상담원 전송은 transfer_to_number 시스템 도구를 사용하여 구성합니다.

1

전송 도구 추가

Agent 탭의 에이전트 구성에서 transfer_to_number 시스템 도구를 선택하여 상담원 전송을 활성화하세요. 도구를 추가할 때 “Transfer to Human”을 선택합니다.

상담원 전송 도구 추가
'Transfer to Human' 도구 선택
2

도구 설명 구성(선택 사항)

LLM이 언제 전송을 실행할지 안내하는 맞춤 설명을 제공할 수 있습니다. 비워 두면 정의된 전송 규칙을 포괄하는 기본 설명이 사용됩니다.

상담원 전송 도구 설명
전송 도구 설명 구성
3

전송 규칙 정의

전화번호 또는 SIP URI로 전송하기 위한 구체적인 규칙을 구성합니다. 각 규칙에서 다음을 지정하세요.

  • 전송 유형: 컨퍼런스(기본값), 블라인드 또는 SIP REFER 전송 방식 중 선택
  • 번호 유형: 일반 전화번호는 전화번호를, SIP 주소는 SIP URI를 선택
  • 전화번호/SIP URI: 적절한 형식의 대상 주소
  • 조건: 전송이 발생해야 하는 상황에 대한 자연어 설명(예: “사용자가 상담원과 직접 통화하기를 요청함”, “사용자가 민감한 계정 정보를 업데이트해야 함”)

LLM은 이러한 조건과 도구 설명을 바탕으로 언제 어느 대상으로 전송할지 결정합니다.

SIP REFER 전송은 대화 중 SIP 프로토콜이 필요하며, SIP 트렁크에서 SIP REFER를 통한 전송을 허용해야 합니다. SIP URI로 전송할 수 있는 방식은 SIP REFER뿐입니다.

블라인드 전송은 에이전트의 전화번호를 네이티브 Twilio 통합을 통해 가져온 경우에만 사용할 수 있으며 JSON 편집기를 통해 구성해야 합니다. 원래 발신자 ID는 유지되지만 상담원에게 웜 전송 메시지는 전송되지 않습니다.

상담원 전송 규칙 구성
전화번호와 조건으로 전송 규칙 정의

대상의 형식이 올바른지 확인하세요.

  • 전화번호: E.164 형식이며 올바르게 구성된 계정과 연결되어 있어야 함
  • SIP URI: 유효한 SIP 형식(sip:user@domain 또는 sips:user@domain)
4

맞춤 SIP REFER 헤더 구성(선택 사항)

SIP REFER 전송을 사용할 때 맞춤 SIP 헤더를 포함하여 수신 시스템에 추가 정보를 전달할 수 있습니다.

각 맞춤 헤더에 대해 다음을 지정하세요.

  • 헤더 이름: SIP 헤더 이름(예: X-Customer-ID, X-Priority)
  • 헤더 값: 정적 텍스트이거나 동적 변수를 포함할 수 있는 헤더 값

맞춤 SIP REFER 헤더는 SIP REFER 전송에만 포함됩니다. 컨퍼런스 전송은 맞춤 헤더를 지원하지 않습니다.

시스템 헤더 X-Conversation-ID 및 X-Caller-ID는 ElevenLabs에서 자동으로 포함하며, 같은 이름의 맞춤 헤더를 덮어씁니다(대소문자 구분 없음).

5

User-to-User Information(UUI) 구성(선택 사항)

SIP REFER 전송에는 작은 페이로드인 User-to-User Information(UUI)를 포함할 수 있습니다. 이 정보는 수신 플랫폼(예: Talkdesk 또는 Genesys Cloud)에 Refer-To 헤더의 User-to-User 매개변수로 전달됩니다. UUI는 SIP URI로 전송하는 SIP REFER 전송에서만 전송되며, 전화번호(tel:) 대상에는 포함되지 않습니다.

각 전송 규칙에서 uui 객체로 UUI를 구성합니다.

  • data: 일반 텍스트로 전송할 페이로드입니다. ElevenLabs가 이를 16진수로 인코딩하고 ;encoding=hex를 추가합니다. 정적 텍스트이거나 동적 변수를 포함할 수 있습니다. 최대 256바이트(UTF-8)이며, 동적 변수가 대체된 후 적용됩니다. 일반 ASCII에서는 256자이며, 멀티바이트 문자는 그보다 적습니다.
  • protocol_discriminator: 예를 들어 04와 같은 단일 16진수 옥텟입니다. 플랫폼이 페이로드의 첫 번째 옥텟을 제거하는 경우 포함하고, 페이로드를 그대로 전달하는 경우 생략하세요.
  • protocol_discriminator_mode: prefix(기본값)는 옥텟을 앞에 추가하여 04<hex>;encoding=hex를 생성합니다. pd_parameter는 이를 별도 매개변수로 추가하여 <hex>;pd=04;encoding=hex를 생성합니다.

Talkdesk는 값을 변경하지 않고 그대로 전달하므로 프로토콜 식별자를 생략하세요. Genesys Cloud는 식별자가 없으면 페이로드의 첫 번째 옥텟을 제거하므로 protocol_discriminator를 포함하세요. Genesys UUI 데이터 형식을 참고하세요.

256바이트 제한은 동적 변수가 대체된 후 적용됩니다. 전체 통화 요약처럼 제한을 초과하여 전송에서 제외되는 자유 형식 텍스트 대신 계정 ID와 같은 식별자나 짧은 코드를 전달하세요.

인바운드 SIP 통화에서 UUI를 수신하기 위해 별도 구성은 필요하지 않습니다. 수신 INVITE에 User-to-User 헤더가 포함되어 있으면 해당 값은 에이전트에서 {{sip_uui_raw}} 및 {{sip_uui_data}} 동적 변수로 노출됩니다. SIP 레퍼런스를 참고하세요.

6

다이얼 후 숫자 구성(선택 사항)

다이얼 후 숫자는 전화가 전송 대상에 연결된 후 전달되는 DTMF 톤입니다. 내선 번호를 입력하거나 IVR(Interactive Voice Response) 메뉴를 자동으로 탐색할 때 유용합니다.

각 전송 규칙에서 다음을 포함하는 post_dial_digits 문자열을 지정할 수 있습니다.

  • 숫자 (0-9): 표준 DTMF 톤
  • w: 0.5초 지연
  • W: 1초 지연
  • * 및 #: 특수 DTMF 톤

예를 들어 ww1234는 통화 연결 후 1초간 대기한 다음 내선 번호 1234를 누릅니다.

다이얼 후 숫자는 에이전트의 전화번호(전송을 시작하는 번호)를 네이티브 Twilio 통합을 통해 가져온 경우에만 사용할 수 있습니다. 대상 번호는 어떤 전화번호든 가능합니다.

다이얼 후 숫자는 컨퍼런스 및 블라인드 전송 유형에서만 지원됩니다. SIP REFER 전송은 다이얼 후 숫자를 지원하지 않습니다.

API 구현

API를 통해 에이전트를 생성하거나 업데이트할 때 transfer_to_number 시스템 도구를 구성할 수 있습니다(에이전트 생성, 에이전트 업데이트). 이 도구를 사용하면 클라이언트(전송되는 사용자)와 에이전트(통화를 받는 상담원) 모두에 대한 메시지를 지정할 수 있습니다.

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
# Define transfer rules
transfer_rules = [
{
"transfer_destination": {"type": "phone", "phone_number": "+15551234567"},
"condition": "When the user asks for billing support.",
"transfer_type": "conference",
# Wait 1s, then dial extension 1234 (native Twilio only)
"post_dial_digits": {"type": "static", "value": "ww1234"},
},
{
"transfer_destination": {"type": "phone", "phone_number": "+15559876543"},
"condition": "When the user asks to speak to a human.",
# Native Twilio integration only, preserves caller ID, no warm transfer message
"transfer_type": "blind",
},
{
"transfer_destination": {"type": "sip_uri", "sip_uri": "sip:support@example.com"},
"condition": "When the user requests to file a formal complaint.",
"transfer_type": "sip_refer",
"custom_sip_headers": [
{"type": "static", "key": "X-Department", "value": "complaints"},
{"type": "static", "key": "X-Priority", "value": "high"},
# Use "dynamic" to read the value from a dynamic variable
{"type": "dynamic", "key": "X-Customer-ID", "value": "{{customer_id}}"},
],
"uui": {
"data": "account_id={{customer_id}}",
"protocol_discriminator": "04", # Genesys Cloud; omit for Talkdesk
"protocol_discriminator_mode": "prefix", # or "pd_parameter"
},
},
]
response = elevenlabs.conversational_ai.agents.create(
conversation_config=ConversationalConfig(
agent=AgentConfig(
first_message="Hi, how can I help you today?",
prompt={
"prompt": "You are a helpful assistant.",
"built_in_tools": {
"transfer_to_number": {
"type": "system",
"name": "transfer_to_number",
# Optional custom description
"description": "Transfer the user to a human operator based on their request.",
"params": {
"system_tool_type": "transfer_to_number",
"transfers": transfer_rules,
},
}
},
},
),
),
)
# Note: When the LLM decides to call this tool, it needs to provide:
# - transfer_number: The phone number to transfer to (must match one defined in rules).
# - client_message: Message read to the user during transfer.
# - agent_message: Message read to the human operator receiving the call (native Twilio integration only, not used for blind transfers or SIP).