네이버 톡톡

네이버 톡톡으로 들어온 고객 문의를 제로톡 대화 메뉴에서 확인하고 답장할 수 있어요. 네이버에서 발급한 인증 키는 답장을 보내는 데 쓰고, 제로톡에서 발급한 Webhook URL은 고객 메시지를 제로톡으로 전달받는 주소예요.

시작하기 전에

• 제로톡 워크스페이스의 소유자 또는 관리자로 진행하세요.
• 네이버 톡톡 파트너센터에서 관리할 톡톡 계정과 챗봇 API 설정을 사용할 수 있어야 해요. 새 계정은 네이버의 검수를 거쳐 사용 가능한 상태가 되어야 해요. 신청 상태는 파트너센터에서 확인하세요.
• 기존 서비스가 같은 톡톡 계정의 메시지를 받고 있다면 Webhook URL을 바꾸기 전에 응대 전환 시점을 정하세요.

파트너센터에서 연동할 계정의 관리 화면을 열고 챗봇 API 설정을 찾아요. 네이버 공식 가이드는 개발자도구 > 챗봇API 설정 경로를 안내해요. 화면 구성에 따라 메뉴 위치는 다를 수 있어요. 네이버 공식 설정 안내를 함께 참고하세요.

준비할 값	확인 방법
인증 키	챗봇 API 설정의 보내기 API > Authorization 값을 복사해요. 비밀번호처럼 보관하고 공개 문서나 대화에 붙여넣지 마세요.
외부 진입 ID	고객이 여는 톡톡 주소에서 파트너 ID를 확인해요. 주소가 https://talk.naver.com/내ID라면 내ID 부분만 입력해요. 인증 키와는 다른 값이에요.

보내기 API의 Authorization을 복사하고, 연동한 뒤 위쪽 Webhook에 제로톡 주소를 등록해요.

연동 방법

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

메뉴 위치는 연동 설정 페이지 들어가기를 참고하세요.

네이버 톡톡 연동하기 열기

연동 추가를 누르고 네이버 톡톡 > 연동하기를 선택해요.

인증 키와 외부 진입 ID 입력하기

준비한 인증 키와 외부 진입 ID를 모두 입력하고 연동하기를 눌러요. 외부 진입 ID는 웹사이트 위젯의 다른 방법으로 문의에서 네이버 톡톡을 여는 데 사용해요.

Webhook URL 복사하기

연동 직후 열리는 완료 화면에서 Webhook URL > 복사를 눌러요. 화면을 이미 닫았다면 연동 설정 목록의 네이버 톡톡을 열어 상세 화면에서 다시 복사할 수 있어요.

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

파트너센터의 챗봇 API 설정 > Webhook > 이벤트 받을 URL에 복사한 주소를 붙여넣고 등록해요. Event에서 다음 다섯 가지를 모두 선택해요.

이벤트	제로톡으로 전달하는 내용
send	고객이 보낸 메시지예요.
open	고객이 톡톡 대화창에 들어온 이벤트예요.
leave	고객이 대화창을 떠난 이벤트예요.
echo	파트너센터 등에서 고객에게 보낸 메시지예요.
profile	고객이 개인정보 제공에 동의한 결과예요. 연동 상세의 고객 정보 받기를 켰을 때 연락처·닉네임이 이 이벤트로 들어와요.

연동 확인하기

고객용 톡톡 주소를 고객 계정으로 열고 테스트 메시지를 보내요. 제로톡 대화 메뉴에서 해당 메시지를 확인한 뒤 답장하고, 톡톡 대화창에도 답장이 도착하는지 확인해요.

📌‘연동됨’ 표시만으로 설정 확인이 끝나지는 않아요

제로톡은 등록할 때 인증 키의 형식을 검사해요. 실제 메시지를 받을 수 있는지와 답장이 가능한지는 위 테스트로 확인하세요.

고객 정보 받기

고객이 동의하면 네이버 톡톡에서 연락처와 닉네임을 받아 제로톡 고객 정보에 채워요. 상담원이 번호를 따로 묻지 않아도 돼요.

