Twilio 개인화

웹훅을 사용하여 수신 Twilio 통화의 개인화를 구성하세요.

개요

수신 Twilio 통화를 받을 때 웹훅을 통해 대화 시작 데이터를 동적으로 가져올 수 있습니다. 이를 통해 발신자 정보와 기타 컨텍스트 데이터에 따라 에이전트의 동작을 맞춤 설정할 수 있습니다.

웹훅이 실행되는 시점과 요청 형식은 대화 시작 웹훅을 참조하세요.

작동 방식

Twilio 통화가 수신되면 ElevenAgents가 지정한 엔드포인트로 웹훅 호출을 수행하며, 통화 정보(caller_id, agent_id, called_number, call_sid, conversation_id)를 인수로 전달합니다.
웹훅은 동적 변수와 오버라이드를 포함한 대화 시작 클라이언트 데이터를 반환합니다(아래 예시 참조).
이 데이터로 대화를 시작합니다.

시스템은 Twilio의 연결/다이얼링 시간을 활용해 웹훅 데이터를 병렬로 가져오므로, 다음과 같은 원활한 경험을 제공합니다.

사용자는 예상되는 전화 연결음을 듣습니다.
동시에 ElevenAgents가 필요한 웹훅 데이터를 가져옵니다.
오디오 연결이 설정될 때까지 가져온 데이터로 대화를 시작합니다.

구성

웹훅 세부 정보 구성

ElevenAgents의 설정 페이지에서 웹훅 URL을 구성하고 인증에 필요한 시크릿을 추가하세요.

웹훅을 클릭하여 헤더로 전송할 시크릿을 수정하세요.

대화 시작 데이터 가져오기 활성화

에이전트 페이지의 “Security” 탭에서 수신 Twilio 통화의 대화 시작 데이터 가져오기를 활성화하고, 오버라이드할 수 있는 필드를 정의하세요.

Twilio 데이터를 수신할 웹훅 엔드포인트 구현

웹훅은 다음 매개변수가 포함된 POST 요청을 수신합니다.

매개변수	유형	설명
`caller_id`	string	발신자의 전화번호
`agent_id`	string	통화를 수신하는 에이전트의 ID
`called_number`	string	전화를 건 Twilio 번호
`call_sid`	string	Twilio 통화의 고유 식별자
`conversation_id`	string	ElevenLabs 대화 식별자

대화 시작 클라이언트 데이터 반환

웹훅은 에이전트의 시작 데이터가 포함된 JSON 응답을 반환해야 합니다.

dynamic_variables 필드에는 에이전트에 정의된 모든 동적 변수가 포함되어야 합니다. 반면 오버라이드는 완전히 선택 사항입니다. 동적 변수와 오버라이드에 관한 자세한 내용은 동적 변수 및 오버라이드 문서를 참조하세요.

응답 예시는 다음과 같습니다.

{
  "type": "conversation_initiation_client_data",
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "prompt": "The customer's bank account balance is $100. They are based in San Francisco.",
        "llm": "gpt-5.6-luna"
      },
      "first_message": "Hi, how can I help you today?",
      "language": "en"
    },
    "tts": {
      "voice_id": "new-voice-id"
    },
    "conversation": {
      "text_only": false
    }
  },
  "dynamic_variables": {
    "customer_name": "John Doe",
    "account_status": "premium",
    "last_interaction": "2026-01-15"
  },
  "branch_id": "agtbrch_xxxx",
  "environment": "production"
}

ElevenAgents는 동적 변수를 사용하여 대화 시작 데이터를 채우고, 대화가 원활하게 시작됩니다.

통화 처리가 지연되지 않도록 웹훅이 적절한 제한 시간 내에 응답하는지 확인하세요.

보안

HTTPS 엔드포인트만 사용하세요.
요청 헤더를 사용하여 인증을 구현하세요.
민감한 값은 ElevenLabs 시크릿 관리자를 통해 시크릿으로 저장하세요.
들어오는 요청 매개변수를 검증하세요.