Telegram 봇 + ChatGPT API 자동화 5단계 — 1시간 만에 챗봇 만드는 법 (2026년)

본인만의 ChatGPT 챗봇 갖고 싶으셨죠?

저도 그랬어요. 본업 일하면서 자주 쓰는 질문 패턴(코드 디버깅·번역·요약)이 있는데 매번 ChatGPT 웹사이트 열기 귀찮고, 모바일에서도 바로 쓰고 싶었거든요. 그래서 Telegram + ChatGPT API 봇을 한 시간 정도 들여 만들어두고 나서는, 모바일에서 바로 질문을 던지는 용도로 잘 쓰고 있어요.

오늘은 Telegram 봇 + ChatGPT API 자동화 5단계예요. 결론부터 말씀드리면 Python 50줄 + 무료 Cloudflare Workers + 종량제 API 비용으로 본인만의 24시간 AI 비서 완성이에요.

1단계: 텔레그램 봇 토큰 발급 (5분)

먼저 텔레그램 앱에서 봇 등록해요. PC·모바일 둘 다 가능해요.

BotFather로 봇 생성:

1. 텔레그램 검색창에 '@BotFather' 입력
2. BotFather와 대화 시작 (Start 버튼)
3. /newbot 명령어 입력
4. 봇 이름 입력 (사용자에게 보이는 이름, 예: "내 AI 비서")
5. 봇 사용자명 입력 (반드시 'bot'으로 끝나야 함, 예: 'my_ai_assistant_bot')
6. 토큰 발급 완료 (123456789:ABCdef... 형태)

발급받은 토큰을 메모장에 임시 저장하세요. 코드에서 환경변수로 사용할 거예요.

선택 설정 (BotFather 명령어):

• /setdescription: 봇 설명 (사용자가 봇 프로필에서 봄)
• /setabouttext: 봇 소개 짧은 글
• /setuserpic: 봇 프로필 사진
• /setcommands: 봇 명령어 메뉴 (/help, /reset 등)

이 단계는 5분이면 끝나요. 토큰 분실 시 BotFather에서 /token 명령어로 재발급 가능해요.

2단계: OpenAI API 키 발급 + 결제 등록 (10분)

ChatGPT API 사용하려면 OpenAI 계정과 결제수단 등록이 필요해요.

API 키 발급 단계:

1. platform.openai.com 접속 → 가입 또는 로그인
2. 좌측 메뉴 'API keys' 클릭
3. 'Create new secret key' 버튼 → 키 이름 입력 (예: 'telegram-bot')
4. 발급된 키 복사 (sk-... 형태) — 재확인 불가
5. 좌측 'Billing' 메뉴 → 결제수단(신용카드) 등록
6. 'Add credits' → $5 또는 $10 충전

충전 금액 정하는 기준:

• 처음에는 최소 금액($5)으로 시작해서 실제 사용량을 보고 늘리는 게 안전해요
• 실제로 몇 회 대화가 가능한지는 선택한 모델 단가·프롬프트 길이·대화 기록 길이에 따라 크게 달라져요
• OpenAI 대시보드의 Usage 화면에서 일자별 소비량을 확인할 수 있으니 첫 주에 한 번은 꼭 열어보세요

개인 봇이면 $5로 시작해도 충분해요. 자동 충전(auto-recharge)은 비활성화하세요. 코드 버그로 무한 호출 시 청구액 폭탄 위험이 있거든요.

3단계: Python 봇 코드 작성 (15분)

핵심 코드는 50줄 이내예요. 파이썬 3.10+ 필요해요.

필수 라이브러리 설치:

pip install python-telegram-bot openai python-dotenv

기본 봇 코드 (bot.py):

import os
from openai import OpenAI
from telegram import Update
from telegram.ext import ApplicationBuilder, CommandHandler, MessageHandler, filters, ContextTypes
from dotenv import load_dotenv

load_dotenv()
TELEGRAM_TOKEN = os.getenv("TELEGRAM_TOKEN")
OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
# 사용할 모델 ID는 OpenAI 공식 모델 목록에서 확인 후 .env에 지정
OPENAI_MODEL = os.getenv("OPENAI_MODEL")

client = OpenAI(api_key=OPENAI_API_KEY)

# 사용자별 대화 기록 저장
conversations = dict()

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    user_id = update.effective_user.id
    conversations[user_id] = []
    await update.message.reply_text("안녕하세요. 무엇이든 물어보세요.")

async def reset(update: Update, context: ContextTypes.DEFAULT_TYPE):
    user_id = update.effective_user.id
    conversations[user_id] = []
    await update.message.reply_text("대화 기록이 초기화됐어요.")

async def chat(update: Update, context: ContextTypes.DEFAULT_TYPE):
    user_id = update.effective_user.id
    user_message = update.message.text

    history = conversations.get(user_id, [])
    history.append([{"role": "user", "content": user_message}][0])

    response = client.chat.completions.create(
        model=OPENAI_MODEL,
        messages=[{"role": "system", "content": "친절한 한국어 AI 비서로 답변하세요."}] + history,
        max_tokens=500
    )

    reply = response.choices[0].message.content
    history.append([{"role": "assistant", "content": reply}][0])
    conversations[user_id] = history[-10:]

    await update.message.reply_text(reply)