켜기

연동 설정 목록에서 네이버 톡톡을 열고 고객 정보 받기 카드에서 설정을 확인해요. 요청 버튼은 처음부터 켜져 있고, 자동 요청은 꺼져 있어요.

설정	켜면
닉네임·연락처 제공 동의 요청 사용	고객 정보의 휴대폰 칸에 요청 버튼이 생겨 상담원이 직접 동의를 요청할 수 있어요. 받은 값이 고객 정보에 채워져요. 쓰지 않으려면 꺼요.
상담이 시작되면 자동으로 요청	버튼을 누르지 않아도 아래 조건에 맞는 고객에게 동의 화면을 보내요. 위 설정을 켜야 켤 수 있어요.

닉네임·연락처 제공 동의 요청 사용을 끄면 자동 요청과 요청 버튼이 모두 멈춰요. 이미 받은 값은 그대로 남아요.

⚠️파트너센터에서 profile 이벤트를 켜야 해요

동의 결과는 profile 이벤트로만 전달돼요. 파트너센터 Event에서 profile을 선택하지 않으면 고객이 동의해도 값이 들어오지 않아요.

고객이 동의 화면을 1분 안에 확인하지 않으면 네이버가 요청을 닫아요. 자동 요청을 켜 뒀다면 보낸 뒤 1시간 동안은 다시 나가지 않으니, 바로 다시 받아야 하면 상담원이 직접 요청하세요.

고객이 보는 화면

고객의 네이버 톡톡 대화방에는 아래처럼 확인·취소 버튼이 달린 동의 화면이 와요. 확인을 누르면 동의, 취소를 누르면 거부예요. 다만 네이버에 휴대폰 번호를 등록하지 않은 고객은 확인을 눌러도 네이버가 거부로 알려 와요.

동의 화면의 문구와 버튼은 네이버가 정해요. 제로톡이나 상담원이 바꿀 수 없어요.

고객이 동의하지 않으면

동의는 고객의 선택이에요. 고객이 취소를 누르거나 답하지 않아도 상담은 그대로 이어져요. 메시지를 주고받는 데 제한이 없고, 연락처와 닉네임이 고객 정보에 채워지지 않는 것만 달라요.

고객이	그러면
취소를 누름 (거부)	상담은 계속돼요. 대화에 거부했다는 시스템 메시지가 남고, 거부한 날로부터 30일 동안 자동 요청도 직접 요청도 나가지 않아요. 번호가 필요하면 상담원이 대화에서 직접 물어보세요.
네이버에 휴대폰 번호가 없는 채로 확인을 누름	네이버가 거부로 알려 와서 취소와 똑같이 처리돼요. 상담은 계속되고 30일 동안 다시 요청하지 않아요.
1분 안에 답하지 않음	네이버가 요청을 닫고 상담은 계속돼요. 거부로 남지 않으므로, 바로 다시 받아야 하면 화면을 새로 고친 뒤 상담원이 직접 요청하세요.

동의 화면이 떠 있는 동안(최대 1분)에는 상담원 답장이나 AI 답변이 잠시 늦게 나갈 수 있어요. 네이버가 그동안 메시지를 받지 않기 때문이에요. 이때 보낸 메시지는 1분쯤 뒤에 자동으로 다시 보내져요.

자동으로 요청하는 때

상담이 시작되면 자동으로 요청을 켜 두면 고객이 메시지를 보낼 때마다 아래 조건을 확인하고, 모두 맞을 때만 동의 화면을 보내요.

조건	내용
받은 번호가 없음	아직 번호를 받지 않았거나, 받은 지 1년이 지났을 때만 요청해요.
상담이 시작됨	워크플로우가 응대 중인 동안에는 요청하지 않아요. 상담으로 넘어간 뒤 고객이 보낸 메시지부터 요청해요.
철회하지 않음	제공 동의를 철회한 고객에게는 자동으로 다시 요청하지 않아요.
답을 기다리는 요청 없음	요청을 보낸 뒤 1시간 동안은 다시 보내지 않아요.
최근에 거부하지 않음	동의 화면에서 거부한 고객에게는 30일 동안 다시 요청하지 않아요.

