Telegram 봇을 만들고 채널에 추가하는 방법
@BotFather로 봇을 만들어 게시 권한이 있는 관리자로 Telegram 채널에 추가하고, 토큰을 안전하게 보관하고, 테스트하고, 게시물이 올라오지 않을 때 해결하는 방법을 알아봐요.
Telegram 채널에 봇을 추가하려면 봇을 채널 관리자로 지정해야 해요. 채널 정보를 열고 관리자를 추가한 뒤, 봇의 사용자 이름을 검색하고 “메시지 게시”를 켜세요. 직접 만든 봇이 필요하다면 먼저 @BotFather로 봇을 만들고, 그때 받는 토큰을 보관하세요. 그런 다음 봇을 믿고 쓰기 전에 테스트 게시물을 하나 보내 보세요.
이 가이드는 봇, 토큰, 권한, 테스트 게시물, 문제 해결을 다루며 봇 코드 작성은 다루지 않아요. Studio를 비롯해 내가 소유한 봇으로 게시하는 도구에는 모두 이 설정이 필요해요. 게시 시간 정하기와 실패한 예약 게시물 처리는 Telegram 예약 가이드를 참고하세요.
채널에서 봇이 할 수 있는 일
봇은 전화번호가 필요 없는 특별한 Telegram 계정이에요. 토큰을 가진 사람은 누구든 봇으로 게시할 수 있어요.
봇은 채널 구독자가 될 수 없고 관리자로만 들어갈 수 있어요. 게시는 봇에게 주는 권한 중 하나이고, 봇이 올린 게시물에는 채널 이름이 서명으로 표시돼요.
이 가이드의 예시는 가상이에요. 한 도예 공방이 공개 채널 Harbor Street Pottery를 운영하면서 봇으로 가마 일정을 올리려고 해요.
@BotFather로 봇 만들기
Telegram의 BotFather 가이드에 나온 단계는 다음과 같아요.
- Telegram에서 @BotFather를 열어요. 철자가 정확한지 확인하세요.
/newbot을 보내요.- 이름을 입력해요. 이름은 나중에 바꿀 수 있어요.
- 사용자 이름을 입력해요. 영문자, 숫자, 밑줄로 5자에서 32자 사이여야 하고 “bot”으로 끝나야 해요. 사용자 이름은 나중에 바꿀 수 없어요.
- 답장에 있는 토큰을 복사해요. 토큰은
123456789:AAF…같은 형태예요.
공방은 봇 이름을 Harbor Pottery Poster로, 사용자 이름을 @harbor_pottery_poster_bot으로 정해요. 관리자 목록에서 팀원들이 알아볼 수 있는 이름을 고르세요.
봇 토큰 안전하게 보관하기
Telegram은 토큰을 가진 사람은 누구든 봇을 제어할 수 있다고 경고해요. 토큰을 비밀번호처럼 다루세요.
- 비밀번호 관리자에 저장하세요.
- 연결하려는 도구에만 붙여 넣으세요.
- 스크린샷, 채팅, 티켓, 공유 문서에 들어가지 않게 하세요.
- 다른 사람이 게시할 수 있게 하려고 토큰을 공유하지 마세요. 대신 게시 도구에서 접근 권한을 주세요(팀과 소셜 계정 함께 쓰기 참고).
토큰이 유출되면 @BotFather에서 폐기하세요. /mybots로 봇 설정을 열 수 있어요. 폐기하면 새 토큰이 발급되고 기존 토큰은 더 이상 작동하지 않으니, 그 토큰을 쓰던 도구를 모두 업데이트하세요.
예시에서 공방 주인은 실수로 공유 문서에 토큰을 붙여 넣었다가, 토큰을 폐기하고 새 토큰으로 도구를 다시 연결해요.
봇을 채널 관리자로 추가하기
채널 정보를 열고 관리자 목록으로 가세요(일부 앱에서는 “채널 관리” 아래에 있고, 메뉴 이름은 앱마다 달라요). 관리자 추가를 선택하고 봇의 사용자 이름을 검색하세요.
그러면 Telegram이 어떤 관리자 권한을 줄지 물어봐요. 도구에 필요한 권한만 켜고 저장하세요.
| 권한 | 할 수 있는 일 | 게시용 봇에 필요한가요? |
|---|---|---|
| 메시지 게시 | 채널 이름으로 게시, 봇이 올린 최근 게시물 삭제 | 예, 필수 |
| 다른 사람 메시지 수정 | 게시물 고정, 봇이 보내지 않은 게시물 수정 | 도구에 필요할 때만 |
| 다른 사람의 메시지 삭제 | 봇이 보내지 않은 게시물 삭제 | 도구에 필요할 때만 |
| 채널 정보 수정, 사용자 초대, 관리자 추가 | 채널 자체 운영 | 아니요 |
Harbor Street Pottery의 봇은 “메시지 게시” 권한만 받아요.
그룹이라면 봇을 관리자가 아니라 멤버로 추가하세요. 그룹에서는 봇이 자기 이름으로 게시하고, 그룹이 멤버의 메시지 전송을 막아 둔 경우에만 관리자 권한이 필요해요.
테스트 게시물을 보내고 확인하기
연결한 도구에서 “테스트: 가마 일정 게시물입니다. 무시해 주세요”처럼 짧고 테스트임이 분명한 메시지를 보내세요. 구독자가 볼 수도 있으니 문제 될 내용은 넣지 마세요. 그다음 아래 항목을 확인하세요.
- 이름이 비슷한 다른 채널이 아니라 올바른 채널에 올라왔나요?
- 채널 이름(예시에서는 Harbor Street Pottery)으로 서명돼 있나요?
- 링크나 사진을 올릴 계획이라면, 예상한 대로 보이나요?
확인이 끝나면 테스트 게시물을 삭제하세요. 채널에서 삭제한 게시물은 모든 구독자에게서 사라져요.
게시하지 못하는 봇 고치기
| 보이는 현상 | 해결 방법 |
|---|---|
| 봇을 구독자로 추가할 수 없어요 | “메시지 게시” 권한이 있는 관리자로 추가하세요 |
| 봇이 관리자인데 아무것도 올라오지 않아요 | 봇 권한에서 “메시지 게시”를 켜세요 |
| 도구가 토큰을 거부해요 | 토큰을 다시 복사하거나, 토큰을 폐기했다면 새 토큰을 쓰세요 |
| 게시가 잘 되다가 멈췄어요 | 토큰, 관리자 목록, 봇 권한을 확인하세요 |
| 게시물이 엉뚱한 채팅으로 갔어요 | 도구를 올바른 채널에 다시 연결하세요 |
설정에는 문제가 없는데 예약 게시물이 올라오지 않았다면 실패한 게시물 체크리스트를 활용하세요.
Studio에서 Telegram 연결은 세 단계예요. @BotFather로 봇을 만들고, 토큰을 붙여 넣은 뒤(Studio가 토큰을 확인하고 봇 이름을 보여 줘요) “채널에 추가”를 누르세요. Telegram 자체 선택 화면에서 봇이 메시지 게시, 수정, 삭제 권한을 가진 관리자로 추가되고, 채널은 Studio에 저절로 나타나요. “대신 그룹 사용”을 누르면 그룹을 연결해요. 토큰이 더 이상 작동하지 않으면 Studio가 그 계정에 “다시 연결”을 표시해요. 다시 연결할 때는 새 토큰으로 같은 단계를 거쳐요. Studio는 아직 이용할 수 없지만 대기 명단에 등록할 수 있어요.
