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
transfer_number
string
required

전환 대상 전화번호 또는 SIP URI 원문. 전화번호에는 공백·점·괄호·하이픈을 허용하며, API와 control payload에서는 입력 문자열을 그대로 유지합니다.

Required string length: 1 - 128
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
transfer_number
string
required

전환 대상 전화번호 또는 SIP URI 원문입니다. 입력 형식을 그대로 반환합니다.

status
string
required

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

Allowed value: "accepted"
control_id
string
required

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