시작 전 준비
5~10분이면 끝납니다.
필요한 것
- 스마트폰 또는 PC
- 전화번호 (텔레그램 가입용)
- 준업에게 연락할 수단 (카톡/텔레그램/문자 등)
미리 알아둘 용어
- BotFather: 텔레그램 공식 봇 생성기
- Bot Token: 봇을 조종하는 비밀번호 같은 키
- User ID: 텔레그램 계정의 고유 숫자 번호
- username: @로 시작하는 공개 아이디
봇 토큰은 비밀번호입니다. 오픈채팅/SNS/깃허브에 올리면 다른 사람이 내 봇을 가로챌 수 있습니다. 준업에게만 안전하게 보내세요.
텔레그램 가입 / 앱 설치
아직 텔레그램이 없다면 먼저 설치합니다. 이미 있다면 이 단계는 건너뛰세요.
1-1. 앱 설치
- 앱스토어 / 플레이스토어에서 Telegram 검색 후 설치
- 또는 PC: https://desktop.telegram.org/
- 웹: https://web.telegram.org/
1-2. 가입 / 로그인
- 전화번호 입력
- 문자 또는 텔레그램으로 온 인증코드 입력
- 이름 설정 (필요하면 username도 설정)
- 채팅 목록 화면이 보이면 준비 완료
텔레그램에 로그인되어 검색창을 쓸 수 있으면 다음 단계로 갑니다.
BotFather로 새 봇 만들기
텔레그램에서 공식 계정 @BotFather 를 찾아 대화하면 됩니다.
2-1. BotFather 열기
- 텔레그램 상단 검색창에 @BotFather 입력
- 파란색 체크 표시가 있는 공식 계정인지 확인
- 대화방 입장 후 시작 또는 /start 전송
모바일에서 바로 열기: https://t.me/BotFather
2-2. 새 봇 생성 명령
- 채팅창에 아래 명령을 보냅니다.
- BotFather가 봇 이름을 물어봅니다.
- Display name 입력 (사람 눈에 보이는 이름)
- 예: 준업 도우미 / My Helper Bot
- 이어서 username 을 물어봅니다. 규칙은 아래와 같습니다.
- 반드시 bot 으로 끝나야 함
- 전 세계에서 중복 불가
- 예: juneop_helper_bot, my_friend_ops_bot
2-3. 성공 메시지 확인
생성이 끝나면 BotFather가 대략 이런 메시지를 보냅니다.
| 봇 이름 | 예) 준업 도우미 |
|---|---|
| 봇 username | 예) @juneop_helper_bot |
| Bot Token | 숫자:영문숫자기호 형태 긴 문자열 |
2-4. 토큰을 당장 저장
- 토큰 문장을 길게 눌러 복사
- 메모장/암호 관리자에 임시 저장
- 토큰 앞뒤 공백이 들어가지 않게 주의
BotFather 채팅에서 /token 또는 /mybots → 내 봇 선택 → API Token 으로 다시 볼 수 있습니다. 유출이 걱정되면 Revoke current token 으로 재발급하세요. 재발급 시 이전 토큰은 즉시 무효입니다.
봇 username과 Bot Token을 확보했으면 다음 단계로 갑니다.
봇 토큰을 준업에게 전달
토큰만 있으면 준업이 그 봇을 연결/운영할 수 있습니다.
3-1. 전달할 내용
- 1Bot Token 전체 문자열
- 2봇 username (예: @juneop_helper_bot)
- 3봇 표시 이름 (선택)
3-2. 추천 전달 방법
- 가장 편함: 준업과의 1:1 텔레그램/카카오톡으로 토큰 전송
- 더 안전: 토큰은 별도 메시지로, 가능하면 읽으면 지워달라고 요청
- 더더 안전: 암호 관리자 공유 / 암호화된 메모
3-3. 절대 하지 말 것
- 단체 채팅방에 토큰 올리기
- 인스타/블로그/깃허브에 붙여넣기
- 스크린샷을 공개 계정에 업로드
토큰 전달 메시지 예시
준업아, 텔레그램 봇 만들었어. - 봇 이름: 준업 도우미 - username: @juneop_helper_bot - Bot Token: 1234567890:AAHardToGuessTokenExample_xxxx 이 토큰으로 연결해줘. 유출되면 안 되니까 저장 후 채팅은 지워도 돼.
준업이 토큰을 받았다고 확인하면, 이어서 본인 User ID를 찾아 보냅니다.
userinfobot으로 내 User ID 확인
User ID는 @username 과 다릅니다. 보통 숫자로만 된 고유 번호입니다.
많이 쓰는 봇 이름은 @userinfobot 입니다. 검색 결과에 비슷한 이름 봇이 여러 개 있을 수 있으니, 아래 방법대로 보내고 Id 숫자가 바로 보이면 성공입니다. 안 되면 @getidsbot 또는 @RawDataBot 도 대안으로 쓸 수 있습니다.
4-1. userinfobot 열기
- 텔레그램 검색창에 userinfobot 또는 @userinfobot 입력
- 봇 선택 후 대화 시작
- 빠른 링크: https://t.me/userinfobot
4-2. 시작해서 ID 확인
- 시작 버튼을 누르거나 /start 를 보냅니다.
- 봇이 내 계정 정보를 답장합니다.
- 아래 항목을 찾습니다.
| Id | 이게 User ID · 예) 123456789 |
|---|---|
| First name | 내 이름 |
| Username | 있으면 @xxxx 형태 (없을 수도 있음) |
4-3. 숫자만 복사
- Id 옆의 숫자만 복사합니다.
- 하이픈(-)이 있는 큰 숫자도 그대로 복사하면 됩니다. (일부 계정/앱 환경)
- username(@로 시작)을 User ID 라고 착각하지 마세요.
4-4. 대안 봇 (안 될 때)
- @getidsbot 에 /start
- 또는 @RawDataBot 에 /start 후 id 값 확인
- 또는 본인이 만든 봇 대화방에서 메시지를 보낸 뒤, 준업이 서버 로그로 ID를 확인할 수도 있음
내 User ID 숫자를 메모했다면 마지막 전달만 하면 됩니다.
준업에게 한 번에 전달하기
토큰과 User ID를 같이 보내면 준업이 바로 세팅할 수 있습니다.
전달 전 체크리스트
- 1BotFather에서 봇 생성 완료
- 2Bot Token 복사 완료
- 3userinfobot에서 User ID 숫자 확인
- 4봇 username 확인
- 5토큰을 공개 장소에 올리지 않음
준업에게 보낼 최종 메시지 템플릿
준업아, 텔레그램 준비 끝났어. 1) 봇 정보 - 봇 이름: 준업 도우미 - 봇 username: @juneop_helper_bot - Bot Token: 1234567890:AAHardToGuessTokenExample_xxxx 2) 내 텔레그램 User ID - User ID: 123456789 이 두 개로 연결해줘! 토큰은 비밀번호라서 저장하고 이 메시지는 지워도 돼.
준업이 “토큰 등록 완료”라고 하면, 필요 시 채팅의 토큰 메시지를 삭제하세요. 나중에 토큰이 새면 BotFather에서 Revoke 하면 됩니다.
자주 하는 실수 / FAQ
막히면 여기부터 보세요.
Q. username 이 이미 사용 중이라고 해요
다른 사람이 이미 쓰는 이름입니다. 끝은 꼭 bot 으로 유지한 채 앞부분을 바꾸세요. 예: myname_helper_bot, myname_ops_bot_01
Q. 토큰을 복사 못 했어요 / 잃어버렸어요
@BotFather 에서 /mybots → 내 봇 선택 → API Token 으로 다시 확인하세요. 유출 걱정이 있으면 Revoke current token 으로 새 토큰을 발급해 준업에게 다시 보내면 됩니다.
Q. userinfobot 이 검색이 안 돼요
철자를 확인하세요: userinfobot. 그래도 안 되면 @getidsbot 또는 @RawDataBot 에 /start 를 보내 Id 숫자를 확인하면 됩니다.
Q. username 을 보내면 되나요, User ID 를 보내야 하나요?
준업이 권한/허용 목록을 숫자 ID 기준으로 넣는 경우가 많아서 User ID 숫자가 필요합니다. username 은 바뀌거나 없을 수 있지만 User ID는 계정 고유 값에 가깝습니다.
Q. 봇에게 말을 걸어야 하나요?
토큰/User ID 전달만 하면 기본 준비는 끝입니다. 다만 나중에 봇이 내게 메시지를 보내려면, 내가 그 봇 대화방에서 한 번 /start 를 눌러야 하는 경우가 많습니다. 준업이 요청하면 내 봇을 검색해 Start 한 번 누르면 됩니다.
Q. 토큰 형식이 맞는지 모르겠어요
보통 숫자:문자열 형태입니다. 가운데 콜론(:)이 있고 꽤 깁니다. 공백/줄바꿈이 중간에 들어가면 안 됩니다.
한 장 요약
바쁠 때는 이것만 보면 됩니다.
- 텔레그램 설치/로그인
- @BotFather → /newbot → 이름/username 설정
- 나온 Bot Token을 준업에게 전달
- @userinfobot → /start → Id 숫자 확인
- 그 User ID를 준업에게 전달