부재중 설정으로 메시지를 받지 않는 시간에는 요청하지 않아요.

상담원이 직접 요청하기

고객 정보의 휴대폰 칸이 비어 있으면 그 자리에 요청 버튼이 보여요. 누르면 지금 대화 중인 고객에게 동의 화면이 가요. 고객 정보를 수정할 수 있는 상담원에게만 보여요.

버튼 표시	뜻
응답 대기	요청을 보냈고 고객의 답을 기다리는 중이에요.
요청 거부	고객이 제공을 거부했어요. 거부한 날로부터 30일이 지나면 다시 요청할 수 있어요.

직접 요청은 철회 이력·워크플로우 응대 중·1시간 대기와 상관없이 보낼 수 있어요. 상담원이 상황을 보고 다시 묻는 경로이기 때문이에요.

요청을 보내면 버튼이 응답 대기로 바뀌고, 같은 화면에서는 다시 누를 수 없어요. 네이버에서 1분이 지나 요청이 닫혔다면 화면을 새로 고친 뒤 다시 요청하세요.

받은 값 확인하기

고객이 동의하면 받은 번호가 고객의 휴대폰 칸에 저장되고, 고객 이름이 네이버 톡톡 닉네임으로 바뀌어요. 받은 닉네임과 번호는 아래 톡톡 닉네임·톡톡 연락처 칸에도 따로 표시돼요.

휴대폰 칸에 번호가 들어가므로, 같은 번호를 가진 고객이 이미 있으면 중복 가능성 있는 연락처에 떠서 한 고객으로 합칠 수 있어요. 휴대폰 칸에 번호가 이미 있던 고객은 그 번호를 그대로 두고, 받은 번호는 톡톡 연락처 칸에만 표시돼요. 합치는 방법은 아래 중복 고객 합치기를 참고하세요.

대화에는 요청과 동의 결과가 시스템 메시지로 남아요.

상담원이 이름이나 번호를 직접 고치면 그 값이 먼저 표시돼요.

중복 고객 합치기

같은 전화번호나 이메일을 쓰는 다른 고객이 있으면 대화 오른쪽 고객 정보와 고객 상세의 중복 가능성 있는 연락처에 후보로 떠요. 후보마다 같은 전화·같은 이메일 중 무엇이 겹치는지 표시돼요.

1. 합칠 후보의 병합을 눌러요.
2. 확인 창에서 유지할 연락처와 흡수될 연락처를 확인해요. 반대로 하려면 유지할 연락처 바꾸기를 눌러요.
3. 병합하기를 눌러요. 흡수되는 연락처의 대화와 태그는 유지되는 연락처로 옮겨지고, 이름·번호 같은 정보는 유지되는 연락처의 빈 칸만 채워요.

⚠️병합은 되돌릴 수 없어요

한 번 합친 연락처는 다시 나눌 수 없어요. 확인 창에서 두 연락처의 이름·번호·최근 접속을 비교한 뒤 합치세요.

합친 뒤 남는 정보와 후보에서 빼는 방법은 고객 관리의 중복 고객 합치기에서 확인하세요.

다른 사람이라면 다른 사람을 눌러 그 후보를 목록에서 숨겨요.

알아두기

