KakaoTalk 연동

## 이 연동으로 되는 것 - 카카오톡에서 **AI 비서와 대화** — 질문하면 데이터를 조회해 답합니다 - 카카오톡 채널을 통한 알림 발송 가장 익숙한 메신저라 **경영진이 실제로 열어 보는** 채널이라는 장점이 있습니다. ## 사전 준비물 | 항목 | 어디서 | 비고 | |---|---|---| | 카카오 계정 | | | | **카카오톡 채널** (플러스친구) | business.kakao.com | 채널 생성 필요 | | **사업자등록증** | — | 비즈 채널 등록 시 | | 카카오 i 오픈빌더 봇 | i.kakao.com | | | 서비스 도메인 (HTTPS) | — | 스킬 URL 용 | ## 설정 절차 ### 1. 카카오톡 채널 만들기 [카카오 비즈니스](https://business.kakao.com) 에서 카카오톡 채널을 생성합니다. 비즈 채널로 등록하려면 사업자등록증이 필요합니다. ### 2. 오픈빌더에서 봇 만들기 [카카오 i 오픈빌더](https://i.kakao.com) 에 접속해 봇을 생성합니다. ### 3. 스킬 등록 1. 오픈빌더 → **스킬** → **생성** 2. 스킬명 입력 (예: `AI 비서`) 3. **URL** 에 아래를 입력 ``` https://<서비스 도메인>/webhook/kakao ``` > HTTPS 도메인이 필수입니다. 카카오 서버가 접근할 수 있는 공개 주소여야 합니다. ### 4. 시나리오 블록 설정 1. **시나리오** → **폴백 블록** 선택 (또는 새 블록 생성) 2. **파라미터 설정** → **스킬 연결** → 위에서 만든 스킬 선택 3. **봇 응답**에서 **스킬데이터 사용** 선택 > 폴백 블록에 연결하면 **정해진 명령어가 아닌 모든 질문**이 AI 비서로 전달됩니다. > 특정 명령만 처리하려면 별도 블록을 만들어 연결하세요. ### 5. 채널 연결 및 배포 1. **설정** → **채널 연결** → 만든 카카오톡 채널 선택 2. **배포** → 봇 배포 > **배포하지 않으면 실제 카카오톡에서 동작하지 않습니다.** 자주 빠뜨리는 단계입니다. ## 모닝인사이트에 입력 1. **설정 → 알림** 탭 2. **메신저 AI 비서 연동 → 카카오톡** 카드 클릭 3. **채널 ID** (플러스친구 ID) 입력 4. 표시된 **웹훅 URL** 이 오픈빌더 스킬 URL 과 같은지 확인 5. **저장** ## 확인 방법 1. 카카오톡에서 **채널을 친구 추가**합니다 2. 채널 대화창에 질문을 보냅니다 (예: "오늘 매출 얼마야?") 3. 답변이 오면 정상입니다 ## 응답이 느릴 때 — 정상 동작입니다 카카오톡은 응답 시간 제한이 있습니다. 데이터 조회에 시간이 걸리는 질문은 **먼저 "처리 중" 응답을 보내고 결과를 나중에 전달**합니다. 즉 복잡한 질문의 답이 몇 초 뒤에 따로 오는 것은 정상입니다. ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 봇이 응답하지 않는다 | **봇 배포를 안 함** | 오픈빌더에서 배포 | | 봇이 응답하지 않는다 | 스킬 URL 이 HTTPS 가 아님 | HTTPS 주소로 수정 | | 봇이 응답하지 않는다 | 폴백 블록에 스킬 미연결 | 시나리오 설정 확인 | | 정해진 답만 반복한다 | 다른 블록이 먼저 매칭됨 | 블록 우선순위 확인 | | 채널을 찾을 수 없다 | 채널 미공개 또는 미배포 | 채널 상태 확인 | | 알림톡이 안 간다 | 템플릿 미승인 | 승인된 템플릿만 발송 가능 | ## 알림톡 발송은 별도 승인이 필요합니다 카카오톡으로 **알림을 먼저 보내려면** 비즈 채널과 **사전 승인된 메시지 템플릿**이 필요합니다. - 자유 문구는 발송할 수 없습니다 - 템플릿 심사는 1~3일 걸립니다 - 운영자 등록 절차 → [Kakao 앱 등록 (운영자)](/news/guide/operator-kakao) 즉 **대화형 질의응답은 바로 되지만, 능동 알림 발송은 템플릿 승인이 선행**됩니다. 브리핑 알림을 빨리 받고 싶다면 [Telegram](/news/guide/telegram)이 훨씬 빠릅니다. ## 관련 문서 - [Kakao 앱 등록 (운영자)](/news/guide/operator-kakao) - [Telegram 연동](/news/guide/telegram) · [Slack 연동](/news/guide/slack) - [모닝 브리핑 받기](/news/guide/morning-briefing)