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

맥락 전달 요청 본문입니다. expires_in_seconds는 response가 when_idle이나 interrupt_agent일 때만 보냅니다.

진행 중인 통화에 맥락을 전달하는 요청입니다.

text
string
required

통화에 전달할 맥락입니다. 공백만 있거나 NUL 문자가 있거나 요청 정보를 더해 UTF-8 16KiB를 넘으면 400 INVALID_CONTEXT_REQUEST입니다. 에이전트는 고객의 말이나 지시가 아닌 업무 시스템 데이터로 이후 응답에 참고합니다.

response
enum<string>
default:none

에이전트가 먼저 말할지 정합니다. 기본값 none은 기억만 하고, when_idle은 통화가 조용해지면 한 번 말하고, interrupt_agent는 에이전트의 말을 끊고 바로 답합니다. 고객이 말하는 중이면 둘 다 말이 끝난 뒤 답에 합칩니다.

Available options:
none,
when_idle,
interrupt_agent
expires_in_seconds
integer

말하기 시작할 때까지의 기한(초)입니다. when_idle·interrupt_agent에서만 1~180, 기본 90초이며 none에 보내거나 범위를 벗어나면 400 INVALID_CONTEXT_REQUEST입니다. 지나면 말하지 않고 맥락만 남습니다.

Required range: 1 <= x <= 180

Response

성공 응답

맥락 전달 요청을 수락했을 때의 202 응답입니다.

call_id
string<uuid>
required

맥락을 보낸 통화 UUID입니다.

control_id
string
required

요청 ID입니다. 같은 Idempotency-Key면 같은 값이며 call_context 웹훅의 control_id와 같습니다.

status
string
required

항상 accepted입니다. 통화에 전달하도록 요청을 수락했다는 뜻이며, 반영·발화 결과는 텍스트 없이 call_context 웹훅으로 알립니다.

Allowed value: "accepted"