Skip to main content
POST
네이버톡톡 연결 생성

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Headers

X-Vox-Organization-Id
string<uuid>

Supabase JWT 인증을 사용할 때 필수인 organization UUID입니다. 조직 API key는 해당 key의 조직 범위를 사용합니다.

Body

application/json

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

partner_id
string
required

네이버 파트너 ID. 표시 및 파트너센터 링크에 사용하며 계정 소유 증명은 아닙니다.

Required string length: 1 - 255
display_name
string
required

연결 표시 이름

Required string length: 1 - 255
agent
AgentMapping · object
required

agent_idagent_version으로 구성된 에이전트 매핑 객체입니다.

access_token
string<password>
required
write-only

네이버 Authorization 토큰. 응답에는 반환하지 않습니다.

Required string length: 1 - 4096

Response

성공 응답

id
string<uuid>
required

응답 객체 자체의 ID 또는 중첩 설정 객체 안의 로컬 ID입니다.

organization_id
string<uuid>
required
partner_id
string
required
display_name
string | null
required
agent
AgentMapping · object
required

agent_idagent_version으로 구성된 에이전트 매핑 객체입니다.

status
enum<string>
required

리소스의 현재 상태입니다.

Available options:
active,
disabled,
disconnected
revision
integer
required
webhook_path
string
required

API 서버 origin에 붙여 네이버 웹훅 URL로 등록할 경로

verified_at
integer | null
required
verification_expires_at
integer
required
last_received_at
integer | null
required
last_error_code
string | null
required
created_at
integer
required

리소스 생성 시각입니다. unix milliseconds 형식입니다.

updated_at
integer
required

리소스 마지막 수정 시각입니다. unix milliseconds 형식입니다.

verification_code
string
required

15분 안에 네이버 고객 대화창에서 직접 보낼 일회용 연결 확인 코드