네이버 톡톡

네이버 톡톡과 연동하면 고객이 네이버 톡톡으로 보낸 문의를 제로톡 워크스페이스에서 함께 응대할 수 있습니다. 연동은 네이버 톡톡 인증 키를 입력하고, 제로톡이 발급한 Webhook URL 을 네이버 톡톡 파트너센터에 등록하는 방식으로 이루어집니다.

연동 방법

채팅 설정 > 연동 / 개발 > 연동 설정

연동 설정 페이지로 이동하는 방법은 위젯 설치 > 연동 설정 페이지 들어가기 를 참고하세요.

네이버 톡톡 연동하기 열기

연동 설정 페이지 우측 상단의 + 연동 추가 버튼을 눌러 서비스 연동 모달을 엽니다. 모달에서 네이버 톡톡 항목의 연동하기 버튼을 누르면 인증 키 입력 화면이 열립니다.

인증 키 입력하기

네이버 톡톡 파트너센터에서 발급받은 인증 키 를 입력하고 저장하면, 연동 관리 목록에 네이버 톡톡 항목이 추가됩니다.

✨인증 키는 파트너센터의 'Authorization' 값입니다

인증 키는 네이버 톡톡 파트너센터의 우측 상단 내 계정 → 계정 홈 바로가기 → 연동 관리 → 챗봇 API 설정 → 보내기 API 에 있는 Authorization 값입니다. 기존에 쓰던 값을 그대로 입력하면 되고, 바꾸려면 재설정 을 누른 뒤 새 값을 사용합니다. 이 값이 없으면 연동을 추가할 수 없습니다.

Webhook URL 복사하기

추가된 네이버 톡톡 항목에 표시된 Webhook URL 을 복사 버튼으로 복사합니다.



네이버 톡톡 연동 — 발급된 Webhook URL과 등록 안내

네이버 톡톡 파트너센터에 등록하기

네이버 톡톡 파트너센터의 우측 상단 내 계정 → 계정 홈 바로가기 → 연동 관리 → 챗봇 API 설정 에서, 복사한 Webhook URL 을 이벤트 받을 URL 칸에 붙여넣고 등록 을 누릅니다.



파트너센터 챗봇 API 설정 — 위 '이벤트 받을 URL'에 Webhook URL을 등록하고, 아래 '보내기 API'의 Authorization이 인증 키입니다

✨이벤트는 모두 선택하세요

Webhook 이벤트를 선택할 때 echo · leave · open · send 이벤트를 모두 선택해야 메시지가 정상적으로 연동됩니다.

연동 확인

파트너센터 등록이 완료되면, 이후 네이버 톡톡으로 들어온 문의가 제로톡 워크스페이스의 받은편지함에 함께 표시됩니다.

알아두기

항목	내용
지원 형식	텍스트와 이미지(JPEG·PNG·GIF, 20MB 이하)만 지원합니다. 동영상·음성·파일은 지원하지 않습니다. 텍스트와 이미지를 함께 보내면 두 건으로 나뉘어 전송됩니다.
버튼	퀵리플라이 버튼은 최대 10개, 각 버튼 제목은 10자를 넘으면 잘립니다. 링크(URL) 버튼이 있는 카드형은 버튼 제목이 18자를 넘으면 잘립니다.
먼저 보내기	이전에 우리 톡톡으로 문의한 적이 있는 고객에게만 이어서 보낼 수 있습니다(네이버 정책상 응답 기한이 있을 수 있습니다). 문의 이력이 없는 신규 고객에게 먼저 보내는 것은 불가합니다.
인증 키	연동 시점에는 형식만 확인하고 실제 유효성은 첫 발송 때 판명됩니다. 인증 키를 나중에 바꿔도 Webhook URL은 그대로이므로 파트너센터에 다시 등록할 필요는 없습니다.
파트너센터 답장	파트너센터 콘솔에서 직접 보낸 답장도 제로톡 대화에 발신 메시지로 동기화됩니다.

자주 묻는 질문

Q. 고객에게 먼저 톡톡 메시지를 보낼 수 있나요? 그 고객이 이전에 우리 톡톡으로 문의한 적이 있어야 합니다. 이미 열린 대화는 이어갈 수 있지만, 연락처만 아는 신규 고객에게 먼저 보내는 것은 불가합니다.

Q. 인증 키를 잘못 넣으면 어떻게 되나요? 연동 시점에는 형식만 검사합니다. 답장을 보낼 때 네이버가 인증 오류를 반환하면 그 메시지가 전송 실패로 표시됩니다. 연동 목록의 오류 알림을 확인하세요.

Q. 파트너센터에서 직접 답장하면 제로톡에 안 보이나요? 보입니다. 파트너센터 콘솔에서 보낸 답장은 제로톡 대화에 발신 메시지로 동기화됩니다. 단 Webhook 이벤트에서 echo 를 켜 두어야 합니다.