Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt

Use this file to discover all available pages before exploring further.

통화 종료 후 LLM이 대화를 자동으로 요약하고, 사전 정의된 기준에 따라 데이터를 추출합니다. 분석 결과로 에이전트 품질을 개선하세요.
기본 분석은 별도 추출 설정 없이 실행됩니다. 커스텀 분석 필드를 만들려면 빌드 단계에서 추출 설정을 구성하세요.

​
분석 유형

​
기본 분석

분석 대상 통화가 종료되면 요약과 유저 감정이 자동으로 생성됩니다. 이 값은 통화 상세, 내보내기, 웹훅의 call_analysis에서 확인할 수 있습니다.

​
커스텀 추출

에이전트 설정에서 추가로 추출할 데이터 타입을 정의할 수 있습니다.
타입설명예시
string자유 텍스트 추출.문의사항 요약, 고객 요구사항.
number숫자 추출.만족도 점수, 예상 금액.
boolean예/아니오 판단.문제 해결 여부, 예약 확정 여부.
enum선택지 중 분류.문의 유형 (기술/결제/배송).

​
결과 확인

분석 결과는 세 가지 경로로 확인할 수 있습니다.

​
대시보드

통화 기록에서 개별 통화를 선택하면 요약, 자동 평가, 감정 분석, 커스텀 분석 결과를 확인할 수 있습니다. 커스텀 분석 필드는 통화 기록 테이블의 칼럼으로도 표시됩니다.

​
웹훅

웹훅으로도 분석 결과를 받을 수 있습니다. v2에서는 call_analyzed 이벤트의 call_analysis 필드에 분석 결과가 포함됩니다. 기존 v1에서는 call_ended 이벤트에 같은 필드가 포함됩니다. 
{
  "event": "call_analyzed",
  "call": {
    "call_analysis": {
      "summary": "고객이 배송 지연 관련 문의를 했으며, 상담원이 배송 상태를 확인해 안내했습니다.",
      "user_sentiment": "neutral",
      "custom_analysis_data": [
        { "type": "string", "name": "문의사항", "value": "배송 지연 확인" },
        { "type": "boolean", "name": "문제 해결 여부", "value": true }
      ]
    }
  }
}
자세한 웹훅 페이로드는 에이전트 웹훅을 참고하세요.

​
API

통화 조회 API로 call_analysis 필드를 가져올 수 있습니다. 전체 파라미터는 v3 API 참조에서 확인하세요.

​
활용 사례

  • 품질 모니터링 — 문제 해결률, 고객 감정 추이를 추적하여 에이전트 프롬프트를 개선하세요.
  • 자동 분류 — 문의 유형별로 통화를 분류하여 운영 인사이트를 도출하세요.
  • CRM 연동 — 웹훅으로 분석 결과를 CRM에 자동으로 저장하세요.

​
제한사항

  • 분석은 통화 종료 후 비동기로 실행되며, 결과까지 수 초가 걸릴 수 있습니다.
  • opt_out_sensitive_data_storage가 활성화된 통화는 스크립트가 저장되지 않아 요약과 커스텀 추출 결과가 비워질 수 있습니다.
  • 통화 대화가 충분하지 않은 종료 사유는 분석이 건너뛰어질 수 있습니다. 예: dial_no_answer, dial_failed, dial_busy, voicemail_reached, concurrency_limit_reached, insufficient_balance, error_voxai, flow_error.

​
관련 문서

통화 후 분석, post-call analysis, 요약, 감정 분석, 추출, call_analysis, call_analyzed, 커스텀 분석