코딩 지식 없이 AI로 텔레그램 봇 만들기: 프롬프트 작성부터 24시간 가동까지

코딩을 한 줄도 짤 줄 모르는데, 내가 필요한 텔레그램 봇(공지 알림 봇, 사내 챗봇, 키워드 모니터링 등)이 필요한 순간이 있어요.

유튜브나 블로그를 검색해 보면 "BotFather에서 토큰을 받으세요"까지는 따라가겠는데, 갑자기 "터미널을 열고 파이썬 가상환경을 만들고 requirements를 설치하라"는 외계어가 쏟아지며 막막해지죠.

ChatGPT에게 "텔레그램 봇 만들어줘"라고 물어봐도 마찬가지예요. 시커먼 코드 블록을 던져주는데, 이걸 어디에 저장해야 하는지, 어떻게 켜야 하는지, 노트북을 덮으면 왜 봇이 죽어버리는지 아무도 친절하게 알려주지 않거든요.

코딩 지식이 전혀 없어도 괜찮아요.

내 컴퓨터에 파이썬이나 복잡한 개발 도구를 하나도 깔지 않고, AI에게 코드를 시키고 ➔ 파일 두 개를 받아서 ➔ 클라우드에 올려 24시간 꺼지지 않게 돌리는 전체 과정을 가장 쉬운 순서대로 정리했어요.

1. 봇의 신분증과 열쇠: BotFather에서 3분 만에 토큰 받기

텔레그램에서 봇을 만드는 건 전 세계에서 가장 쉬운 편에 속해요. 텔레그램 안에 봇들을 낳아주는 '아버지 봇(@BotFather)'이 있거든요.

1. 텔레그램 검색창에 @BotFather를 검색하고 공식 인증 마크(파란 체크)가 붙은 대화방을 열어요.
2. /newbot 명령어를 전송합니다.
3. 봇의 이름(화면에 보일 별명)을 한글이나 영어로 입력해요. (예: 우리팀 공지 알림이)
4. 봇의 고유 아이디(유저네임)를 입력해요. 단, 끝이 반드시 bot으로 끝나야 합니다. (예: my_team_notice_bot)
5. 잠시 후 BotFather가 축하 메시지와 함께 다음과 같은 긴 암호 문자열을 건네줍니다.

7123456789:AAFlM_ExampleTokenStringHere...

이 문자열이 바로 **API 토큰(비밀 열쇠)**이에요. 이 열쇠만 있으면 봇에게 메시지를 보내거나 답장을 시킬 수 있습니다. 다른 사람에게 노출되면 내 봇의 권한을 마음대로 쓸 수 있으니 메모장에 조용히 복사해 두세요.

2. AI에게 코드 부탁하기: 그대로 복붙하는 프롬프트

이제 봇의 두뇌가 될 코드를 AI(ChatGPT, Claude, Cursor 등)에게 작성해 달라고 부탁할 차례예요.

여기서 가장 중요한 요령이 있어요. 그냥 "텔레그램 봇 코드 짜줘"라고만 말하면, AI는 내 컴퓨터에서 잠깐 테스트만 하고 끝나는 불완전한 코드를 던져주기 십상이거든요.

AI에게 아래 프롬프트를 그대로 복사해서 붙여넣어 보세요.

[복사해서 쓸 프롬프트]
텔레그램 봇 코드를 Python으로 작성해 줘.
 
1. 기능:
- 사용자가 '/start'를 치면 환영 인사와 도움말을 안내해 줘.
- 사용자가 메시지를 보내면 그 메시지를 친절하게 따라 말해 줘(에코 봇).
 
2. 기술 필수 조건:
- python-telegram-bot 최신 v21 라이브러리를 사용할 것.
- 외부 웹 포트(Flask/FastAPI)는 절대 사용하지 말고 순수 롱폴링 루프(`run_polling`)로 작성할 것.
- 토큰은 코드에 하드코딩하지 말고 반드시 환경변수 os.getenv("TELEGRAM_BOT_TOKEN")에서 읽어올 것.
- 필요한 라이브러리 목록을 requirements.txt 내용으로 따로 적어줄 것.

이렇게 조건을 딱 정해주면, AI가 군더더기 없이 24시간 클라우드 배포에 딱 맞는 안전한 코드를 뽑아줍니다.

3. 내 컴퓨터에 파이썬 안 깔아도 돼요: 파일 딱 두 개 만들기

AI가 코드를 만들어주면, 내 컴퓨터 바탕화면에 새 폴더를 하나 만들고(예: my-bot), 그 안에 파일 두 개만 저장하면 준비가 끝나요.

my-bot/
├── main.py
└── requirements.txt

1) main.py 파일 만들기

메모장(윈도우)이나 텍스트 편집기(맥)를 열고, AI가 작성해 준 파이썬 코드를 그대로 붙여넣은 뒤 파일 이름을 main.py로 저장해요. 코드는 대략 이런 형태일 거예요.

import os
import sys
from telegram import Update
from telegram.ext import ApplicationBuilder, CommandHandler, MessageHandler, filters, ContextTypes
 
TOKEN = os.getenv("TELEGRAM_BOT_TOKEN")
if not TOKEN:
    print("에러: TELEGRAM_BOT_TOKEN 환경변수가 없습니다.", file=sys.stderr)
    sys.exit(1)
 
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("안녕하세요! 24시간 살아있는 텔레그램 봇이에요.")
 
