Telegram Bot API 테스터

Bot API Tester는 브라우저에서 바로 사용하는 무료 텔레그램 봇 API 테스트 도구입니다. 봇 토큰을 붙여넣고 Bot API 10.3의 185개 메서드 중 하나를 고른 뒤 매개변수 폼을 채우면 JSON 응답을 즉시 받을 수 있습니다. 코드를 작성하지 않고도 텔레그램 봇 테스트, 봇 토큰 확인, 요청 디버깅을 할 수 있어 Postman을 대신할 가벼운 API 플레이그라운드로 쓰기 좋습니다.

텔레그램 봇 API 테스트 방법

1. @BotFather에서 /newbot 명령으로 토큰을 발급받습니다(텔레그램 봇 토큰 발급 방법 참고).
2. 토큰 입력란에 토큰을 붙여넣습니다. 토큰은 브라우저의 localStorage에 저장됩니다.
3. getMe를 실행해 토큰을 확인합니다.
4. 19개 카테고리나 검색창에서 메서드를 고릅니다. telegram-bot-api-tester.html#sendMessage처럼 URL 해시로 특정 메서드를 바로 열 수도 있습니다.
5. 매개변수를 입력하고(필수 항목은 따로 표시됩니다) 실행 버튼이나 Ctrl+Enter를 누릅니다.
6. 접고 펼칠 수 있는 JSON 뷰어에서 결과를 확인하고 필요한 값을 복사합니다.

텔레그램 봇 토큰 확인

getMe는 그대로 토큰 검사기 역할을 합니다. 호출 한 번으로 토큰이 유효한지, 어느 봇의 토큰인지 알 수 있습니다. 토큰이 유효하면 봇의 User 객체가 반환되고, 401 Unauthorized가 나오면 토큰이 틀렸거나 이미 폐기된 것입니다.

자주 하는 작업

• 채팅 ID 찾기. Long Polling을 시작하고 봇에게 메시지를 보낸 다음, 업데이트 기록에서 message.chat.id를 확인합니다. 기록에는 최근 업데이트 100개가 보관됩니다. 자세한 내용은 텔레그램 채팅 ID 확인 방법에 있습니다.
• 메시지와 서식 시험. 코드를 작성하기 전에 parse_mode, 인라인 키보드, 링크 미리보기를 적용한 sendMessage를 미리 보내 볼 수 있습니다(Bot API로 메시지 보내기 참고).
• 웹훅 관리. 텔레그램 봇 웹훅 설정 가이드에 나온 대로 setWebhook, getWebhookInfo, deleteWebhook을 호출합니다.
• Bot API 10.x 신기능 확인. 리치 메시지, 임시 메시지, 가입 요청 쿼리 같은 새 메서드도 바로 호출할 수 있습니다.

getUpdates는 웹훅이 설정된 상태에서는 동작하지 않으므로, Long Polling을 시작하면 먼저 deleteWebhook이 호출됩니다(대기 중인 업데이트는 유지됩니다). 운영 중인 봇이 웹훅을 사용한다면 테스트를 마친 뒤 setWebhook으로 웹훅을 다시 등록해야 합니다.

개인정보 보호: 토큰은 브라우저에만 저장됩니다

이 테스터는 자체 백엔드가 없는 정적 페이지입니다. 토큰은 브라우저의 localStorage에만 저장되고, 모든 요청은 브라우저에서 CORS를 지원하는 api.telegram.org로 직접 전송됩니다. 토큰과 API 트래픽은 저희 서버를 거치지 않습니다. 그래도 실험할 때는 별도의 테스트용 봇을 쓰는 것이 가장 안전합니다.

관련 도구와 레퍼런스

모든 메서드의 OpenAPI 3.1 명세는 Swagger 문서에서 볼 수 있고, Telegram.WebApp JavaScript API는 Mini App Tester로 테스트할 수 있습니다. 매개변수 설명과 curl, Python, JavaScript 예제는 메서드 레퍼런스에 정리되어 있습니다. 봇을 처음 만든다면 텔레그램 봇 만들기 가이드부터 시작하는 것이 좋습니다.