네이버톡톡 연동 생성
중지 상태의 네이버톡톡 연동과 15분 동안 유효한 확인 코드를 생성합니다. API 서버 주소에 webhook_path를 붙인 URL을 네이버 파트너센터에 등록한 뒤, 고객용 톡톡 대화창에서 확인 코드를 보내야 합니다. 토큰을 저장하는 것만으로는 연동 확인이나 활성화가 끝나지 않습니다.
Authorizations
워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Headers
Supabase JWT로 인증할 때 필요한 워크스페이스(organization_id) UUID입니다. 워크스페이스 API 키로 인증하면 그 키의 워크스페이스를 사용합니다.
Body
이 엔드포인트의 요청 데이터입니다.
네이버 파트너센터의 파트너 ID입니다. 표시와 파트너센터 링크에만 쓰며 계정 소유를 증명하지 않습니다.
1 - 255연동 표시 이름입니다.
1 - 255agent_id와 agent_version으로 구성된 에이전트 매핑 객체입니다.
네이버 파트너센터에서 복사한 Authorization 토큰입니다. 응답에는 반환하지 않습니다.
1 - 4096Response
성공 응답
네이버톡톡 연동 ID입니다.
연동이 속한 워크스페이스 ID입니다.
네이버 파트너센터의 파트너 ID입니다.
연동 표시 이름입니다.
agent_id와 agent_version으로 구성된 에이전트 매핑 객체입니다.
연동 상태입니다. active는 활성, disabled는 중지(새 연동 포함), disconnected는 해제된 연동입니다.
active, disabled, disconnected 연동 설정의 버전 번호입니다. 설정 수정, 확인 코드 재발급, 활성화·중지, 해제 때마다 올라가며 이전 버전에서 대기하던 작업은 실행하지 않습니다.
API 서버 주소 뒤에 붙여 네이버 파트너센터에 웹훅 URL로 등록할 경로입니다.
연동 확인을 마친 시각입니다(unix ms). 아직 확인하지 않았거나 확인이 무효가 되면 null입니다.
지금 확인 코드가 만료되는 시각입니다(unix ms). 코드는 발급하고 15분 동안 유효합니다.
이 연동으로 네이버 웹훅 이벤트를 마지막으로 받은 시각입니다(unix ms). 받은 적이 없으면 null입니다.
연동 확인 응답을 네이버로 보내지 못했을 때의 오류 코드입니다. 확인에 성공하거나 확인 코드가 새로 발급되면 null이 됩니다.
리소스 생성 시각입니다. unix milliseconds 형식입니다.
리소스 마지막 수정 시각입니다. unix milliseconds 형식입니다.
15분 안에 고객용 톡톡 대화창에서 그대로 보낼 일회용 연동 확인 코드입니다. 연동 생성과 확인 코드 재발급 응답에만 들어 있습니다.