Skip to main content
POST
네이버톡톡 응대권 전환

Authorizations

Authorization
string
header
required

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

Headers

X-Vox-Chat-Turn-Id
integer | null

에이전트가 지금 처리 중인 입력 ID입니다. 워크스페이스 API 키로 요청할 때 필요하고, AI가 응대 중인 대화의 지금 네이버톡톡 입력이어야 합니다. 에이전트 도구에서는 시스템 변수 {{chat_turn_id}}를 넣습니다.

Required range: 1 <= x <= 9223372036854776000
Idempotency-Key
string
required

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

Required string length: 1 - 255
X-Vox-Organization-Id
string<uuid>

Supabase JWT로 인증할 때 필요한 워크스페이스(organization_id) UUID입니다. 워크스페이스 API 키로 인증하면 그 키의 워크스페이스를 사용합니다.

Path Parameters

chat_id
string<uuid>
required

응대권을 전환할 네이버톡톡 채팅 ID입니다.

Body

application/json

이 엔드포인트의 요청 데이터입니다.

target
enum<string>
required

응대권을 넘길 대상입니다. external은 파트너센터 상담사에게 넘기고 ai는 에이전트로 되돌리며, ai는 Supabase JWT나 내부 관리자 인증으로만 요청할 수 있습니다.

Available options:
ai,
external

Response

성공 응답

chat_id
string<uuid>
required

채팅 ID입니다.

command_id
integer
required

응대권 전환 요청 ID입니다.

status
enum<string>
required

전환 요청의 처리 상태입니다. pending·sending은 처리 중, sent는 완료, failed는 실패, unknown은 결과 불명이며 unknown은 자동으로 다시 보내지 않습니다.

Available options:
pending,
sending,
sent,
failed,
unknown
result_code
string | null
required

전환 요청의 결과 코드입니다. 네이버가 성공으로 응답하면 00이고, 실패했거나 결과를 모르면 그 사유 코드이며, 처리 전이면 null입니다.

observed_owner
enum<string>
required

요청을 처리한 뒤의 네이버 응대권 주인입니다. ai는 에이전트, external은 파트너센터 상담사가 응대 중이고, unknown은 응대권을 확인하지 못한 상태라 AI가 답하지 않습니다.

Available options:
ai,
external,
unknown
revision
integer
required

요청을 처리한 뒤의 응대권 버전 번호입니다.