app = ApplicationBuilder().token(TELEGRAM_TOKEN).build()
app.add_handler(CommandHandler("start", start))
app.add_handler(CommandHandler("reset", reset))
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, chat))
app.run_polling()

환경변수 파일 (.env):

TELEGRAM_TOKEN=발급받은_텔레그램_토큰
OPENAI_API_KEY=sk-발급받은_OpenAI_키
OPENAI_MODEL=공식_문서에서_확인한_모델_ID

.gitignore에 .env 추가 (절대 잊지 말기):

.env
__pycache__/

코드 핵심 포인트:

• conversations 딕셔너리: 사용자별 대화 맥락 저장
• history[-10:]: 최근 10개 메시지만 유지 (토큰 절약)
• system 프롬프트: 봇 성격·역할 정의
• OPENAI_MODEL: 모델 ID를 코드에 박지 말고 환경변수로 빼두면 모델 개편 때 코드 수정 없이 교체 가능

n8n + Claude API 자동화 5단계와 비슷한 구조지만 Telegram + Python 직접 구현이라 학습 가치가 높아요.

4단계: 로컬 테스트 + 디버깅 (10분)

코드 작성 완료하면 본인 PC에서 테스트해요.

실행 방법:

python bot.py

콘솔에 'Application started' 메시지 뜨면 봇 실행 중이에요. 텔레그램에서 본인 봇 검색 → /start → 메시지 입력해보면 지정한 모델이 응답해요.

자주 발생하는 에러:

Error: Invalid token
→ TELEGRAM_TOKEN 오타 또는 .env 파일 위치 확인

openai.AuthenticationError
→ OPENAI_API_KEY 잘못됐거나 결제수단 미등록

RuntimeError: This event loop is already running
→ Jupyter Notebook에서 실행하지 말고 일반 터미널 사용

고급 기능 추가:

• 음성 메시지 처리 (Whisper API 통합)
• 이미지 생성 (OpenAI 이미지 생성 API 통합)
• 그룹 채팅 활성화 (BotFather에서 /setjoingroups 활성화)
• 인라인 모드 (다른 채팅방에서 @봇이름 사용)

자동화 도구 비교는 Make vs Zapier 2026 가격 비교도 참고해보세요.

5단계: Cloudflare Workers 무료 호스팅 (20분)

본인 PC 24시간 켜둘 수 없으니까 무료 호스팅으로 옮겨요.

Cloudflare Workers 사용 이유:

• 개인 봇 규모에는 넉넉한 무료 요청 한도 (정확한 수치는 공식 요금 페이지 확인)
• 콜드 스타트 부담이 거의 없음 (개인 봇은 체감상 즉시 응답)
• 글로벌 CDN 자동 (국내에서도 응답이 빠른 편)
• HTTPS·도메인 자동 (별도 설정 불필요)

배포 단계:

1. Cloudflare 계정 생성 (cloudflare.com 무료)
2. wrangler CLI 설치: npm install -g wrangler
3. 새 프로젝트: wrangler init my-telegram-bot
4. JavaScript/TypeScript 코드로 변환 (Python 직접 지원 안 됨)
5. 환경변수 등록: wrangler secret put TELEGRAM_TOKEN
6. 배포: wrangler deploy

Cloudflare Workers JavaScript 예시:

export default {
  async fetch(request, env) {
    const update = await request.json();
    const message = update.message?.text || "";
    const chatId = update.message?.chat?.id;

    const aiResponse = await fetch("https://api.openai.com/v1/chat/completions", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Authorization": "Bearer " + env.OPENAI_API_KEY
      },
      body: JSON.stringify({
        model: env.OPENAI_MODEL,
        messages: [{role: "user", content: message}]
      })
    });

    const data = await aiResponse.json();
    const reply = data.choices[0].message.content;

    await fetch("https://api.telegram.org/bot" + env.TELEGRAM_TOKEN + "/sendMessage", {
      method: "POST",
      headers: {"Content-Type": "application/json"},
      body: JSON.stringify({chat_id: chatId, text: reply})
    });

    return new Response("OK");
  }
};

배포 후 텔레그램 webhook 설정 (한 번만):

curl "https://api.telegram.org/bot<TOKEN>/setWebhook?url=https://my-telegram-bot.your-subdomain.workers.dev"

이렇게 하면 본인 PC 꺼도 24시간 봇이 작동해요. 개인이 혼자 쓰는 봇이라면 무료 한도만으로도 대부분 커버되는데, 요청 한도와 과금 기준은 Cloudflare Workers 공식 요금 페이지에서 확인하세요. AI 자동화 도구 종합 비교는 Zapier vs Make vs n8n 3way 비교도 참고하세요.

보너스: 실전 활용 7가지 시나리오

시나리오 1: 개인 일정 관리 봇

• "내일 오후 3시 회의 추가" → Google Calendar API 연동 → 자동 등록

시나리오 2: 외국어 번역 봇

