AI로 텔레그램 봇 만들기
코딩 몰라도 완성하는 완전 가이드
BotFather 설정 → AI 코드 생성 → Replit 실행까지, 비개발자도 하루 안에 끝낸다
📋 이 글에서 알 수 있는 것
- 텔레그램 봇이 무엇인지, 어떤 상황에서 유용한지
- BotFather로 봇 토큰을 발급받는 방법 (공식 절차)
- Claude 또는 ChatGPT로 Python 봇 코드를 생성하는 법
- Replit에서 코드를 실행해 봇을 작동시키는 법
- 실전 예제: 키워드 입력 시 자동 답변하는 Q&A 봇 완성
텔레그램 봇이란? 이걸 왜 만드나
텔레그램(Telegram)은 전 세계적으로 수억 명이 사용하는 메신저 앱입니다. 그런데 텔레그램에는 일반 채팅 외에 봇(Bot)이라는 기능이 있습니다. 봇은 사람 대신 자동으로 메시지에 응답하거나, 정보를 전달하거나, 명령을 수행하는 자동화 계정입니다.
예를 들어 이런 봇을 만들 수 있습니다.
🤖 이런 봇을 직접 만들 수 있어요
- Q&A 봇: "배송 문의", "환불 방법" 같은 키워드에 자동으로 답변
- 알림 봇: 특정 시간에 공지사항이나 일정을 자동 발송
- 번역 봇: 메시지를 받으면 자동으로 번역해서 답변
- 메모 봇: 텔레그램에 메시지를 보내면 구글 시트에 자동 저장
과거에는 봇을 만들려면 Python이나 JavaScript를 직접 짤 줄 알아야 했습니다. 하지만 이제는 Claude나 ChatGPT에게 "텔레그램 봇 코드 만들어줘"라고 요청하고, 그 코드를 Replit이라는 클라우드 환경에 붙여 넣으면 됩니다. 이 글에서는 그 과정 전체를 단계별로 안내합니다.
준비물 및 소요 시간
| 텔레그램 계정 | 스마트폰에 앱 설치 (무료) |
| AI 툴 | Claude 또는 ChatGPT (무료 플랜 가능) |
| 실행 환경 | Replit (무료 플랜으로 시작 가능) |
| 소요 시간 | 처음이라면 약 1~2시간 |
| 필요 코딩 실력 | 없어도 됨 |
STEP 1 — BotFather로 봇 만들고 토큰 발급받기
텔레그램 봇을 만들려면 가장 먼저 BotFather에게 봇 생성을 요청해야 합니다. BotFather는 텔레그램이 공식으로 운영하는 봇 관리 계정입니다. 마치 봇들의 아버지처럼, 새 봇을 만들고 토큰을 발급하는 역할을 합니다.
토큰(Token)은 내 봇의 신분증 같은 고유 코드입니다. 코드가 텔레그램 서버에 이 토큰을 제시해야 봇이 동작합니다. 절대 타인에게 공유하지 마세요.
텔레그램에서 BotFather 검색
텔레그램 앱을 열고 검색창에 @BotFather를 입력합니다. 파란 체크 마크(✓)가 있는 공식 계정을 선택합니다.
/newbot 명령어 입력
BotFather 채팅창에 /newbot을 입력하고 전송합니다. 봇 생성 프로세스가 시작됩니다.
봇 이름과 사용자명 입력
먼저 봇의 이름(표시 이름, 예: My Helper Bot)을 입력합니다. 이어서 사용자명(username)을 입력하는데, 반드시 bot으로 끝나야 합니다. 예: myhelper_bot
토큰 복사 및 보관
BotFather가 1234567890:ABCdef... 형식의 토큰을 보내줍니다. 이 토큰을 복사해서 메모장에 저장해 두세요. 다음 단계에서 꼭 필요합니다.
발급받은 토큰은 절대 GitHub 공개 저장소나 SNS에 올리지 마세요. 토큰이 유출되면 누구든 내 봇을 제어할 수 있습니다. 토큰이 유출됐다면 BotFather에서
/revoke 명령어로 즉시 재발급 받으세요.
STEP 2 — AI로 봇 코드 생성하기
토큰을 받았다면 이제 봇의 두뇌에 해당하는 코드가 필요합니다. 직접 짤 필요는 없습니다. Claude나 ChatGPT에게 정확하게 요청하면 됩니다.
프롬프트 예시 (그대로 복붙하세요)
텔레그램 봇 Python 코드를 만들어줘. 요구사항: - python-telegram-bot 라이브러리 사용 - 사용자가 "안녕"이라고 보내면 "안녕하세요! 무엇을 도와드릴까요?"라고 답변 - 사용자가 "도움말"이라고 보내면 사용 가능한 명령어 목록을 답변 - /start 명령어를 처음 입력하면 환영 메시지 표시 - 봇 토큰은 TOKEN 변수로 처리 (코드에 직접 넣지 말 것) - Replit에서 실행 가능하도록 requirements.txt도 같이 만들어줘
AI가 코드를 생성해주면 두 가지 파일을 받게 됩니다: 실제 코드가 담긴 main.py와 필요한 라이브러리 목록인 requirements.txt입니다. 아래는 AI가 생성하는 코드의 예시입니다.
# python-telegram-bot 라이브러리를 사용하는 텔레그램 봇 import os from telegram import Update from telegram.ext import ( ApplicationBuilder, CommandHandler, MessageHandler, filters, ContextTypes ) # 토큰은 환경 변수로 관리 (보안) TOKEN = os.environ.get('TELEGRAM_TOKEN') async def start(update: Update, context: ContextTypes.DEFAULT_TYPE): await update.message.reply_text( "👋 안녕하세요! VibeLab 봇입니다.\n'도움말'을 입력해 보세요." ) async def handle_message(update: Update, context: ContextTypes.DEFAULT_TYPE): text = update.message.text if "안녕" in text: await update.message.reply_text("안녕하세요! 무엇을 도와드릴까요? 😊") elif text == "도움말": await update.message.reply_text( "📋 사용 가능한 명령어\n- 안녕 → 인사\n- 도움말 → 이 목록" ) else: await update.message.reply_text("죄송해요, 아직 그 말은 모르겠어요.") if __name__ == '__main__': app = ApplicationBuilder().token(TOKEN).build() app.add_handler(CommandHandler('start', start)) app.add_handler(MessageHandler(filters.TEXT, handle_message)) app.run_polling()
텔레그램 공식 Bot API를 Python에서 쉽게 사용할 수 있도록 만들어진 오픈소스 라이브러리입니다. 전 세계 개발자들이 사용하는 검증된 도구로, 설치 한 줄로 복잡한 API 통신을 자동 처리해줍니다.
바이브코딩 완전 입문 가이드도 함께 읽어보세요.
STEP 3 — Replit에서 봇 실행하기
코드가 준비됐다면 이제 실행 환경이 필요합니다. 로컬 PC에 Python을 설치해도 되지만, 가장 쉬운 방법은 Replit을 사용하는 것입니다. Replit은 브라우저에서 바로 코드를 실행할 수 있는 클라우드 개발 환경입니다. 설치가 필요 없고, 무료 플랜으로 시작할 수 있습니다.
Replit 가입 및 새 Repl 만들기
replit.com에 접속해 무료로 가입합니다. 대시보드에서 + Create Repl 버튼을 클릭하고 언어로 Python을 선택합니다.
코드 파일 붙여넣기
AI가 생성한 main.py 코드를 Replit의 코드 편집창에 붙여 넣습니다. 좌측 파일 트리에서 + New file로 requirements.txt도 만들어 내용을 붙여 넣습니다.
토큰을 환경 변수(Secrets)에 저장
왼쪽 메뉴에서 🔒 Secrets(자물쇠 아이콘)를 클릭합니다. Key에 TELEGRAM_TOKEN, Value에 앞서 BotFather에서 받은 토큰을 입력하고 저장합니다. 코드에 토큰을 직접 넣지 않아 보안상 안전합니다.
▶ Run 버튼으로 봇 실행
상단의 초록색 Run 버튼을 클릭합니다. 콘솔 창에 오류 없이 실행 메시지가 뜨면 성공입니다. 이제 텔레그램에서 내 봇을 검색해 말을 걸어보세요!
Replit 무료 플랜에서는 Repl이 일정 시간 사용하지 않으면 자동으로 슬립(sleep) 상태가 됩니다. 봇을 24시간 켜두려면 유료 플랜이 필요하거나, UptimeRobot 같은 외부 핑(ping) 서비스를 연동해야 합니다. 처음 테스트하는 단계에서는 무료 플랜으로 충분합니다.
실전 예제: 자동 답변 Q&A 봇 완성하기
기본 봇이 작동했다면 이제 실제로 쓸 수 있는 Q&A 봇으로 발전시켜봅니다. 소규모 쇼핑몰, 스터디 모임, 개인 채널 등에서 자주 받는 질문에 자동으로 답변하는 봇입니다.
AI에게 기능 추가를 요청하는 법
이미 만든 코드를 AI에게 보여주고 기능을 추가해달라고 하면 됩니다.
아래 코드에 Q&A 기능을 추가해줘. 추가할 내용: - "배송"이라는 단어가 포함되면 → "배송은 주문 후 2~3일 소요됩니다." - "환불"이라는 단어가 포함되면 → "환불은 수령 후 7일 이내 가능합니다." - "운영시간"이라는 단어가 포함되면 → "평일 9시~18시 운영합니다." - 어느 키워드에도 해당 없으면 → "담당자에게 연결해드릴게요. 잠시만 기다려주세요." [아래에 기존 코드 붙여넣기]
이런 방식으로 키워드와 답변 쌍을 계속 추가할 수 있습니다. 내용이 많아지면 AI에게 "딕셔너리(dictionary) 방식으로 리팩터링해줘"라고 요청하면 관리하기 더 쉬운 구조로 바꿔줍니다.
🚀 봇 기능 확장 아이디어
- 키워드 자동 응답: 자주 받는 질문 20개를 AI에게 정리해달라고 해서 한 번에 등록
- 이미지 전송: 특정 키워드 입력 시 메뉴판이나 지도 이미지를 자동 전송
- 그룹 채팅 관리: 욕설이나 스팸 링크가 올라오면 자동 삭제
- OpenAI 연동: ChatGPT API를 연결해서 어떤 질문에도 AI가 답변하는 봇
추천 대상별 봇 유형
배송·환불·재고 문의가 반복된다면
→ 키워드 자동 답변 봇으로 CS 시간을 절반 이상 줄일 수 있습니다
모임 공지나 일정 안내를 매번 직접 보내고 있다면
→ 정해진 시간에 알림을 발송하는 스케줄 봇이 유용합니다
아이디어 메모, 지출 기록, 할 일 저장을 한 곳에서 하고 싶다면
→ 텔레그램 봇 + 구글 시트를 연동한 개인 비서 봇이 딱 맞습니다
| 봇 유형 | 난이도 | 추가 비용 | 적합 대상 |
|---|---|---|---|
| 키워드 Q&A 봇 | ⭐ 쉬움 | 무료 | 쇼핑몰, 커뮤니티 |
| 스케줄 알림 봇 | ⭐⭐ 보통 | 무료 | 스터디, 팀 채널 |
| Google 시트 연동 봇 | ⭐⭐ 보통 | 무료 | 개인 자동화 |
| OpenAI API 연동 봇 | ⭐⭐⭐ 고급 | API 사용료 발생 | AI 상담 서비스 |
*2026년 4월 기준. OpenAI API 요금은 사용량에 따라 변동됩니다.
>Make로 AI 자동화 워크플로우 구축하기도 참고해보세요.
자주 묻는 질문
Python을 전혀 몰라도 괜찮을까요?
이 가이드의 핵심은 AI가 코드를 생성하고, 여러분은 그 코드를 복붙하는 것입니다. Python 문법을 몰라도 진행할 수 있습니다. 다만 오류가 발생했을 때 오류 메시지를 AI에게 그대로 보여주고 "이 오류를 고쳐줘"라고 하면 대부분 해결됩니다.
봇을 24시간 켜두려면 어떻게 해야 하나요?
Replit 무료 플랜은 일정 시간 비활성 상태가 되면 봇이 꺼집니다. 24시간 유지하려면 Replit 유료 플랜을 구독하거나, UptimeRobot(무료 서비스)으로 주기적으로 봇에 핑을 보내 슬립을 방지하는 방법을 사용할 수 있습니다. 또는 Railway, Fly.io 같은 다른 클라우드 플랫폼으로 이전하는 방법도 있습니다.
봇이 답변하지 않을 때 어떻게 확인하나요?
Replit 콘솔 창에서 오류 메시지를 확인하세요. 가장 흔한 원인은 ①토큰이 잘못 입력된 경우, ②Secrets에 토큰 이름(TELEGRAM_TOKEN)이 코드와 다른 경우, ③라이브러리가 설치되지 않은 경우입니다. 오류 메시지를 AI에게 그대로 붙여넣으면 원인과 해결책을 알려줍니다.
텔레그램 봇 이용에 비용이 드나요?
텔레그램 Bot API 자체는 무료입니다. Replit 무료 플랜도 사용할 수 있습니다. 단, OpenAI API를 연동해서 ChatGPT가 답변하게 하거나, Replit 유료 플랜을 사용하면 비용이 발생합니다. 처음 테스트하는 단계에서는 완전 무료로 시작 가능합니다.
봇을 여러 그룹에 동시에 추가할 수 있나요?
네, 가능합니다. 하나의 봇을 여러 텔레그램 그룹에 관리자로 추가할 수 있습니다. 단, 그룹마다 다른 동작이 필요하다면 봇을 따로 만들거나, 코드에서 그룹 ID를 구분하는 로직을 추가해야 합니다. 이 부분도 AI에게 요청하면 코드를 만들어줍니다.
텔레그램 봇은 한 번 만들어두면 반복 업무를 계속 자동화해주는 자산입니다.
코딩을 몰라도 AI가 코드를 만들고, Replit이 실행 환경을 제공합니다.
오늘 BotFather에 접속해서 첫 봇을 만들어보세요.
VibeLab이었습니다.