Telegram용 챗봇 제작 Skill

개발자 본인의 편집기에서 개발자의 BotFather 토큰을 사용해 작업하는 Telegram 봇 빌더입니다. 웹훅과의 충돌을 해결하도록 롱 폴링을 설정하고, 토큰은 환경 변수에 보관하며, 재시작 후에도 상태가 유지되도록 구성합니다.

KissMySkills.com | 설치: 이 파일을 프로젝트에 넣고 Claude Code, Cursor 또는 코드베이스를 읽을 수 있는 AI로 여세요. 또는 Claude, ChatGPT나 Gemini에 붙여넣고 프로젝트를 설명하세요. 그런 다음 시작하라고 요청하세요. 이 개발자와 함께 개발자의 편집기에서 Telegram 봇을 만드세요. 등록된 BotFather 토큰에서 실제 배포를 견디는 봇까지 구축합니다. "텔레그램 봇 만드는 방법"을 검색하면 거의 모든 결과가 "BotFather에게 메시지를 보내고, 토큰을 받은 뒤, 메시지를 다시 출력하세요"에서 끝납니다. 그것은 데모일 뿐 봇이 아닙니다. 폴링을 사용할지 웹훅을 실행할지, 토큰을 어디에 보관할지 설명하지 않으며, 메모리 내 딕셔너리로 상태를 대신하기 때문에 두 사용자가 동시에 메시지를 보내는 순간 조용히 망가집니다. 데모를 넘어 실제 선택지를 다룹니다. 롱 폴링과 웹훅의 차이, 스택에 맞는 라이브러리, 재시작 후에도 유지되는 채팅별 상태, 첫 100명의 사용자 이후에도 계속 작동하는 배포를 다룹니다. 1. Node.js/TypeScript(grammY, Telegraf)인지 Python(python-telegram-bot, aiogram)인지와 버전. 2. 실행 환경: 계속 실행되는 서버나 컨테이너인지, 0으로 확장되는 서버리스/엣지 함수인지. 3. 봇이 실제로 하는 일: 명령어, 인라인 키보드, 미디어 또는 상태가 있는 전체 대화 흐름인지. 4. 메시지가 데이터베이스, 다른 API 또는 LLM에 전달되어야 하는지. 1. BotFather 등록: 봇의 사용자 이름, 토큰, 개인정보 보호 모드를 설명합니다(그룹 채팅의 봇은 개인정보 보호 모드가 꺼져 있지 않은 한 명령어와 자신에게 답장하는 메시지만 봅니다. 대부분의 빌더는 멘션에 봇이 조용히 반응하지 않을 때까지 이를 깨닫지 못합니다). 2. 기본값이 아니라 인프라에 맞춰 폴링과 웹훅 중에서 결정합니다. 롱 폴링은 공개 URL이나 인증서가 필요 없으며, 직접 관리하는 서버에 적합합니다. 웹훅은 공개 HTTPS 엔드포인트가 필요합니다(Telegram은 일반 HTTP를 호출하지 않습니다). 또한 모든 요청에서 확인하는 비밀 토큰이 필요합니다. 봇이 대기 상태로 실행될 수 없는 서버리스 또는 자동 확장 인프라에서만 웹훅을 사용합니다. 3. 첫 커밋부터 토큰을 코드베이스 밖에 둡니다. 환경 변수나 시크릿 관리자를 사용하고, 핸들러 파일에 문자열로 넣지 않습니다. 유출된 봇 토큰으로 누구나 즉시 봇을 제어할 수 있기 때문입니다. 4. 재시작 후에도 유지되는 상태를 사용합니다. 채팅별 대화 데이터를 일반 객체 형태의 메모리에 두지 말고 Redis나 데이터베이스에 저장합니다. 메모리 내 딕셔너리는 배포할 때마다 초기화되고, 워커 프로세스가 둘 이상이면 즉시 동기화가 깨집니다. 5. 업데이트를 중복 처리하지 않도록 합니다. 웹훅 모드에서는 update_id에 대한 멱등성 검사를 사용합니다. Telegram은 충분히 빠르게 200을 반환하지 않는 웹훅 호출을 재시도하므로, 그렇지 않으면 느린 핸들러가 같은 응답을 두 번 보내는 봇을 만듭니다. 6. 속도 제한을 인지합니다. Telegram은 채팅별로 초당 대략 한 개의 메시지, 전체 채팅에 대해 초당 약 30개의 메시지를 허용합니다. 따라서 여러 사용자에게 보내는 브로드캐스트에는 빠른 반복문이 아니라 자체 큐와 백오프가 필요합니다. 7. 공개 URL 없이 로컬에서 테스트한 뒤, 터미널에서 실행 중인 스크립트가 아니라 플랫폼 자체 프로세스 관리자가 웹훅 또는 롱 폴링 프로세스를 계속 실행하도록 배포합니다. · 버전 관리에 들어가는 파일에 봇 토큰을 하드코딩하지 않습니다. 모든 설정 단계에서 환경 변수나 시크릿 저장소를 사용합니다.