Skip to main content
네이버톡톡 계정을 붙이면 고객이 톡톡 대화방에서 보낸 문의에 에이전트가 답해요. 사람이 나서야 할 때는 네이버 파트너센터에서 이어받고, 그 답장도 같은 대화 이력에 쌓여요. 대화는 고객이 먼저 메시지를 보내야 시작해요. 문의 없이 먼저 보내는 메시지는 지원하지 않아요. 계정마다 답할 에이전트와 버전을 고르고, 여러 계정에 같은 에이전트를 연결해도 돼요. 붙여 둔 계정의 상태와 마지막 수신은 연동 개요에서 보세요.

​
준비물

파트너센터 왼쪽 메뉴의 연동 관리 > 챗봇API 설정에서 신청하기를 눌러 챗봇 API 사용 신청을 먼저 마치세요. 승인되어야 연동에 넣을 파트너 ID와 Authorization 토큰이 화면에 나타나요. 네이버 파트너센터 연동 관리 > 챗봇API 설정의 챗봇 API 신청하기
  • 기존 웹훅 확인: 톡톡 계정 하나는 웹훅 주소를 하나만 가져요. 이미 다른 서비스가 등록돼 있으면 vox.ai 주소로 바꾸는 순간 그 서비스의 수신이 끊겨요. 어떤 서비스가 쓰고 있는지 먼저 확인하고 전환 시각을 정하세요.
  • 쇼핑챗봇과 AI FAQ 끄기: 스마트스토어의 톡톡 쇼핑챗봇이나 AI FAQ가 켜져 있으면 챗봇 API로 메시지를 주고받지 못해요. 스마트스토어 센터의 문의·리뷰관리 > 톡톡상담관리 > 톡톡 쇼핑챗봇·AI FAQ 설정에서 끈 뒤 연동하세요.
  • 응답할 에이전트: 문의에 답할 에이전트와 버전을 정하세요.
  • 사용 중인 계정: 계정 이름 아래에 톡톡 사용중 표시가 있어야 해요. 검수 중이거나 사용이 중지된 계정은 연결되지 않아요.
Authorization 토큰은 vox.ai 연동 설정에만 넣고, 에이전트 프롬프트나 도구 설정에는 넣지 마세요.
계정 검수와 챗봇 API 이용 조건은 네이버가 정하고, vox.ai의 연동 확인이 네이버 계정 검수를 대신하지 않아요. 이 문서의 파트너센터 화면은 예시라 네이버가 화면을 바꾸면 실제와 다를 수 있어요.

​
계정 연결하기

파트너센터와 vox.ai 두 화면을 오가며 끝내요. 파트너센터에서 값 두 개를 가져와 vox.ai에 넣고, vox.ai가 만든 주소를 파트너센터에 등록한 뒤, 고객 대화창에서 코드를 한 번 보내면 연결돼요. 네이버톡톡 연동 상세 화면의 연동 상태와 설정
1

파트너센터에서 파트너 ID와 Authorization 복사하기

파트너센터 왼쪽 메뉴의 연동 관리 > 챗봇API 설정을 여세요. 파트너 ID는 왼쪽 위 계정 이름 아래의 짧은 문자열이고, Authorization은 보내기 API 항목에 있어요. 두 값을 복사하세요. Authorization이 비어 있으면 옆의 생성을 눌러 새로 만드세요.파트너센터 챗봇API 설정의 파트너 ID와 Authorization 위치
2

vox.ai에서 연동 만들기

배포 > 연동에서 연동 만들기를 누르고 네이버톡톡을 고르세요. 아래 항목을 채우고 만들기를 누르면 확인 필요 상태로 만들어져요. 저장만으로는 연동 확인이 끝나지 않아요.
  • 이름: 연동 목록에서 계정을 구분할 이름
  • 파트너 ID: 파트너센터에서 복사한 계정 ID
  • Authorization 토큰: 파트너센터에서 복사한 챗봇 API 토큰
  • 에이전트: 문의에 답할 에이전트와 버전
3

웹훅 URL을 파트너센터에 등록하기

화면의 웹훅 URL을 복사해 파트너센터 챗봇API 설정의 이벤트 받을 URL에 붙여 넣으세요. 한 글자라도 다르면 문의가 들어오지 않아요. 이어서 이벤트 변경을 누르고 send와 echo만 골라 저장하세요. 같은 화면 아래의 핸드오버 API도 켜세요. 핸드오버가 꺼져 있으면 파트너센터에서 쓴 답장이 대화 이력에 남지 않아요.파트너센터 챗봇API 설정의 이벤트 받을 URL 입력과 send, echo 이벤트 선택
4

고객 대화창에서 확인 코드 보내기

화면의 연동 확인 코드를 복사해 그 계정의 고객용 톡톡 대화창에서 그대로 보내세요. 코드는 발급하고 15분 동안만 유효해요. 코드가 도착하면 연동 확인에 완료 시각이 나타나요. 만료됐거나 코드가 보이지 않으면 확인 코드 재발급으로 새로 받으세요. 다시 발급하면 이전 코드와 이전 확인 결과가 모두 무효가 돼요.
5

활성화하기

활성화를 누르세요. 고객은 고객 FA53C5B2처럼 식별자로 기록돼요. 네이버가 주는 사용자 키가 불투명해 이름, 전화번호, 이메일을 받지 못하기 때문이에요.
연동 확인은 그 시점의 메시지 왕복 결과예요. 그 뒤의 네이버 장애나 토큰 만료까지 보장하지는 않아요.

