카톡 ai 챗봇 만들기 튜토리얼 대공개 ✔️

메신저봇R + n8n 을 이용한 카카오 AI챗봇 만들기

1. AI챗봇 통신 구조

2. 기본 준비 사항

1. 안드로이드 스마트폰

2. 카카오톡 부계정 (본인 인증 가능한)
• 별도의 휴대폰 번호가 개통이 필요. (Tip. 알뜰폰 통신사 최소요금을 선택하면 매우 저렴)

3. 카카오톡 설치 및 설정
• 설치 링크 :
  KakaoTalk : Messenger - Apps on Google Play
• 부계정(카톡봇) 프로필명 설정
• 친구 탭 → 우상단 설정 버튼 → 전체 설정 → ‘알림’ 메뉴 클릭 → 메세지 알림 활성화
• 친구 탭 → 우상단 설정 버튼 → 전체 설정 → ‘알림’ 메뉴 클릭 → ‘알림표시’ 메뉴 클릭 → ‘알림 팝업’을 ‘사용 안함’ 변경
( 메신저봇R이 상단 노티바에서 알림을 읽는 것이기 때문에 팝업은 꺼두어도됨)
• 주계정 카카오톡에서 방금 부계정(카톡봇)과 친구 맺기
• 전화번호나, 카카오톡 ID 로 친구 추가

4. 메신저봇R 설치 및 설정
• 설치 링크 :
  MessengerBot - JS Chatbot - Apps on Google Play
• 메신저봇 실행 후, 상단 점세개 버튼 클릭 → 공용 설정 → 알림 읽기 권한 → (안드로이드 앱 설정으로 이동) → 알림 읽기 권한 체크

3. 메신저봇R 개발 환경 준비

1. VSCode 또는 CursorIDE를 추천

2. github 레포지토리에서 필요한 코드를 다운로드 해서 스크립트 파일로 저장

3. n8n 서버 웹훅 엔드포인트 및 헤더 APIkey를 자신에게 맞게 수정

4. 미러링 프로그램 scrcpy 설치
Mac 설치방법
• Homebrew(패키지 관리 프로그램) 설치: 터미널에 다음 명령어 입력

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• scrcpy 및 android-platform-tools 설치:

