네이버톡톡 응대권 전환
네이버 응대권 전환을 요청하고 저장된 처리 결과를 반환합니다. API 키를 쓰는 에이전트 도구는 X-Vox-Chat-Turn-Id와 도구마다 고정한 Idempotency-Key를 지정해 external로 전환할 수 있습니다. AI 복구(target=ai)에는 대시보드 로그인 인증(Supabase JWT)이나 내부 관리자 인증이 필요합니다. 결과가 unknown이면 자동으로 다시 보내지 않으며, 같은 키로 다시 요청하면 기존 결과를 돌려줍니다.
Authorizations
워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Headers
에이전트가 지금 처리 중인 입력 ID입니다. 워크스페이스 API 키로 요청할 때 필요하고, AI가 응대 중인 대화의 지금 네이버톡톡 입력이어야 합니다. 에이전트 도구에서는 시스템 변수 {{chat_turn_id}}를 넣습니다.
1 <= x <= 9223372036854776000상태를 변경하는 POST 요청에 필요한 멱등성 키입니다. 24시간 동안 안전하게 재시도할 때 사용합니다. 값은 비어 있으면 안 됩니다. 최대 255자까지 허용합니다.
1 - 255Supabase JWT로 인증할 때 필요한 워크스페이스(organization_id) UUID입니다. 워크스페이스 API 키로 인증하면 그 키의 워크스페이스를 사용합니다.
Path Parameters
응대권을 전환할 네이버톡톡 채팅 ID입니다.
Body
이 엔드포인트의 요청 데이터입니다.
응대권을 넘길 대상입니다. external은 파트너센터 상담사에게 넘기고 ai는 에이전트로 되돌리며, ai는 Supabase JWT나 내부 관리자 인증으로만 요청할 수 있습니다.
ai, external Response
성공 응답
채팅 ID입니다.
응대권 전환 요청 ID입니다.
전환 요청의 처리 상태입니다. pending·sending은 처리 중, sent는 완료, failed는 실패, unknown은 결과 불명이며 unknown은 자동으로 다시 보내지 않습니다.
pending, sending, sent, failed, unknown 전환 요청의 결과 코드입니다. 네이버가 성공으로 응답하면 00이고, 실패했거나 결과를 모르면 그 사유 코드이며, 처리 전이면 null입니다.
요청을 처리한 뒤의 네이버 응대권 주인입니다. ai는 에이전트, external은 파트너센터 상담사가 응대 중이고, unknown은 응대권을 확인하지 못한 상태라 AI가 답하지 않습니다.
ai, external, unknown 요청을 처리한 뒤의 응대권 버전 번호입니다.