Skip to main content
GET
네이버톡톡 응대권 조회

Authorizations

Authorization
string
header
required

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

Headers

X-Vox-Organization-Id
string<uuid>

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

Path Parameters

chat_id
string<uuid>
required

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

Response

성공 응답

자격증명을 제외한 네이버 응대권과 마지막 전환 요청의 조회 결과입니다.

chat_id
string<uuid>
required

채팅 ID입니다.

connection_id
string<uuid>
required

이 채팅이 들어온 네이버톡톡 연동 ID입니다.

connection_status
enum<string>
required

이 채팅이 들어온 연동의 상태입니다. active는 활성, disabled는 중지, disconnected는 해제된 연동입니다.

Available options:
active,
disabled,
disconnected
observed_owner
enum<string>
required

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

Available options:
ai,
external,
unknown
revision
integer
required

응대권 기록의 버전 번호입니다. 응대권 기록이 갱신될 때마다 올라가며 주인이 같아도 올라갈 수 있고, 아직 기록이 없으면 0입니다.

can_request
boolean
required

지금 응대권 전환을 새로 요청할 수 있으면 true입니다. 채팅이 진행 중이고, 연동이 활성화·확인된 상태이며, 스팸 대화가 아니고, 처리 중인 전환이 없어야 합니다.

command_id
integer | null
required

조회한 응대권 전환 요청 ID입니다. 보내는 중인 요청이 있으면 그 요청을, 없으면 지금 연동 설정에서 한 마지막 요청을 가리키며, 둘 다 없으면 null입니다.

command_status
enum<string> | null
required

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

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

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