brew install scrcpy
brew install android-platform-tools`

# 또는 (Homebrew 버전에 따라 다릅니다)

brew install --cask android-platform-tools
• 터미널을 재시작하고 설치 여부 확인

scrcpy -v

 
Windows 설치 방법

• 공식 배포 사이트에서 scrcpy 다운로드 (다운로드 링크)
Windows용 zip 파일을 다운로드하고 압축 해제.





• C:\scrcpy 폴더로 압축해제된 파일 저장



 

• 고급시스템설정 → 환경변수 등록
다운로드 받은 scrcpy를 터미널 전역에서 사용할수 있도록 환경변수를 아래 절차대로 등록합니다.





C:\scrcpy



이후 모든 열린 창을 [확인] 버튼을 눌러 닫기





 

• 터미널을 열어 정상 설치 여부 확인

scrcpy -v

5. USB디버깅 와 무선디버깅 활성화
설정 → 휴대전화 정보

6. 안드로이드 폰을 PC에 USB로 연결
USB 연결 방법
• 안드로이드 폰을 집의 공유기에 와이파이로 연결합니다.
• USB로 내PC에 연결합니다. 연결하면 USB 디버깅 허용 여부를 물으면 허용 버튼을 누릅니다.



 
• 터미널(파워셀에서 아래 명령실행하면 미러링 창이 뜹니다.
• 디바이스 연결 확인

adb devices



 
• 미러링 시작
scrcpy

 
 

4. 메신저봇R 익히기 - Hello 메신저봇 만들기

• 메신저봇 앱 홈화면에서 (+) 버튼을 눌러 새 봇 이름을 ‘HelloBot’ 으로 입력하고, ‘레거시 API를 사용합니다’ 항목을 체크하고 [확인] 버튼을 누릅니다.

• 생성된 메신저봇을 활성화하고, 봇 제목을 탭하면 아이콘 메뉴가 나옵니다.

• ✏️ 버튼을 눌러 코드편집기를 실행합니다.
모두 지우고 아래 코드를 입력합니다.

function response(room, msg, sender, isGroupChat, replier, imageDB, packageName) {
  replier.reply("안녕하세요! " + sender + "님. 반갑습니다.");
  replier.reply("채팅방 : " + room);
  replier.reply("보내신 메세지 : " + msg);
  return;
}

• 상단의 📂 버튼을 누르고 [저장 및 컴파일] 버튼을 누릅니다. 반드시 컴파일이 되어야, 수정된 내용으로 동작합니다.

• 카카오톡 주계정으로 가서 부계정(카톡봇) 에 임의의 메시지를 보내고 응답을 확인합니다.

5. 사전 준비된 카톡봇 만들기

1. 공통사항
• 아래 링크를 눌러 주제별로 코드를 확인합니다.
카카오톡 봇 - Dante Labs n8n Workflows

https://dandacompany.github.io/n8n-workflows/workflows/kakaobot/index.html
• 신규 메신저봇을 생성하고 이름을 주제별로 정하고 코드를 복사 붙여넣습니다.
• n8n 워크플로를 신규 생성하고, 코드를 복사 붙여넣고 활성화합니다.
• n8n 서버의 엔드포인트를 확인하고, 메신저봇 코드의 엔드포인트를 수정합니다.
• n8n 서버에서 접속 인증 암호로 사용할 header Auth Key를 생성하고, 비밀키를 메신저봇 코드의 Header Auth Key를 수정합니다.
• LLM API 서비스 준비 (자료에서는 Openrouter.ai 사용, 대안은 OpenAI, Gemini 등)
• 아래 코드를 이용해서 도움말 메신저봇을 등록하고 활성화 합니다.
코드

function response(room, msg, sender, isGroupChat, replier, imageDB, packageName) {
    // "/help" 또는 "/도움말"로 시작하지 않으면 함수 종료
    if(!msg.startsWith("/help") && !msg.startsWith("/도움말")) {    
        return;
    }

    try {
        // 도움말 메시지 작성
        var helpMessage = "🤖 카카오봇 사용 가이드\n\n";
        helpMessage += "━━━━━━━━━━━━━━━━━━━━━━\n\n";
        
        helpMessage += "📝 AI 챗봇\n";
        helpMessage += "• /gem [질문]\n";
        helpMessage += "  → Gemini AI와 대화하기\n";
        helpMessage += "  예시: /gem 안녕하세요\n\n";
        
        helpMessage += "🎨 이미지 생성\n";
        helpMessage += "• /nano [이미지 URL] [설명]\n";
        helpMessage += "  → 나노바나나 이미지 생성\n";
        helpMessage += "  예시: /nano 귀여운 고양이\n\n";
        
        helpMessage += "🎬 동영상 생성\n";
        helpMessage += "• /sd [이미지 URL] [설명]\n";
        helpMessage += "  → Seedance 동영상 생성 (1-2분 소요)\n";
        helpMessage += "  예시: /sd 춤추는 로봇\n\n";
        
        helpMessage += "• /sora [이미지 URL] [설명]\n";
        helpMessage += "  → Sora 동영상 생성 (3-4분 소요)\n";
        helpMessage += "  예시: /sora 바다를 날아가는 새\n\n";
        
        helpMessage += "📺 유튜브 요약\n";
        helpMessage += "• 유튜브 링크 전송\n";
        helpMessage += "  → 자동으로 영상 내용 요약\n";
        
        helpMessage += "━━━━━━━━━━━━━━━━━━━━━━\n\n";
        helpMessage += "❓ 도움이 필요하시면\n";
        helpMessage += "/help 또는 /도움말 입력\n";
        
        // 도움말 메시지 전송
        replier.reply(helpMessage);
        
    } catch (e) {
        // 예외 발생 시 에러 메시지 전송
        var errorMsg = String(e);
        replier.reply("❌ 도움말 표시 실패: " + errorMsg);
        return;
    }
}

 

2. Gemini 웹검색 챗봇
• 필요한 API 서비스
• SerpApi (선택) : https://serpapi.com
• Perplexity (선택) : https://www.perplexity.ai/account/api/keys
• Gemini API (필수) : https://aistudio.google.com/api-keys
• DB 준비
• Postgresql을 준비하고 Connection 정보를 확인해서 연결해야합니다.
• 방법1(어려움): Docker 설치 (Raiway 같은 VPS 클라우드 서버 혹은 개인 서버에 배포)
• 방법2(쉬움): Supabase 무료 가입 -> https://supabase.com
 

3. 나노바나나 챗봇 (이미지 편집기)
• 필요한 API 서비스
• Kie.ai (필수) : 토큰 사전 충천 필요. 최소금액 $5 (대안으로 replicate.com 사용가능)
• Imgbb.com (필수) : 이미지 업로드 및 임시 퍼블릭 CDN 주소 발급 기능. 무료
• Google Drive API : https://console.cloud.google.com 에서 API 서비스 추가 → 접근 범위 추가 → API Key 발급
 

4. Sora2 챗봇 (음성포함 고급 동영상 생성) / SeeDance 챗봇 (빠른 동영상 생성)
• 필요한 API 서비스
• Kie.ai (필수) : 상동
• Google Drive API : 상동