Skip to main content
POST
진행 중 통화 전환 요청

Authorizations

Authorization
string
header
required

워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Headers

Idempotency-Key
string
required

상태를 변경하는 POST 요청에 필요한 멱등성 키입니다. 24시간 동안 안전하게 재시도할 때 사용합니다. 값은 비어 있으면 안 됩니다. 최대 255자까지 허용합니다.

Required string length: 1 - 255

Path Parameters

call_id
string<uuid>
required

통화 ID입니다.

Body

application/json

진행 중인 통화 전환 명령의 요청 본문입니다.

진행 중 전화 통화 전환 요청.

mode
enum<string>
required

전환 방식. cold 또는 warm 중 하나를 반드시 지정합니다.

Available options:
cold,
warm
destination
TransferDestination · object
required

명시적인 transport type과 전환 대상 원문입니다.

timeout_seconds
integer | null

warm 전환 대상의 응답 대기 시간(초). 1~120 범위이며 생략하면 agent의 기본값을 사용합니다. cold 요청에는 사용할 수 없습니다.

Required range: 1 <= x <= 120
displayed_caller_id
enum<string>
default:agent

기존 transfer config의 displayedCallerId와 같은 발신자 번호 정책입니다. agent는 조직/에이전트 번호를, user는 현재 고객 번호를 사용합니다. 실제 번호는 통화 방향에 따라 agent-server가 런타임에 결정합니다.

Available options:
agent,
user

Response

성공 응답

202 응답 — transfer command 전달 수락 결과.

call_id
string<uuid>
required

전환을 요청한 통화 UUID입니다.

mode
enum<string>
required

요청한 전환 방식입니다.

Available options:
cold,
warm
destination
TransferDestination · object
required

요청한 transport type과 전환 대상 원문입니다.

status
string
required

LiveKit Room으로 control packet 전달을 수락한 상태입니다. 실제 전환 완료나 대상 응답을 의미하지 않습니다.

Allowed value: "accepted"
control_id
string
required

재전송 dedupe에 사용하는 안정적인 control ID입니다.