진행 중 통화 전환 요청
진행 중인 전화 통화에 즉시 전환 (cold) 또는 안내 후 전환 (warm)을 요청합니다. 전환 대상은 전화번호 또는 SIP URI로 지정할 수 있습니다. 202 응답은 서버가 보낸 전환 명령이 진행 중인 통화에 전달되어 수락되었다는 뜻입니다. 실제 전환 완료나 전환 대상의 응답을 뜻하지 않습니다.
Authorizations
조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Headers
상태를 변경하는 POST 요청에 필요한 멱등성 키입니다. 24시간 동안 안전하게 재시도할 때 사용합니다. 값은 비어 있으면 안 됩니다. 최대 255자까지 허용합니다.
1 - 255Path Parameters
통화 ID입니다.
Body
진행 중인 통화 전환 명령의 요청 본문입니다.
진행 중 전화 통화 전환 요청.
전환 방식. cold 또는 warm 중 하나를 반드시 지정합니다.
cold, warm 전환 대상 전화번호 또는 SIP URI 원문. 전화번호에는 공백·점·괄호·하이픈을 허용하며, API와 control payload에서는 입력 문자열을 그대로 유지합니다.
1 - 128warm 전환 대상의 응답 대기 시간(초). 1~120 범위이며 생략하면 agent의 기본값을 사용합니다. cold 요청에는 사용할 수 없습니다.
1 <= x <= 120기존 transfer config의 displayedCallerId와 같은 발신자 번호 정책입니다. agent는 조직/에이전트 번호를, user는 현재 고객 번호를 사용합니다. 실제 번호는 통화 방향에 따라 agent-server가 런타임에 결정합니다.
agent, user Response
성공 응답
202 응답 — transfer command 전달 수락 결과.
전환을 요청한 통화 UUID입니다.
요청한 전환 방식입니다.
cold, warm 전환 대상 전화번호 또는 SIP URI 원문입니다. 입력 형식을 그대로 반환합니다.
LiveKit Room으로 control packet 전달을 수락한 상태입니다. 실제 전환 완료나 대상 응답을 의미하지 않습니다.
"accepted"재전송 dedupe에 사용하는 안정적인 control ID입니다.