FAQ
빠른 시작
Telegram 봇 토큰은 어디에서 찾을 수 있나요?
Telegram 봇 토큰은 어디에서 찾을 수 있나요?

Telegram 봇 토큰은 어디에서 찾을 수 있나요?

Anton Ingachev
2026년 8월 30일

토큰은 Mini Apps Builder가 여러분의 봇을 프로젝트에 연결할 수 있게 해 주는 비밀 키입니다. Telegram 비밀번호도 아니고 봇 링크도 아닙니다. 이를 받기 위해 프로그래밍할 필요는 없습니다.

아직 봇이 없는 경우 토큰을 받는 방법

공식 BotFather를 여세요. 이것은 Telegram에서 봇을 만들고 관리하기 위한 도구입니다. 사용자 이름을 확인하세요. 바로 @BotFather여야 하며, 추가 문자나 숫자가 있으면 안 됩니다. 인터페이스는 Android, iOS, macOS, Windows, Linux, Web 등 모든 플랫폼에서 동일합니다.

다음 단계는 BotFather 채팅에서 진행합니다: Start Bot을 누르세요,

이런 메시지가 표시됩니다. 이제 두 가지 방법으로 봇을 만들 수 있습니다: 채팅을 통해서와 Mini App을 통해서.

채팅으로 새 봇 만들기

BotFather가 보낸 메시지에서 /newbot을 선택해야 합니다. 메시지 안의 이 텍스트를 클릭하기만 하면 봇 생성 과정이 바로 시작됩니다.

BotFather가 앱의 이름을 묻습니다. 이것은 Telegram의 어떤 사용자든 보게 될 여러분의 봇/애플리케이션의 "이름"입니다. 하지만 나중에 언제든 변경할 수 있습니다.

"이름"을 입력한 후 BotFather가 username_bot을 정해 달라고 요청합니다. 이는 고유한 ID로, 생성 후에는 변경할 수 없습니다. 또한 입력한 값이 이미 사용 중이면 Telegram이 알려줍니다.

username_bot을 입력하면 이런 메시지가 표시되는데, 이는 봇이 생성되었다는 뜻입니다. 메시지 안에 bot token이 포함되어 있습니다. 그냥 그것을 누르면 복사되며, 이제 우리 사이트에 붙여넣을 수 있습니다.

복사한 토큰은 Mini Apps Builder에서 프로젝트를 만들 때 "Token" 입력란에 붙여넣어야 합니다. 그러면 프로젝트가 생성됩니다.

Mini App으로 새 봇 만들기

이것은 새 봇을 만들고 bot token을 얻는 두 번째 방법입니다. 위 방법을 이미 사용했다면 이 부분은 읽지 않아도 됩니다.

채팅 입력창 왼쪽 아래의 "Open" 버튼을 누릅니다.

이런 화면이 열립니다. 봇을 한 번도 만들어 본 적이 없다면 "My bots" 아래가 비어 있을 것입니다. 어쨌든 지금은 새 봇을 만드는 경우를 설명하는 것이므로 "Create a New Bot" 버튼을 누릅니다.

강조 표시된 입력란은 필수입니다. 로고와 "About"은 나중에 언제든 추가할 수 있습니다.

Bot Name - Telegram의 어떤 사용자든 보게 될 여러분의 봇/애플리케이션 이름입니다. 하지만 나중에 언제든 변경할 수 있습니다.

username_bot - 고유한 ID로, 생성 후에는 변경할 수 없습니다. 또한 입력한 값이 이미 사용 중이면 Telegram이 알려줍니다.

Bot Name과 username_bot을 입력한 후 화면 하단의 "Create Bot" 버튼을 누르세요.

이런 화면이 보이면 "Copy" 버튼을 눌러 해당 봇의 Bot Token을 복사합니다.

"Copy" 버튼을 누르면 잠시 이런 알림이 표시됩니다. 토큰이 복사되었으니 우리 사이트에 붙여넣을 수 있습니다.

복사한 토큰은 Mini Apps Builder에서 프로젝트를 만들 때 "Token" 입력란에 붙여넣어야 합니다. 그러면 프로젝트가 생성됩니다.

잘 되지 않을 때는 어떻게 하나요

문제대처 방법
필요한 봇이 목록에 없음봇이 속한 Telegram 계정이 열려 있는지 확인하세요. 다른 사람이 만들었다면 소유자가 누구인지 그 사람에게 문의하세요.
BotFather가 username을 받아들이지 않음라틴 문자, 숫자, 밑줄을 사용하고 끝에 bot을 추가하세요. 이름이 이미 사용 중이면 다른 이름을 만드세요.
명령을 보낼 수 없음반드시 @BotFather 채팅을 열고 메시지 입력창에 /mybots 또는 /newbot을 보내세요.
Mini Apps Builder가 토큰을 받아들이지 않음다시 복사하세요. 여분의 텍스트나 공백 없이 전체 문자열을 붙여넣었는지 확인하세요.

오류가 계속되면 Mini Apps Builder 지원팀에 오류 문구를 보내고 마지막으로 수행한 단계를 설명하세요. 토큰 자체는 첨부하지 마세요. 스크린샷에서는 토큰을 완전히 가려 주세요.

토큰을 안전하게 보관하는 방법

토큰은 봇 관리 권한을 주므로 비밀번호처럼 취급하세요. 공개하지 말고 외부인에게 보내지 마세요. 신뢰할 수 있는 서비스의 특별한 입력란에만 이 키를 입력하세요.

자신의 애플리케이션을 만들 준비가 되셨나요?

지금 바로 시작하세요 - 무료입니다!