텔레그램 봇 API 한국어 가이드와 개발 도구
telegram-bot-api.info는 Telegram Bot API 10.3으로 봇을 개발하는 분들을 위한 무료 도구와 한국어 가이드를 제공합니다. 봇 토큰 발급부터 chat id 확인, 웹훅 설정, 메시지 전송까지 복사해서 바로 실행할 수 있는 예제로 설명하고, 185개 메서드를 브라우저에서 직접 호출해 볼 수 있습니다. 텔레그램과 제휴하지 않은 독립 프로젝트입니다.
한국어 가이드
봇 만들기, 봇 토큰, chat id, 웹훅, 메시지 전송처럼 텔레그램 봇 개발에서 가장 많이 찾는 주제를 단계별 예제와 오류 해결 방법으로 정리했습니다.
텔레그램 봇 만들기: @BotFather로 생성하고 첫 메시지 보내기
텔레그램 봇 만들기 가이드입니다. @BotFather의 /newbot으로 봇을 생성하고 토큰을 getMe로 확인한 뒤, getUpdates와 sendMessage로 첫 메시지를 보내는 과정을 curl과 Python 예제로 설명합니다.
텔레그램 봇 API로 메시지 보내기: sendMessage 사용법과 예제
텔레그램 봇 API 메시지 보내기 가이드입니다. sendMessage를 curl·Python·JavaScript로 호출하는 예제, HTML·MarkdownV2 서식, 인라인 버튼, 그룹·채널 전송, 400·403·429 오류 해결법을 정리했습니다.
텔레그램 봇 토큰: 발급부터 확인, 폐기, 안전한 보관까지
텔레그램 봇 토큰을 @BotFather에서 발급받는 법, 기존 봇의 토큰 찾기, getMe로 유효성 확인, 유출 시 폐기 방법을 정리했습니다. n8n·AI 비서 연동에 필요한 bot token과 chat id도 안내합니다.
텔레그램 웹훅 설정 가이드: setWebhook, secret_token, getWebhookInfo
텔레그램 봇 웹훅 설정 방법을 단계별로 정리했습니다. setWebhook 파라미터, secret_token 헤더 검증 코드, getWebhookInfo 상태 확인, deleteWebhook으로 되돌리기, 409·HTTPS 오류 해결까지 다룹니다.
텔레그램 chat id 확인방법: 개인, 그룹, 채널, 토픽별 chat id 찾기
텔레그램 chat id 확인방법을 개인 채팅, 그룹, 슈퍼그룹, 채널, 포럼 토픽별로 정리했습니다. getUpdates로 chat id를 찾는 법, -100으로 시작하는 ID의 의미, 결과가 비어 있을 때 해결법까지 설명합니다.
브라우저에서 바로 쓰는 무료 도구
Bot API Tester
Bot API 10.3의 185개 메서드를 브라우저에서 호출합니다. 타입별 파라미터 입력 폼, getUpdates 롱 폴링, 접고 펼 수 있는 JSON 뷰어를 지원하며 토큰은 브라우저에만 저장됩니다.
Swagger / OpenAPI
185개 메서드 전체를 19개 그룹으로 정리한 OpenAPI 3.1 명세입니다. 봇 토큰으로 Authorize한 뒤 Try it out으로 실제 요청을 보내 볼 수 있습니다.
Mini App Tester
Telegram.WebApp JS API를 일반 브라우저의 목(mock) 모드나 텔레그램 앱 안에서 테스트합니다. 45개 이상의 이벤트 로그와 실시간 속성 패널을 제공합니다.
자주 묻는 질문
텔레그램 봇 API란 무엇인가요?
텔레그램 봇을 제어하기 위한 HTTP 기반 API입니다. https://api.telegram.org/bot<token>/메서드이름 형식으로 HTTPS 요청을 보내고 JSON 응답을 받으며, 메시지 전송, 업데이트 수신, 그룹 관리 같은 기능을 메서드 단위로 제공합니다.
텔레그램 봇 개발에는 어떤 언어를 써야 하나요?
HTTPS 요청을 보낼 수 있는 언어라면 무엇이든 가능합니다. Python은 python-telegram-bot, aiogram, pyTelegramBotAPI, Node.js는 grammY와 Telegraf, Go는 telebot과 go-telegram-bot-api 라이브러리가 널리 쓰입니다.
이 사이트의 도구에 봇 토큰을 입력해도 안전한가요?
Bot API Tester는 토큰을 브라우저의 localStorage에만 저장하고 요청을 api.telegram.org로 직접 보냅니다. 그래도 공용 PC에서는 사용 후 토큰을 지우고, 유출이 의심되면 @BotFather에서 토큰을 폐기하십시오.
Bot API와 텔레그램 클라이언트 API(MTProto)는 어떻게 다른가요?
Bot API는 봇 개발을 위해 만든 HTTP 인터페이스이고, MTProto API는 텔레그램 앱 같은 사용자용 클라이언트를 만들 때 쓰는 저수준 프로토콜입니다. 봇을 만든다면 Bot API로 충분합니다.
텔레그램 Bot API의 최신 버전은 무엇인가요?
2026년 10월 기준 최신 버전은 2026년 8월 24일에 공개된 Bot API 10.3이며 메서드는 185개입니다. 버전별 변경 사항은 core.telegram.org의 Bot API changelog에서 확인할 수 있습니다.