본문으로 건너뛰기

카톡봇 구현 계획입니다!

YKim

2025.09.10

카톡봇 구현 계획입니다! 본문 이미지

소개

이번 스터디에서는 카카오톡 메신저봇R과 FastAPI 서버를 연동하여, 카톡봇의 기본 구조를 이해하고 직접 구축해보았습니다.

처음 목표는 방별 기능 제어(AdminBot), 메인 대화 및 기능 실행(MainBot), 전체 대화 백업(BackupBot) 구조를 완성하는 것이었습니다.

이렇게 3봇 구조를 나눈 이유는 역할을 분리해서 관리성을 높이고, 이후 캐릭터봇이나 RAG 기능을 확장할 때 충돌을 최소화하기 위함입니다.

진행 방법

사용 도구

  • 메신저봇R: 카카오톡 메시지를 FastAPI 서버로 전달

  • FastAPI (Claude Code): 웹훅 수신 및 로직 라우팅

  • PostgreSQL: 방/사용자/메시지/설정 데이터를 저장

구현 흐름

  1. 메신저봇R에서 카톡 메시지를 FastAPI의 /webhook/kakao로 전달

  2. FastAPI 서버가 메시지를 PostgreSQL DB에 저장

  3. /admin 명령으로 방별 기능을 on/off (예: 대화, 검색)

  4. 메인봇은 캐릭터 대화/검색 실행, 백업봇은 모든 대화를 원문 백업

검은 색 화면에 한국 문자 메시지 스크린 샷

결과와 배운 점

  • 배운 점

    • 봇을 단일 구조로 두는 것보다 관리자/메인/백업으로 나누니 유지보수가 훨씬 수월했습니다.

    • PostgreSQL 스키마 설계를 초기에 잘 해두면 이후 캐릭터봇·RAG로 확장하려고 합니다.

    • message_id를 room_id + timestamp + user_id 조합으로 두면 중복 방지와 조회 효율을 동시에 잡을 수 있을 것 같습니다.

  • 시행착오

    • 초기에 DB에 한글 인코딩 문제(UTF-8 미설정)로 메시지가 깨지는 문제가 있었습니다.

    • 관리자봇의 권한 체크 로직을 두지 않으면, 모든 사람이 /admin 명령을 실행할 수 있어서 위험했습니다.

  • 앞으로의 계획

    • 2주차에는 캐릭터 말투/성격을 설정하는 캐릭터봇 기능을 추가하고,

    • 3주차에는 RAG 검색과 멀티턴 기억 기능을 붙일 예정입니다.


도움 받은 글

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

복받어김현우 프로필 이미지

YKim님, 구현 모두 하시면 이제 카톡봇 스터디 하나 열어서 저와 함께 입문반, 중급반 나눠서 해보시죠~

너무 구현을 잘 하셔서 제가 도와드릴 건 없을 거 같고, 특정 기능에 대해 의견 교환이 필요하시면 편하게 연락주세요!

좋은 구현 방식은 강의 형태로 함께 따라해보기 마련해 주시면 좋을 거 같아요!

이번에 함께 해주셔서 감사합니다!

Y
YKim2025.09.17

헉... 아니에요 현우님 덕분에 fastapi 라는 것도 알게되고 메신저봇도 알게되고 새로운거 많이 배우고 있어요...ㅠㅠ 스터디열그릇은안되는거 같아요...ㅠㅠ ㅎㅎ

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기