January 19, 2026 | ElevenLabs Documentation

에이전트 플랫폼

에이전트 요약 엔드포인트: 워크스페이스의 모든 에이전트에 대한 경량 요약을 조회하는 GET /v1/convai/agents/summaries 엔드포인트를 추가했습니다. 전체 에이전트 구성을 가져오지 않고 에이전트 선택 인터페이스를 구축할 때 유용합니다.
배치 통화 삭제: 더 이상 필요하지 않은 배치 통화 작업을 제거하는 DELETE /v1/convai/batch-calling/{batch_id} 엔드포인트를 추가했습니다.
대화 브랜치 필터링: 에이전트 버전 브랜치별로 대화를 필터링할 수 있도록 GET /v1/convai/conversation/get-signed-url, GET /v1/convai/conversation/token, GET /v1/convai/conversations를 비롯한 대화 엔드포인트에 선택적 branch_id 쿼리 매개변수를 추가했습니다.
철자 입력 대기 설정: 턴 구성에 auto, low, medium, high 값을 사용하는 spelling_patience 설정을 추가했습니다. 사용자가 한 글자씩 철자를 입력한 뒤 완료했다고 간주하기 전까지 에이전트가 기다리는 시간을 제어합니다.
전환을 위한 맞춤 SIP 헤더: REFER를 통해 통화를 전환할 때 맞춤 SIP 헤더를 지원하도록 했습니다. 고급 전화 통신 통합을 위해 전화번호 전환 구성과 워크플로 전화 노드에서 custom_sip_headers 배열을 설정할 수 있습니다.
에이전트의 WhatsApp 계정: 이제 에이전트 응답에 연결된 WhatsApp Business 계정을 확인할 수 있는 whatsapp_accounts 배열이 포함됩니다.
Zendesk 통합 지원: Zendesk를 통해 시작된 대화를 위해 ConversationInitiationSource 열거형에 zendesk_integration을 추가했습니다.

오디오 출력 형식

확장된 형식 옵션: 이제 오디오 생성 엔드포인트에서 WAV 계열 변형, 새로운 OPUS 비트레이트 옵션, 전화 통신용 alaw_8000, ultra_lossless 품질 프리셋 등 추가 출력 형식을 지원합니다. 이는 텍스트 음성 변환, 텍스트 대화 변환, 음향 생성, 음악 및 보이스 디자인 엔드포인트에 적용됩니다.

더빙

확장된 상태 값: 더빙 프로젝트 상태에 더빙 진행 상황을 더욱 세밀하게 추적할 수 있는 추가 상태가 포함됩니다.
소스 언어: 이제 더빙 메타데이터를 가져올 때 항상 source_language 필드가 반환됩니다.

SDK 릴리스

Python SDK

v2.31.0 - 에이전트 요약 엔드포인트, 배치 통화 삭제, 대화 브랜치 필터링, 철자 입력 대기 설정 및 확장된 오디오 출력 형식을 추가했습니다.
v2.30.0 - 에이전트 WhatsApp 계정, Zendesk 통합 소스, 전환용 맞춤 SIP 헤더 및 표준화된 출력 형식 스키마를 추가했습니다.

JavaScript SDK

v2.32.0 - Scribe WebSocket URI용 audio_format 매개변수 지원, 에이전트 요약 엔드포인트, 배치 통화 삭제 및 확장된 오디오 출력 형식을 추가했습니다.
v2.31.0 - 에이전트 WhatsApp 계정, Zendesk 통합 소스, 전환용 맞춤 SIP 헤더 및 표준화된 출력 형식 스키마를 추가했습니다.

React 및 클라이언트 SDK

@elevenlabs/react@0.13.0 - 대화 시작 재정의, 오디오 정렬 이벤트 지원, 연결 오류 발생 시 WebSocket 종료 코드 노출을 추가하고 useScribe 훅의 Firefox AudioContext 문제를 수정했습니다.
@elevenlabs/client@0.13.0 - 대화 시작 재정의와 오디오 정렬 이벤트 지원을 추가하고 Scribe 정리 및 연결 해제 처리를 개선했습니다.

