카카오 챗봇 관리자센터 연동 가이드

채널별 1회 설정으로 메시지 자동 수집

전체 흐름

고객이 카카오채널로 메시지 전송 챗봇이 폴백 블록으로 수신 스킬 서버(이 대시보드)로 전달 대시보드에 자동 저장

고객에게 "접수되었습니다" 자동 응답 관리자가 카카오톡 채널 관리자센터에서 직접 답변

핵심: 챗봇은 메시지를 "전달"만 해줍니다. 실제 답변은 기존처럼 카카오톡 채널 관리자센터에서 1:1 채팅으로 직접 합니다.

사전 준비 확인

- 카카오톡 채널이 이미 개설되어 있어야 합니다 (center-pf.kakao.com)
- 채널 관리자 권한이 있는 카카오 계정이 필요합니다
- 아래 절차를 채널 수만큼 반복합니다 (5~7개). 채널당 약 10분 소요.

챗봇 관리자센터에서 봇 만들기

1. chatbot.kakao.com 접속 후 카카오 계정으로 로그인
2. 우측 상단 "+ 봇 만들기" 클릭
3. "카카오톡 챗봇" 선택
4. 봇 이름 입력 (예: "메인스토어 수집봇") → "확인"

"카카오 i 오픈빌더"가 아니라 "챗봇 관리자센터"입니다. 같은 사이트이지만 정식 명칭이 바뀌었습니다.

카카오톡 채널 연결

1. 생성한 봇 클릭하여 들어감
2. 좌측 메뉴 "설정" → "카카오톡 채널" 탭
3. "카카오톡 채널 연결" 버튼 클릭
4. 연결할 카카오톡 채널 선택 (예: 메인스토어)

채널의 관리자 권한이 있는 카카오 계정으로 로그인해야 채널이 목록에 보입니다.

스킬(Skill) 등록

1. 좌측 메뉴에서 "스킬" 클릭
2. "생성" 버튼 클릭
3. 스킬 이름 입력: "메시지 수집" (원하는 이름으로 자유롭게 지정)
4. URL 입력란에 아래 주소를 그대로 붙여넣기:

https://kakao-channel-hub.pages.dev/api/webhook/kakao/{채널번호}

{채널번호}에 실제 숫자를 넣으세요. 대시보드 "웹훅 설정" 메뉴에서 각 채널의 URL을 바로 복사할 수 있습니다.
예: 메인스토어(1번) = https://kakao-channel-hub.pages.dev/api/webhook/kakao/1

주의: URL 뒤에 ?secret=xxx 등 추가 파라미터를 붙이지 마세요. 카카오 챗봇 관리자센터의 스킬 URL에는 순수 URL만 입력해야 합니다. 시크릿 키 검증이 필요하면 대시보드 웹훅 설정에서 별도로 관리합니다.

5. 하단 "저장" 클릭

폴백 블록에 스킬 연결 (핵심!)

폴백 블록 = 등록된 시나리오에 매칭되지 않는 모든 사용자 메시지를 처리하는 블록.
다른 블록을 추가하지 않은 상태에서는 고객이 보내는 모든 메시지가 폴백 블록으로 들어옵니다.

폴백 블록 진입

1. 좌측 메뉴 "시나리오" 클릭
2. "기본 시나리오" 펼치면 보이는 "폴백 블록" 클릭

파라미터 설정 (화면 상단 영역)

폴백 블록 화면의 상단에 "파라미터 설정" 영역이 있습니다.
오른쪽 위에 "스킬선택" 드롭다운이 보입니다.

3. "파라미터 설정" 영역 상단 오른쪽의 "스킬선택" 드롭다운 클릭
4. Step 3에서 만든 "메시지 수집" 스킬 선택

봇 응답 설정 (화면 하단 영역)

파라미터 설정 아래에 "봇 응답" 영역이 있습니다.
기본으로 텍스트 응답이 들어있는데, 이것을 스킬데이터 응답으로 바꿔야 합니다.

