> ## 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이 대화를 자동으로 요약하고, 사전 정의된 기준에 따라 데이터를 추출합니다. 분석 결과로 에이전트 품질을 개선하세요.

<Note>
  기본 분석은 별도 추출 설정 없이 실행됩니다. 커스텀 분석 필드를 만들려면 빌드
  단계에서 [추출 설정](/docs/build/post-call/extraction)을 구성하세요.
</Note>

## 분석 유형

### 기본 분석

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

### 커스텀 추출

에이전트 설정에서 추가로 추출할 데이터 타입을 정의할 수 있습니다.

| 타입          | 설명         | 예시                  |
| ----------- | ---------- | ------------------- |
| **string**  | 자유 텍스트 추출. | 문의사항 요약, 고객 요구사항.   |
| **number**  | 숫자 추출.     | 만족도 점수, 예상 금액.      |
| **boolean** | 예/아니오 판단.  | 문제 해결 여부, 예약 확정 여부. |
| **enum**    | 선택지 중 분류.  | 문의 유형 (기술/결제/배송).   |

## 결과 확인

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

### 대시보드

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

### 웹훅

웹훅으로도 분석 결과를 받을 수 있습니다.
v2에서는 `call_analyzed` 이벤트의 `call_analysis` 필드에 분석 결과가 포함됩니다.
기존 v1에서는 `call_ended` 이벤트에 같은 필드가 포함됩니다.

```json theme={null}
{
  "event": "call_analyzed",
  "call": {
    "call_analysis": {
      "summary": "고객이 배송 지연 관련 문의를 했으며, 상담원이 배송 상태를 확인해 안내했습니다.",
      "user_sentiment": "neutral",
      "custom_analysis_data": [
        { "type": "string", "name": "문의사항", "value": "배송 지연 확인" },
        { "type": "boolean", "name": "문제 해결 여부", "value": true }
      ]
    }
  }
}
```

자세한 웹훅 페이로드는 [에이전트 웹훅](/docs/operate/monitor/webhooks/agent)을 참고하세요.

### API

통화 조회 API로 `call_analysis` 필드를 가져올 수 있습니다. 전체 파라미터는 [v3 API 참조](/api-reference/v3/introduction)에서 확인하세요.

## 활용 사례

* **품질 모니터링** — 문제 해결률, 고객 감정 추이를 추적하여 에이전트 프롬프트를 개선하세요.
* **자동 분류** — 문의 유형별로 통화를 분류하여 운영 인사이트를 도출하세요.
* **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`.

## 관련 문서

* [추출 설정](/docs/build/post-call/extraction) — 빌드 단계에서 분석 항목 구성
* [통화 기록](/docs/operate/monitor/history) — 통화별 분석 결과 조회
* [에이전트 웹훅](/docs/operate/monitor/webhooks/agent) — 웹훅 버전별 분석 결과 페이로드
* [내보내기](/docs/operate/monitor/exports) — 분석 데이터 파일 추출

***

<Accordion title="연관 검색어">
  통화 후 분석, post-call analysis, 요약, 감정 분석, 추출, call\_analysis, call\_analyzed, 커스텀 분석
</Accordion>