통화

통화 중 이벤트 조회

Markdown으로 보기
GET
/v1/accounts/{accountId}/calls/{callId}/live-events

관리형 에이전트 통화의 실시간 전사·키패드 이벤트를 id 순서로 반환합니다. 통화 중에도, 끝난 뒤에도 조회할 수 있습니다. 에이전트 설정 liveEvents.events 에 고른 이벤트만 있습니다. 통화 중 실시간으로 받으려면 …/live-events/stream 을 쓰세요.

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*string
callId*string

Query Parameters

after?string

이 id 다음 이벤트부터 반환합니다. 없으면 처음부터.

Match^[0-9]{1,19}$
limit?integer
Default200
Range1 <= value <= 1000

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/calls/CA1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6/live-events?after=18340&limit=200"
{
  "data": [
    {
      "id": "18341",
      "event": "transcript.final",
      "timestamp": "2026-10-21T06:50:59.300Z",
      "detail": {
        "utteranceId": "u3",
        "role": "agent",
        "text": "평일 오전 9시부터 오후 6시까지입니다."
      }
    }
  ],
  "hasMore": false
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ]
}