🚀 영어 학습 AI Agent 만들기 & 무료 배포 완벽 가이드 (1) 텔레그램 봇 생성

📌 목차

1. 프로젝트 개요
2. 텔레그램 봇 생성
3. 방법 1: GitHub Actions로 배포
4. 방법 2: Render로 배포

 

🎯 1. 프로젝트 개요

만들 봇의 기능

• ✅ 특정 시간마다 영어 표현 자동 전송
• ✅ 표현, 의미, 영어 예문, 한국어 예문 제공
• ✅ 24개의 다양한 영어 표현 순환
• ✅ 명령어로 제어 가능 (/start, /stop, /now)
• ✅ 무료로 24/7 운영

배포 방법 비교

특징	GitHub Actions	Render
비용	완전 무료	유료 (1분/ $0.00016)
실행 방식	24/7 서버 상시 실행	24/7 서버 상시 실행
설정 난이도	⭐⭐⭐	⭐⭐
상호작용	❌ (일방향)	✅ (명령어 사용 가능)
서버 관리	불필요	자동 관리
추천 대상	단순 알림봇	인터랙티브 봇

 

📱 2. 텔레그램 봇 생성

두 방법 모두 동일한 과정으로 시작합니다.

1단계: BotFather로 봇 생성

   1) 텔레그램 앱 열기

   2) BotFather 찾기

• 검색창에 @BotFather 입력
• 파란색 체크마크가 있는 공식 계정 선택

    3) 봇 생성 명령어 실행

• START 버튼 누르기

채팅창에 /newbot 입력하고 Send 버튼을 누르거나 채팅장 위에 pop up되는 /newbot create a new bot 을 눌러요

 

• /newbot 입력 

 

   4)봇의 이름 정하기 

• 봇의 이름은 텔레그램에서 사용자가 봇을 검색할 때 사용되는 이름입니다. 
  저는 Telegram_Language_Bot이라는 이름을 사용하도록 할게요. 
• 봇 이름: Telegram_Language_Bot 

 

   5) username 정하기 (Bot의 식별자)

• username은 bot의 식별자이기 때문에 유일해야 하고 마지막은 bot으로 끝나야 합니다. 
  Telegram_Language_Bot을 그대로 username으로 하고 싶었지만 해당 username은 invalid 하다고 하네요Language6767Bot 으로 username을 정하도록 하겠습니다. 
• 봇 username: Language6767Bot (반드시 'bot'으로 끝나야 함)

   

   6) API 토큰 저장⚠️ 중요: 이 토큰을 안전하게 저장하세요!

• Use this token to access the HTTP API: 뒤에 문자열을 저장해두세요!!!

 

2단계: Chat ID 확인 (GitHub Actions용)

GitHub Actions는 구독 기능이 없으므로 미리 Chat ID를 알아야 합니다.

   

   1)봇에게 메시지 보내기

• 생성한 봇을 찾아서 /start 입력

화살표가 가르키는 링크를 클릭하면 1단계에서 만든 봇으로 이동

   2) Chat ID 확인

• 브라우저에서 다음 URL 접속:
  1단계에서 저장했던 API 토큰은 아래 URL에 넣어주세요.

https://api.telegram.org/bot봇Token값/getUpdates

• 크게 3가지 경우가 나올 수 있습니다. 
  
  첫번째 : API 토큰이 정확하게 들어가지 않았을 경우 아래 에러 메시지가 나올 수 있습니다. 
  해결방법 : API 토큰을 정확하게 복사합니다. 
  

  {"ok":false,"error_code": 404, "description":"Not Found"}

  
  두번째 : Bot이 활성화 되지 않았을 경우 해결방법 : Bot에 메시지를 보냅니다. (e.g. Hi, Hello 아무 메시지나 괜찮습니다.)
  
  

  {"ok":true,"result":[]}

  
  
  세번째 : 정상동작 상태
  여기서 "id"에 해당하는 숫자가 Chat ID 입니다. 
  

  {"ok":true,"result":[{"update_id":104493075,
  "message":{"message_id":4,"from":{"id":994690178 ........

  
  
  • JSON 응답에서 {"id":123456789} 부분 찾기
  • 이 숫자가 Chat ID입니다

   3) 여러 사람에게 보내기 (실습에서는 생략)

• 각 사람이 봇에게 메시지를 보냄
• 위 URL에서 모든 Chat ID를 수집
• 쉼표로 구분하여 저장: 123456789,987654321,555555555