​
연결 확인

  • 고객용 톡톡 대화창에서 새 문의를 보내 에이전트의 답변이 오는지 확인하세요.
  • 기록의 채팅 탭에서 해당 대화를 열어 문의와 답변이 남았는지 확인하세요.

​
파트너센터에서 응대하기

사람이 답해야 할 때는 네이버 파트너센터에서 응대하세요. 기본 AI 답변에는 “상담원 연결” 버튼이 붙고, 고객이 이 버튼을 누르면 파트너센터로 전환을 요청해요. 상담사가 응대하는 동안과 응대권을 확인하는 동안에는 AI가 답하지 않아요.
  • 작성자 기록: 파트너센터에서 보낸 답장은 작성자가 상담사로 기록돼요. 네이버 직원을 한 명씩 구분하지는 않아요.
  • 상담 상태: 파트너센터의 상담 상태는 대기, 진행중, 보류, 상담완료로 나뉘어요. 메시지를 보내면 그 대화가 진행중으로 바뀌고 읽음 처리돼요. 고객 닉네임은 hsju****처럼 일부만 보여요.
  • 고객 화면: 전환은 고객에게도 보여요. 고객의 톡톡 대화방에 “상담원이 대화를 이어받았습니다.”가 찍히고, AI로 돌아가면 “AI 상담으로 전환되었습니다.”가 찍혀요. 여러 번 오가면 그 기록이 모두 고객 화면에 남아요.
파트너센터 답장이 도착했다는 알림은 늦을 수 있어요. 자세한 내용은 네이버 공식 외부 상담 연동 안내에 있어요.

​
응대권 API 사용하기

이 API는 네이버 쪽 응대권을 제어해요.
  • 전환 요청: Idempotency-Key 헤더가 필요해요. API 도구로 상담사에게 넘길 때는 X-Vox-Chat-Turn-Id 헤더에 현재 입력 ID도 넣으세요.
  • AI 복구: target=ai는 대시보드에 로그인한 인증으로만 요청할 수 있어요. 워크스페이스 API 키로는 요청할 수 없어요.
  • 상태 조회: 끝난 대화는 상태만 조회할 수 있어요. 상태를 조회해도 네이버에 새 전환을 요청하지 않아요.

​
설정 바꾸기와 연결 해제

활성 연동은 중지를 누른 뒤 고치세요. 중지하면 새 AI 처리와 준비 중인 발신을 막아요. 이미 시작한 네이버 요청은 취소하지 못해요.
  • 토큰: 바꿀 때만 토큰 교체에 넣으세요. 저장한 토큰은 다시 조회할 수 없어요.
  • 다시 확인: 토큰이나 파트너 ID를 바꾸면 연동을 다시 확인해야 해요.
  • 에이전트와 버전: 바꾸면 새 대화부터 적용돼요.
연동 해제는 저장한 토큰을 지우고, 해제한 연동은 다시 활성화할 수 없어요. 다시 연결하려면 새 연동을 만들어 확인하고, 네이버 파트너센터의 웹훅 URL은 따로 지우세요.
해제해도 대화 이력은 기존 보존 정책을 따라요.

​
보존 정책과 이미지

대화 콘텐츠에는 에이전트의 보존 정책이 적용돼요. 본문을 정리할 때 연결된 수신 원본도 함께 정리하고, 중복 방지용 식별 정보와 발신 결과는 남겨요. 이 정책으로 네이버 파트너센터 기록이 지워지지는 않아요. 진행 중인 마지막 답변이나 발신은 정리가 미뤄질 수 있어요. 첨부 정보 삭제와 파일 저장소의 실제 삭제는 별개라서, 즉시 삭제를 파일의 즉시 물리 삭제로 해석하지 마세요. AI가 응대하는 중에 최신 고객 이미지를 가져오지 못하면 대신 안내를 보내요. 새 문의나 상담사 전환이 있으면 이전 안내는 보내지 않아요.

​
문제가 생겼을 때

파트너센터 연동 관리에서 챗봇 API 사용 신청을 마치고 승인을 기다리세요. 승인된 뒤에 두 값이 나타나요.
파트너센터에 등록한 이벤트 받을 주소가 vox.ai의 웹훅 URL과 한 글자까지 같은지, 받을 이벤트에 send가 들어 있는지 확인하세요. 스마트스토어의 톡톡 쇼핑챗봇이나 AI FAQ가 켜져 있으면 챗봇 API로 메시지가 오가지 않으니 스마트스토어 센터에서 끈 뒤 다시 확인하세요.
파트너센터 챗봇 API 설정에서 핸드오버 API와 echo 이벤트를 켜세요. 둘이 꺼져 있으면 답장의 출처 정보가 오지 않아 이력에 남지 않아요. 켜기 전에 오간 답장은 나중에 채워지지 않아요.
파트너센터의 대화와 실제 응대 상태를 먼저 확인하세요. 네이버가 요청을 받았는지 확정할 수 없는 상태라, 실패로 단정하거나 같은 내용을 다시 보내지 마세요. 같은 요청 키로 다시 조회해도 자동으로 다시 보내지 않아요. AI 복구도 실제 응대 상태를 확인한 뒤 요청하고, 전환 요청이 처리 중이면 추가 전환을 기다리세요.

​
관련 문서