위젯 패키지

@elevenlabs/convai-widget-core@0.6.1 - 가독성 향상을 위한 문장 간격을 추가하고 사용자 메시지 말풍선의 여러 줄 표시를 수정했습니다.
@elevenlabs/convai-widget-embed@0.6.1 - 가독성 향상을 위한 문장 간격을 추가하고 사용자 메시지 말풍선의 여러 줄 표시를 수정했습니다.
@elevenlabs/convai-widget-core@0.6.0 - 대화 토큰 가져오기를 위한 오류 래핑을 개선하고 React Native 지원을 0.81로 업데이트했습니다.
@elevenlabs/convai-widget-embed@0.6.0 - 대화 토큰 가져오기를 위한 오류 래핑을 개선하고 React Native 지원을 0.81로 업데이트했습니다.

API

API 변경 사항 보기

새 엔드포인트

에이전트 요약 가져오기 - GET /v1/convai/agents/summaries - 모든 에이전트의 경량 요약 조회
배치 통화 삭제 - DELETE /v1/convai/batch-calling/{batch_id} - 배치 통화 작업 제거

업데이트된 엔드포인트

에이전트 플랫폼

서명된 URL 가져오기, 대화 토큰 가져오기, 대화 가져오기
- 에이전트 버전 브랜치별 필터링을 위한 branch_id(문자열, 선택 사항) 쿼리 매개변수를 추가했습니다.
에이전트 생성, 에이전트 업데이트, 에이전트 가져오기
- 턴 구성에 spelling_patience(열거형: auto, low, medium, high)를 추가했습니다.
- 에이전트 응답 모델에 whatsapp_accounts(배열)를 추가했습니다.
대화 시뮬레이션, 대화 스트림 시뮬레이션
- 요청 스키마가 업데이트되었습니다(호환성 깨짐 변경).
대화 가져오기
- 메타데이터에서 initiation_trigger를 제거했습니다(호환성 깨짐 변경).

음성 관리

음성 가져오기, 음성 가져오기, 음성 추가, 음성 편집
- labels 속성을 문서화된 키(언어, 억양, 성별, 연령)와 예시로 정교화했습니다.

오디오 생성

텍스트 음성 변환, 텍스트 대화 변환, 음향 생성, 음악
- output_format 열거형을 WAV 변형, 추가 OPUS 비트레이트, alaw_8000 및 재정렬된 PCM 옵션으로 확장했습니다.
- quality_preset 옵션에 ultra_lossless를 추가했습니다.

음성 텍스트 변환

음성 전사
- model_id에 명시적인 scribe_v1 및 scribe_v2 열거형 값을 추가했습니다.

더빙

더빙 프로젝트 가져오기
- status 열거형을 추가 진행 상태로 확장했습니다.
- 더빙 모델에 source_language(문자열, 필수)를 추가했습니다.

지식 베이스

지식 베이스 문서 생성, 파일에서 생성, 텍스트에서 생성
- 응답 모델에 folder_path를 추가했습니다.

스키마 변경 사항

새 스키마

CustomSIPHeader - 통화 전환 시 맞춤 SIP 헤더 구성
SpellingPatience - 철자 입력 대기 설정을 위한 열거형(auto, low, medium, high)
AllowedOutputFormats - 오디오 출력 형식 옵션을 위한 중앙화된 열거형

수정된 스키마

ConversationInitiationSource - zendesk_integration 열거형 값을 추가했습니다.
PermissionType - 보이스 라이브러리 게시 및 사용자 API 키 생성을 포함한 새 권한이 추가된 중앙화된 권한 열거형입니다.
PhoneNumberTransfer - custom_sip_headers 배열을 추가했습니다.
TurnConfig - spelling_patience 필드를 추가했습니다.