async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text(f"보내주신 말: {update.message.text}")
 
if __name__ == '__main__':
    app = ApplicationBuilder().token(TOKEN).build()
    app.add_handler(CommandHandler('start', start))
    app.add_handler(MessageHandler(filters.TEXT & (~filters.COMMAND), echo))
    app.run_polling()

2) requirements.txt 파일 만들기

새 메모장을 열고, AI가 알려준 라이브러리 이름을 적어준 뒤 requirements.txt라는 이름으로 저장해요.

python-telegram-bot==21.10

복잡한 개발 프로그램을 설치하거나 검은 터미널 창을 열 필요가 전혀 없어요. 텍스트 파일 두 개가 폴더에 담겼다면 준비는 100% 끝났습니다.

4. 클릭 3번으로 클라우드에 올리기 (터미널 없이 24시간 가동)

이제 이 폴더를 클라우드에 올려서 내 노트북을 꺼도 24시간 돌아가게 만들 거예요.

1. **DashCloud 콘솔**에 접속해 GitHub 또는 Discord 계정으로 로그인해요.
2. 새 프로젝트 생성 화면에서 방금 만든 my-bot 폴더를 화면에 마우스로 끌어다 놓습니다(Drag & Drop). (또는 폴더를 ZIP으로 압축해서 올려도 돼요.)
3. 환경변수 설정창에서:
   • 이름: TELEGRAM_BOT_TOKEN
   • 값: BotFather에게 받은 비밀 토큰
   • (선택) TZ: Asia/Seoul (한국 시간대 설정)
4. 배포 버튼을 누릅니다.

배포 버튼을 누르면 서버가 requirements.txt를 읽고 알아서 파이썬 환경을 구성한 뒤, main.py를 백그라운드 프로세스로 띄워줍니다.

잠시 후 콘솔 탭에 초기화 로그가 뜨면 배포 완료예요. 이제 텔레그램 메신저로 들어가서 내 봇에게 /start를 보내보세요. 답장이 번개처럼 날아올 거예요.

이제 노트북 전원을 완전히 끄든 화면을 덮든, 봇은 클라우드 데이터센터에서 24시간 내내 쉬지 않고 돌아갑니다.

5. 처음 만들 때 가장 많이 부딪히는 함정 3가지

비개발자가 처음 봇을 만들 때 당황하기 쉬운 대표적인 실수 세 가지를 짚어드릴게요.

1) 단체 채팅방에 초대했는데 말을 안 들어요

봇을 1:1 대화방이 아니라 단체 그룹방에 초대했을 때 아무 반응이 없는 경우가 있어요.

텔레그램 봇은 기본적으로 사생활 보호를 위해 그룹방의 일반 대화를 읽지 못하는 **'프라이버시 모드'**가 켜져 있거든요.

BotFather 대화방으로 가서 /setprivacy ➔ 내 봇 선택 ➔ Disable을 눌러주면 그룹방의 모든 대화를 읽고 반응할 수 있게 바뀝니다.

2) 토큰을 넣었는데 인증 에러가 나요

대시보드 환경변수에 토큰을 복사해 넣을 때, 앞뒤에 빈칸(스페이스바)이나 따옴표("...")가 실수로 딸려 들어가는 경우가 많아요. 토큰 값 앞뒤에 불필요한 공백이 없는지 확인해 보세요.

3) 15분 지나면 봇이 잠드는 무료 호스팅의 함정

인터넷에서 Render나 Koyeb 같은 해외 무료 호스팅 글을 보고 올렸다가, "15분 뒤에 봇이 자꾸 멈춰요"라고 호소하는 분들이 정말 많아요.

웹사이트용 무료 호스팅은 15분 동안 방문자가 없으면 서버를 강제로 잠재워버리거든요. 텔레그램 봇처럼 24시간 끊김 없이 신호를 주고받아야 하는 봇은 절전 모드가 없는 상시 가동 환경(DashCloud Free 샌드박스 등)에 올려야 자고 일어나도 꺼지지 않습니다.

6. 자주 묻는 질문

봇에 새로운 기능을 추가하고 싶을 때는 어떻게 하나요?
ChatGPT나 Claude에게 "지금 main.py 코드에 네이버 뉴스 검색 기능도 추가해줘"라고 부탁하세요. AI가 코드를 고쳐주면 내 컴퓨터의 main.py 파일을 새 코드로 덮어쓴 뒤, DashCloud 대시보드에서 폴더를 다시 올리고 재배포 버튼만 누르면 3초 만에 업데이트가 끝납니다.

정말 무료로 계속 켜둘 수 있나요?
DashCloud Free 샌드박스는 오픈베타 기간 동안 신용카드 등록 없이 완전 무료로 제공돼요. 256MB 메모리와 1GB 디스크를 제공하므로 텍스트 기반 텔레그램 봇을 24시간 켜두기에 충분히 넉넉합니다.

배포 절차는 빠른 시작 가이드에서 확인할 수 있어요.

DashCloud는 오픈베타 기간 동안 신용카드 등록 없이 무료로 제공돼요. GitHub 또는 Discord 계정 로그인 후 휴대폰 인증 1회를 마치면 지금 바로 무료 샌드박스를 띄울 수 있어요.