> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telloai.io/llms.txt
> Use this file to discover all available pages before exploring further.

# getSummary

> 완료된 통화의 전사·요약·차감 크레딧을 조회해요.

## 할 수 있는 일

끝난 통화의 결과를 조회해요. 전사, 요약, 통화 시간, 차감된 크레딧이 함께 와요. 진행 중인
통화가 없어도 되므로 통화가 끝난 뒤 언제든 호출할 수 있어요.

## 시그니처

<CodeGroup>
  ```python Python theme={null}
  await client.get_summary(call_id: str, request_id: str | None = None) -> None
  ```

  ```ts Node theme={null}
  await client.getSummary(callId: string, requestId?: string): Promise<void>
  ```

  ```go Go theme={null}
  err := client.GetSummary(ctx context.Context, callID, requestID string) error
  ```

  ```java Java theme={null}
  CompletableFuture<Void> getSummary(String callId)
  CompletableFuture<Void> getSummary(String callId, String requestId)
  ```
</CodeGroup>

## 파라미터

| 이름          | 필수 | 기본값 | 설명                                     |
| ----------- | -- | --- | -------------------------------------- |
| `callId`    | 필수 | 없음  | 조회할 통화 id. `call.created`에서 받은 값이에요    |
| `requestId` | 선택 | 없음  | `call.summary`에 그대로 에코돼요. 응답을 짝지을 때 써요 |

## 결과

```text theme={null}
call.summary   requestId · callId · status · durationSeconds
               transcript · summary · creditCharged
```

| 필드                | 설명                    |
| ----------------- | --------------------- |
| `status`          | 항상 `completed`예요      |
| `durationSeconds` | 통화 시간(초). null일 수 있어요 |
| `transcript`      | 전사 전문. null일 수 있어요    |
| `summary`         | 요약. null일 수 있어요       |
| `creditCharged`   | 차감된 크레딧. null일 수 있어요  |

`call.summary`는 통화 스트림 이벤트가 아니라 명령 응답이라 `sessionId`와 `timestamp`가
비어 있어요.

## 오류

| 코드                 | 클래스               | 언제                      |
| ------------------ | ----------------- | ----------------------- |
| `callIdRequired`   | `ValidationError` | `callId`가 비어 있음         |
| `callNotFound`     | `ValidationError` | 이 계정 소유의 통화가 아니거나 없는 통화 |
| `callNotCompleted` | `ValidationError` | 통화가 아직 `completed`가 아님  |

## 주의사항

* `completed`인 통화만 조회할 수 있어요. `noAnswer`·`failed`·`cancelled`로 끝난 통화는
  `callNotCompleted`가 나요.
* 종단 이벤트를 받자마자 호출하면 아직 집계 전일 수 있어요.

## 관련 문서

* [이벤트](/developer/sdk/events)
* [오류](/developer/sdk/errors)
* [통화 목록 / 상세](/calls/list)