5. 봇 응답 영역 하단의 "+봇응답 추가 (1/2)" 아래에 응답 타입 아이콘이 나열됩니다:
텍스트 | 이미지 | 카드 | 커머스 | 리스트 | 스킬데이터
6. 마지막에 있는 "스킬데이터" (</> 아이콘) 클릭
7. 기존 텍스트 응답 블록은 삭제합니다 (응답 블록 우측 아이콘)
8. 스킬 서버가 반환하는 version 2.0 JSON 응답이 자동으로 고객에게 전달됩니다
9. 우측 상단 "저장" 클릭

요약: 파라미터 설정에서 스킬 선택 → 봇 응답에서 스킬데이터 추가 → 기존 텍스트 응답 삭제 → 저장

참고: 스킬데이터를 봇 응답으로 선택하면, 우리 서버가 반환하는 자동 응답 메시지(예: "메시지가 접수되었습니다")가 고객에게 즉시 전송됩니다. 이 문구는 대시보드 웹훅 설정에서 채널별로 변경 가능합니다.

대시보드에서 웹훅 활성화

1. 이 대시보드 좌측 메뉴 → "웹훅 설정" 클릭
2. 해당 채널 행 클릭 → 설정 펼침
3. "활성화"를 "활성"으로 변경
4. 자동 응답 메시지 확인 (원하면 수정)
5. "저장" 클릭
6. "테스트" 버튼으로 연결 확인 (대시보드에 테스트 메시지가 뜨면 성공)

챗봇 배포

1. chatbot.kakao.com 으로 돌아감
2. 상단 "배포" 버튼 클릭
3. "배포" 확인
4. 배포 후, 본인 카카오톡에서 해당 채널로 테스트 메시지 전송
5. 대시보드에서 메시지가 자동 수신되는지 확인!

완료! 이제 이 채널로 들어오는 모든 고객 메시지가 대시보드에 자동으로 쌓입니다. 답변은 카카오톡 채널 관리자센터에서 기존처럼 하면 됩니다.

나머지 채널도 동일하게 반복

위 1~6단계를 나머지 카카오톡 채널에 대해 반복합니다. 스킬 URL만 채널번호에 맞게 변경하면 됩니다.

채널 1 (메인스토어): https://kakao-channel-hub.pages.dev/api/webhook/kakao/1

채널 2 (고객센터): https://kakao-channel-hub.pages.dev/api/webhook/kakao/2

채널 3 (예약문의): https://kakao-channel-hub.pages.dev/api/webhook/kakao/3

... 이런 식으로 채널별 번호만 다릅니다.

자주 묻는 질문

Q. 챗봇 연결하면 기존 1:1 채팅이 안 되나요?

아닙니다. 챗봇이 자동 응답("접수되었습니다")만 보내고, 관리자가 카카오톡 채널 관리자센터(center-pf.kakao.com)에서 기존처럼 직접 1:1 답변할 수 있습니다.

Q. 고객이 자동응답 받으면 어색하지 않나요?

"확인 중입니다" 같은 간단한 안내 메시지입니다. 이미 많은 업체에서 사용하는 패턴이라 자연스럽습니다. 자동 응답 문구는 대시보드 웹훅 설정에서 채널별로 커스텀 가능합니다.

Q. 5초 타임아웃이 있다던데?

카카오 챗봇 스킬 서버는 5초 내 응답이 필수입니다. 이 대시보드는 메시지 저장 + 자동 응답만 하므로 0.1초 이내에 응답합니다. 걱정 없습니다.

Q. 비용이 드나요?

카카오 챗봇 관리자센터는 무료입니다. 챗봇 생성, 스킬 서버 연동 모두 무료입니다.

Q. 카카오에서 고객 닉네임은 안 보이나요?

카카오 챗봇 스킬 서버에는 botUserKey(고유 식별값)만 전달됩니다. 닉네임은 제공되지 않습니다. 대시보드에서는 "카카오_xxxxxxxx" 형태로 표시되며, 같은 사용자는 항상 같은 키를 가집니다.