(1차) 재미있는 카카오톡 챗봇 개발 환경 구축기 (같이하면 쉽다)

소개

카카오톡 챗봇을 만들기 위해선 단순히 대화 스크립트를 짜는 것을 넘어서, 실제 동작 가능한 개발 환경을 구축하는 사전 준비 작업이 매우 중요합니다. 😅

이번에는 챗봇 개발의 본격적인 코딩 이전에 수행한 환경 준비 단계에 집중하여, 어떤 도구를 사용했고 어떤 문제를 만났으며, 이를 어떻게 해결했는지를 공유하고자 합니다.

진행 방법

✅ 사용한 도구 및 플랫폼

도구

용도

ChatGPT, Claude

챗봇 기획 및 대화 흐름 설계

Perplexity AI

에러 발생 시 검색 및 해결 힌트 찾기

Android Studio

안드로이드 에뮬레이터로 카카오톡 앱 테스트

DigitalOcean

챗봇 서버 구축 (Ubuntu 설치)

🛠️ 사전 준비 절차

휴대폰 및 카카오 계정 준비
- 실제 챗봇 테스트를 위해 카카오톡이 설치된 기기가 필요합니다.
- 카톡봇에 사용할 카카오 계정 준비도 중요합니다.
📷 관련 이미지: 테스트용 카카오 계정 설정 화면 (예: 캡처 이미지 삽입)
PC에 Android Studio 설치 및 에뮬레이터 실행
- 에뮬레이터를 통해 PC에서도 카카오톡 앱 동작 환경을 재현할 수 있어, 테스트가 훨씬 편해집니다.
- 사이트 : https://developer.android.com/studio?hl=ko
  https://developer.android.com/studio?hl=

안드로이드스튜디오 설치 > 메신저봇 설치

3. DigitalOcean 서버 세팅
- Ubuntu 22.04 Droplet을 생성하여 Node.js 기반 서버 설치
- 📷 관련 이미지:

맥북과 윈도우의 SSH키를 생성하는 방법이 다르다.

빌링을 해줘야 된다. 맨아래 조그만글자로 되어있어서 찾기가 어렵다.

프로젝트가 생성되면 아래 파란색줄에 있는 Droplet을 누르면 console이 나온다

터미널에 아래의 명령어를 하나씩 차례로 넣으면 된다.
간혹 에러가 나는경우는 퍼플렉시티와 차분히 대화를 하면 100%해결된다.
(스터디원 전원이 LLM을 이용해서 해결했었다)

sudo apt update && sudo apt upgrade -y
sudo apt install python3 python3-pip -y
sudo pip3 install virtualenv
mkdir fastapi-server
cd fastapi-server
virtualenv venv
source venv/bin/activate
echo "fastapi\nuvicorn\ngunicorn" > requirements.txt
pip install -r requirements.txt
uvicorn api:app --host 0.0.0.0 --port 8000

 다음처럼 나온다.
(venv) root@ubuntu-s-1vcpu-512mb-10gb-sgp1-01:~/fastapi-server# uvicorn api:app --host 0.0.0.0 --port 8000
INFO:     Started server process [39541]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)


http://서버_IP주소:8000 접속 시 "Hello from FastAPI!" 메시지가 보이면 성공입니다.
http://서버_IP주소:8000/docs 접속 시 자동 생성된 API 문서(Swagger UI)를 볼 수 있습니다.

서버주소는 디지털오션 console 또는 터미널첫화면에 나와있다.

/docs를 어드레스뒤에 넣으면 다음과 같이 나온다.

4. 문제 해결은 GPT + Perplexity + 스터디의 힘으로
- Android Studio 설치 중 발생한 JDK 호환성 문제
- 서버 접속 시 SSH 타임아웃 문제 등 다양한 에러가 발생
- 대부분 퍼플렉시티나 GPT에게 질문해 해결했지만,
- 특히 토요일 오프라인 스터디에서 스터디장님의 리드와 다른 분들의 실시간 피드백이 큰 도움이 되었습니다 🙌

결과와 배운 점

챗봇 설계도 중요하지만, 테스트 가능한 환경 구축이 더 큰 허들이었습니다.
에러가 날 때마다 "혼자 검색 → 실패 → 다시 질문" 루틴이 반복됐지만,
- 공동의 문제 해결 공간이 있을 때 속도와 학습 효율이 크게 향상됨을 체감했습니다.
"기획만 잘 하면 된다"는 생각은 오산! 기획-설치-테스트-서버배포 전 과정을 아우르는 시야가 필요합니다.

도움 받은 글 (옵션)

카카오 디벨로퍼 챗봇 가이드
DigitalOcean Node.js 서버 세팅 문서
GPT와 Perplexity의 요약 답변들 (SSH관련해서는 별도 캡처하지 못한 점은 아쉽네요 😅)

🧡 한마디 조언: 혼자서 하려 하지 말고, 질문하고 공유하고 함께 해결합시다! 커뮤니티와 동료의 힘이 최고의 디버깅 툴입니다.

22기 바이브코딩 스터디 대기자 등록이 시작됐어요 💫