진행 단계: 본 특강은 Part 4 완료 후 진행됩니다. 사용 방법: 아래 안내된 프롬프트를 복사하여 Claude Code에 입력하면 텔레그램 알림 시스템 구축이 완료됩니다.

0. 사전 준비: 텔레그램 Bot 생성 및 정보 획득

이 단계는 Claude를 통하지 않고 수강생 본인이 직접 수행해야 하는 필수 설정입니다.

1. 텔레그램 앱 실행 후 검색창에 @BotFather 검색 및 대화 시작
2. 입력창에 /newbot 명령어 전송
3. 봇의 표시 이름(Name) 입력 (예: 내 주식 알림)
4. 봇의 사용자명(Username) 입력 (반드시 bot으로 끝나야 함. 예: hodu_stock_bot)
5. 발급된 HTTP API TOKEN 복사 및 별도 메모
6. 생성된 본인의 봇 검색 후 대화방에 들어가서 /start 전송 (필수)
7. 웹 브라우저 주소창에 아래 URL 입력 후 접속 (TOKEN 부분에 본인의 토큰 삽입)
   • https://api.telegram.org/bot{TOKEN}/getUpdates
8. 화면에 출력된 텍스트 중 "chat":{"id":숫자...} 부분의 숫자(Chat ID) 복사 및 별도 메모

1. 환경 설정 및 기본 코드 작성

프롬프트 1: 패키지 설치 및 환경 변수 설정

Plaintext

`프로젝트 루트 환경에 다음 패키지를 설치해 줘: pip install python-dotenv requests

설치 후 프로젝트 루트에 .env 파일을 생성하고 아래 구조를 만들어 줘. 값은 비워두거나 더미 텍스트를 넣어줘. TELEGRAM_BOT_TOKEN=여기에_BotFather에서_받은_토큰 TELEGRAM_CHAT_ID=여기에_채팅_ID`

프롬프트 2: 텔레그램 전송 모듈 구현

Plaintext

`notifier.py 파일을 생성하고 아래 명세에 따라 함수를 구현해 줘.

1. send_telegram(text) 함수:

• python-dotenv의 load_dotenv를 사용하여 .env에서 TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID 로드
• requests.post를 사용해 텔레그램 sendMessage API 호출 (URL: https://api.telegram.org/bot{TOKEN}/sendMessage)
• parse_mode는 "Markdown"으로 설정
• Markdown 파싱 에러(HTTP 400) 발생 시, 특수문자 충돌을 방지하기 위해 parse_mode 없이 plain text로 재전송하는 예외 처리 추가
• 토큰이나 채팅 ID 누락 시 에러를 발생시키지 않고 경고 로그만 출력
• 성공 시 True, 실패 시 False 반환

2. _send_long_telegram(msg) 함수:

• 입력된 메시지가 4000자 이하인 경우 send_telegram으로 즉시 전송
• 4000자 초과인 경우:
  • 줄바꿈(\n) 단위로 텍스트 분할
  • 각 청크(chunk)가 4000자를 넘지 않도록 누적
  • 4000자 한계 도달 직전에 새로운 청크로 분리
  • 각 청크를 순차적으로 send_telegram을 통해 전송
  • 텔레그램 API Rate Limit 방지를 위해 청크 전송 사이에 0.5초 대기 시간(delay) 추가
• 총 전송된 청크의 개수를 반환

3. 테스트 코드:

• if name == "main": 블록에 send_telegram("🧪 테스트 메시지입니다!") 추가`