항목	내용
답장 형식	텍스트와 이미지(JPEG·PNG·GIF, 20MB 이하)를 보낼 수 있어요. 동영상·음성·파일 발송은 지원하지 않아요. 텍스트와 이미지를 함께 보내면 두 메시지로 나뉘어요.
먼저 보내기	제로톡에 들어온 톡톡 대화에서 답장해요. 연락처만 아는 신규 고객에게 톡톡 대화를 먼저 만드는 기능은 없어요.
인증 키 변경	파트너센터에서 키를 재설정했다면 제로톡에도 새 키를 입력해야 해요. 같은 연동의 인증 키만 바꾸면 Webhook URL을 다시 등록할 필요는 없어요.
파트너센터 답장	echo를 켜 두면 파트너센터에서 직접 보낸 답장도 제로톡 대화에 표시돼요.
본문 링크	본문에 넣은 링크는 텍스트 (URL) 형태로 풀려서 나가요. 본문에 링크를 넣으면 작성창에 이 안내가 표시되니, 링크를 버튼으로 보내려면 링크 버튼을 쓰세요.
나간 고객	고객이 톡톡 대화방을 나가면 대화가 종료되고 채팅방을 나갔습니다 시스템 메시지가 남아요. 그 고객이 다시 메시지를 보내면 지난 대화를 다시 열지 않고 새 대화로 시작해요. 상담원이나 AI가 종료한 대화는 고객이 다시 메시지를 보내면 그 대화로 이어져요.
워크플로우 버튼 이름	네이버 톡톡은 버튼 이름 길이를 제한해요. 응답 버튼은 10자, 링크·파일 버튼은 18자까지예요. 응답 버튼 모양을 카드 버튼으로 고른 워크플로우는 응답 버튼도 18자예요. 네이버 톡톡에서 실행되는 워크플로우에 이보다 긴 버튼 이름이 있으면 발행이 막히고, 어느 버튼이 몇 자 넘었는지 표시돼요.

문제 해결

증상	확인할 내용
연동 추가가 보이지 않아요.	현재 워크스페이스의 소유자 또는 관리자 권한인지 확인하세요.
고객 메시지가 들어오지 않아요.	이벤트 받을 URL이 이 연동에서 복사한 주소인지, 파트너센터 Event에서 send · open · leave · echo · profile이 모두 선택됐는지 확인하세요.
고객이 동의했는데 고객 정보에 연락처가 들어오지 않아요.	파트너센터 Event에 profile이 선택됐는지 확인하세요. 동의 결과는 이 이벤트로만 전달돼요.
수신은 되는데 답장이 실패해요.	연동 상세에 인증 실패 안내가 보이거나 파트너센터에서 인증 키를 재설정했다면, 인증 키 재입력을 눌러 현재 Authorization 값을 넣고 다시 테스트하세요.
위젯에서 엉뚱한 톡톡이 열려요.	연동 상세의 외부 진입 ID를 고객용 톡톡 주소와 대조해 수정하세요. Webhook URL과 인증 키를 넣는 칸이 아니에요.
이미 연결된 톡톡 계정 안내가 나와요.	입력한 외부 진입 ID(톡톡 계정 ID)를 다른 네이버 톡톡 연동이 이미 쓰고 있어요. 같은 워크스페이스든 다른 워크스페이스든, 연결이 끊긴 연동이든 마찬가지예요. 그 연동을 삭제한 뒤 다시 시도하세요. 메시지는 연동마다 받는 Webhook URL로 들어오므로, 한 계정에 연동을 둘 두면 한쪽은 메시지를 받지 못해요.
워크플로우를 발행할 때 버튼 이름이 한도를 넘었다고 나와요.	표시된 버튼의 이름을 줄이세요. 응답 버튼은 10자, 링크·파일 버튼은 18자까지예요.

연동 해제

연동 설정에서 연동 해제를 누르고 확인 창에서 해제를 선택하면 이 연동의 설정과 키가 삭제돼요. 네이버에서도 더 이상 사용하지 않을 제로톡 Webhook URL을 정리하세요. 다시 연결할 때는 새 연동에서 발급한 URL을 파트너센터에 등록해야 해요.

자주 묻는 질문

Q. 인증 키를 잘못 넣어도 연동됨으로 보일 수 있나요? 네. 형식 검사에 통과해도 실제 키가 유효하지 않으면 답장이 실패할 수 있어요. 고객 메시지 수신과 제로톡 답장까지 모두 테스트하세요.

Q. 파트너센터에서 직접 답장하면 제로톡에도 보이나요? echo 이벤트가 켜져 있으면 제로톡 대화에도 표시돼요. 메시지가 빠졌다면 이벤트 선택부터 확인하세요.