결론부터
- 1미니 앱 = HTTPS 웹 페이지 + 봇 — 텔레그램 안에서 열린다(공식 문서).
- 2@BotFather 에서 봇에 웹 앱 주소를 등록하고 메뉴 단추·링크로 연다.
- 3웹 페이지는 텔레그램이 넘겨주는 사용자 데이터를 서버에서 검증한다.
텔레그램 미니 앱 만들기 — 구조
공식 문서의 미니 앱(Web App)은 HTTPS 로 여는 웹 페이지를 봇에 연결해 텔레그램 안에서 여는 것입니다. 앱을 따로 설치하지 않고, 보통의 웹 기술로 만듭니다.
| 부분 | 할 일 |
|---|---|
| 봇 | @BotFather 로 만든다 — 봇 만들기 |
| 웹 페이지 | HTTPS 주소 · 텔레그램 웹 앱 스크립트 넣기 |
| 연결 | @BotFather 에서 봇의 메뉴 단추나 미니 앱으로 주소 등록 |
| 서버 | 텔레그램이 넘기는 사용자 데이터(initData)를 봇 토큰으로 검증 |
- BotFather 소개 — 새 봇 계정을 만들고 이미 있는 봇을 관리한다
- 봇 시작 — 시작한 뒤 /newbot 을 보내 새 봇을 만든다(공식 튜토리얼)
순서
- 봇을 만들고 토큰을 받습니다.
- HTTPS 로 열리는 페이지를 올리고, 텔레그램 웹 앱 스크립트를 넣습니다.
- @BotFather 에서 그 봇에 웹 앱 주소를 등록합니다.
- 서버에서 initData 를 검증한 뒤에만 사용자를 믿습니다.
파는 기능은 스타 결제로 붙입니다. 자세한 것은 공식 문서(core.telegram.org/bots/webapps)에 있습니다.
자주 묻는 질문
텔레그램 미니 앱은 어떻게 만드나요?
HTTPS 로 여는 웹 페이지를 만들고, @BotFather 에서 봇에 그 주소를 미니 앱(웹 앱)으로 등록합니다(공식 문서).
어떤 언어로 만드나요?
보통의 웹(HTML·CSS·자바스크립트)입니다. 페이지에 텔레그램 웹 앱 스크립트를 넣어 텔레그램과 주고받습니다.
사용자 정보를 믿어도 되나요?
공식 문서대로 텔레그램이 넘기는 초기화 데이터(initData)를 서버에서 봇 토큰으로 검증한 뒤 씁니다.
참고한 공식 문서
요약
한눈에 정리
- 1웹 + 봇
HTTPS 페이지.
- 2BotFather
주소 등록 · 메뉴 단추.
- 3검증
initData 를 서버에서.
최종 수정 2026-10-06