• 한·영·일 자동 감지 + 번역
• system 프롬프트로 도메인 특화 (의료·법률·기술)

시나리오 3: 코드 디버깅 봇

• 에러 메시지 입력 → 원인 분석 + 해결 코드 제공
• 상위 모델 권장 (경량 모델과 코드 정확도 차이가 큼)

시나리오 4: 뉴스 요약 봇

• 매일 오전 8시 자동 실행 → 주요 뉴스 5개 요약 → 본인에게 발송

시나리오 5: 고객 응대 자동화 (1인 사업자)

• 자주 묻는 질문 자동 답변
• 결제·배송 문의 → 안내 + 사람 응대 전환

시나리오 6: 그룹 챗 모더레이터

• 욕설·스팸 자동 감지 + 삭제
• 환영 메시지 자동 발송

시나리오 7: 학습 도우미 (자녀용)

• 수학·영어 문제 사진 → 풀이 제공
• 학습 진도 자동 기록

이런 사람에게 잘 맞아요

• 매일 같은 질문 패턴(번역·요약·코드 디버깅)을 반복하는 사람. 웹사이트 열고 로그인하는 과정이 사라져요
• 모바일에서 AI를 자주 쓰는 사람. 텔레그램은 앱이 가볍고 알림 구조도 이미 익숙해요
• 프롬프트를 고정해서 쓰고 싶은 사람. system 프롬프트에 역할을 박아두면 매번 설명할 필요가 없어요
• 가족·팀원 몇 명과 같은 봇을 공유하고 싶은 사람. 링크 하나만 보내면 끝이에요

반대로 파일 업로드나 긴 문서 분석이 주 용도라면 웹 ChatGPT 쪽이 편해요. 봇은 짧은 대화에 최적화된 도구로 생각하는 게 맞아요.

만들기 전에 알아두면 좋은 주의점

비용은 대화 길이에 비례해요. 코드에서 history를 최근 몇 개로 자르는 이유가 이거예요. 대화 기록을 무제한으로 쌓으면 매 요청마다 이전 대화 전체가 다시 전송돼서 토큰이 빠르게 늘어나요.

봇 링크는 사실상 공개예요. 텔레그램 봇은 사용자명만 알면 누구나 대화를 시작할 수 있어요. 본인만 쓸 거라면 코드에 허용할 사용자 ID를 확인하는 조건을 넣으세요. 이 한 줄이 없으면 남이 본인 API 크레딧을 대신 쓰는 상황이 생겨요.

자동 충전은 켜지 마세요. 무한 루프 버그 하나로 청구액이 크게 튈 수 있어요. 사용량 알림을 걸어두는 편이 안전해요.

대화 기록은 메모리에만 남아요. 예제 코드의 conversations 딕셔너리는 프로세스가 재시작되면 사라져요. 기록을 유지하려면 SQLite나 KV 저장소로 옮겨야 해요.

처음 만들 때 자주 막히는 지점

• .env 파일 위치: 실행하는 디렉터리 기준으로 읽으니까 다른 폴더에서 실행하면 토큰을 못 찾아요
• 모델 ID 오타: 모델 목록은 수시로 바뀌니 공식 문서에서 현재 사용 가능한 ID를 확인하고 넣으세요
• 그룹 채팅에서 무응답: BotFather에서 그룹 권한(Group Privacy)을 꺼야 봇이 일반 메시지를 읽어요
• webhook과 polling 혼용: 둘을 동시에 켜면 충돌해요. 호스팅으로 옮겼다면 로컬 polling은 꺼두세요

막혔을 때는 에러 메시지를 그대로 검색해보세요. python-telegram-bot과 OpenAI 라이브러리 모두 사용자가 많아서 같은 문제를 먼저 겪은 사람의 기록이 쌓여 있어요. 그래도 안 풀리면 코드를 최소 동작만 남기고 줄인 다음 기능을 하나씩 다시 붙이는 방식이 가장 빨라요. 어느 줄에서 깨지는지 바로 드러나거든요.

마무리 — 지금 당장 할 수 있는 액션

1. 5분: BotFather에서 봇 토큰 발급
2. 10분: OpenAI API 키 발급 + $5 충전
3. 15분: Python 코드 복붙 + .env 설정
4. 10분: 로컬에서 봇 테스트 + 디버깅
5. 20분: Cloudflare Workers 무료 배포
6. 이번 주: 본인 자주 쓰는 명령어 추가 (/translate, /summarize 등)
7. 다음 주: 친구·가족과 봇 공유 (BotFather에서 /setdescription)

코딩 처음이면 1단계 BotFather + 2단계 OpenAI API 키 발급까지만 오늘 완료해보세요. 코드 작성은 ChatGPT한테 "이 글의 코드 단계별로 설명해줘" 물어보면 본인 페이스로 학습 가능해요. 1주일 안에 본인만의 AI 비서가 완성됩니다. 처음부터 기능을 다 넣으려 하지 말고, 질문에 답만 하는 최소 버전을 먼저 띄운 다음 필요한 기능을 하나씩 얹는 순서를 추천해요.