대화·음성 API와 SDK 확장
대화 조회, 배치 호출, 오디오 출력 형식, 더빙 상태와 여러 SDK 기능이 확장되었습니다.
교안에 영향
기존 안내 문서의 대화 조회 예시에는 branch_id 필터와 새 agents summaries, batch 삭제 endpoint가 빠져 있어 그대로 쓰기 어렵습니다.
요약
- GET /v1/convai/agents/summaries로 워크스페이스의 에이전트 요약을 가볍게 조회할 수 있게 됐습니다.
- DELETE /v1/convai/batch-calling/{batch_id}가 추가되고, 대화 조회에는 branch_id 필터가 붙었습니다.
- spelling_patience 설정과 custom_sip_headers 지원이 추가되고, WhatsApp 계정과 Zendesk 연동 정보가 응답에 포함됩니다.
- 오디오 출력 형식이 확장되고, 더빙 프로젝트 상태 값과 메타데이터 반환 항목이 늘었습니다.
- Python SDK, JavaScript SDK, React/Client SDK, 위젯 패키지가 새 기능과 수정사항을 반영해 갱신되었습니다.
바뀐 것
새 기능
- GET /v1/convai/agents/summaries endpoint가 추가되어 워크스페이스의 모든 agent 요약을 가볍게 조회할 수 있게 됐습니다.
- DELETE /v1/convai/batch-calling/{batch_id} endpoint가 추가되어 더 이상 필요 없는 batch call job을 삭제할 수 있게 됐습니다.
- GET /v1/convai/conversation/get-signed-url, GET /v1/convai/conversation/token, GET /v1/convai/conversations에 optional branch_id query parameter가 추가되어 agent version branch 기준으로 대화를 필터링할 수 있게 됐습니다.
- turn configuration에 spelling_patience setting이 추가되어 auto, low, medium, high 값으로 철자 입력 대기 시간을 조절할 수 있게 됐습니다.
- 전화번호 transfer configuration과 workflow phone node에서 REFER 전송용 custom_sip_headers arrays를 지원합니다.
- Agent responses에 whatsapp_accounts array가 추가되어 연결된 WhatsApp Business accounts를 볼 수 있게 됐습니다.
- ConversationInitiationSource enum에 zendesk_integration이 추가되어 Zendesk를 통해 시작된 대화를 구분할 수 있게 됐습니다.
- Audio generation endpoints가 WAV 계열 변형, 새로운 OPUS bitrate 옵션, alaw_8000, ultra_lossless quality preset을 포함한 추가 output formats를 지원합니다.
- Dubbing project status에 더 세밀한 진행 추적을 위한 상태 값이 추가됐습니다.
- dub 메타데이터 조회 시 source_language 필드가 항상 반환되도록 변경됐습니다.
기타
- Python SDK v2.31.0과 v2.30.0, JavaScript SDK v2.32.0과 v2.31.0이 새 endpoint, branch filtering, spelling_patience, audio output formats, WhatsApp accounts, Zendesk integration source, custom SIP headers, standardized output format schema를 반영했습니다.
- @elevenlabs/react@0.13.0과 @elevenlabs/client@0.13.0이 conversation initiation overrides, audio alignment event support, WebSocket close code exposure, Scribe cleanup and disconnect handling, Firefox AudioContext 문제 수정 등을 반영했습니다.
- @elevenlabs/convai-widget-core와 @elevenlabs/convai-widget-embed의 0.6.1, 0.6.0이 sentence spacing, multiline display 수정, conversation token fetching 에러 래핑, React Native support 0.81 업데이트를 반영했습니다.