
토큰은 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" 입력란에 붙여넣어야 합니다. 그러면 프로젝트가 생성됩니다.
이것은 새 봇을 만들고 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 지원팀에 오류 문구를 보내고 마지막으로 수행한 단계를 설명하세요. 토큰 자체는 첨부하지 마세요. 스크린샷에서는 토큰을 완전히 가려 주세요.
토큰은 봇 관리 권한을 주므로 비밀번호처럼 취급하세요. 공개하지 말고 외부인에게 보내지 마세요. 신뢰할 수 있는 서비스의 특별한 입력란에만 이 키를 입력하세요.