프로젝트와 채널
프로젝트를 만들고 봇을 연결해 상태를 확인하세요. 여러 채널, 토큰 교체, 일시 중지와 요금제에 따른 동결도 설명합니다.
이 페이지에서
프로젝트는 봇이나 서비스 하나의 설정, 반응, 데이터를 모아 둡니다. 채널은 프로젝트를 실제 대화 장소에 연결합니다. Telegram 봇, 웹사이트 채팅, 다른 메신저가 채널이 될 수 있습니다. 예를 들어 학교는 프로젝트 하나에 Telegram과 웹사이트 채널을 연결할 수 있습니다.
프로젝트에서 프로젝트를 만든 다음 채널을 추가하세요. Telegram에는 봇을 관리하는 키인 @BotFather 토큰이 필요합니다. 화면 위쪽에서 다른 프로젝트로 전환할 수 있습니다.
같은 반응을 쓰는 WhatsApp과 VK 채널도 연결할 수 있습니다. 채널에서 차이를 확인하고, WhatsApp에서 연결 방법을 알아보세요.
봇 연결하기
- 프로젝트가 없다면 프로젝트를 열고 프로젝트 추가를 누르세요. 프로젝트 카드에서 채널 추가를 누른 뒤 Telegram을 선택하세요. 첫 봇은 시작 안내를 이용할 수도 있습니다.
- @BotFather 토큰을 붙여넣고 확인을 누르세요. GetMyBot이 찾은
@username을 보여 주므로 올바른 토큰인지 확인할 수 있습니다. - 연결을 누르세요. 토큰은 저장할 때 암호화되고 메시지 수신은 바로 시작됩니다.
연결하면 Telegram이 다른 채널과 함께 프로젝트 카드에 나타납니다. 카드에는 프로젝트 이름, 봇의 @username, 사용자 수, 활성 반응 수, 오늘의 요청 수가 표시됩니다. 잔여 요청 수는 요금제나 통계에서 확인하세요.
봇 여러 개 운영하기
한 계정으로 프로젝트와 봇 여러 개를 운영할 수 있습니다. 수는 요금제의 ‘최대 봇 수’에 따라 제한됩니다. 화면 위쪽이나 프로젝트에서 프로젝트를 바꾸세요. ‘반응’, ‘채팅’, ‘통계’에는 현재 선택한 프로젝트의 데이터가 표시됩니다.
봇이 메시지를 받는 방법
연결 후에는 GetMyBot이 Telegram의 메시지, 버튼 누름, 채팅 참여, 결제 같은 이벤트를 자동으로 받습니다. 유효한 토큰만 있으면 수신을 따로 설정할 필요가 없습니다. 서버 설정에 따라 Telegram이 플랫폼 주소로 이벤트를 보내는 웹훅 방식이나 플랫폼이 Telegram에 주기적으로 물어보는 long polling 방식을 사용합니다.
켜기와 끄기
설정의 봇 상태 카드에서 봇을 켜거나 끌 수 있습니다. 꺼진 봇은 메시지에 응답하지 않습니다. 다시 연결하지 않아도 변경 내용이 즉시 적용됩니다.
프로젝트 상태와 채널 연결 상태
프로젝트 목록에는 프로젝트 상태가 활성, 일시 중지, 동결로 따로 표시됩니다. 이 표시는 Telegram 메시지가 전달되는지 확인한 결과가 아닙니다. 채널마다 온라인, 신호 없음, 설정됨, 비활성화됨, 프로젝트 비활성이라는 상태도 있습니다. 따라서 Telegram 없이 웹 채팅만 있는 활성 프로젝트가 ‘중지됨’으로 보이지는 않습니다.
활성 프로젝트에 켜진 Telegram 채널이 정확히 하나라면 온라인은 해당 봇을 처리하는 프로세스가 최근 활동 신호를 보냈다는 뜻입니다. 신호가 없으면 신호 없음으로 표시됩니다. 켜진 Telegram 채널이 여러 개라면 프로젝트 전체의 신호를 특정 채널 하나에 돌릴 수 없으므로 설정됨으로 표시합니다. 다른 플랫폼의 켜진 채널도 설정됨은 연결되었다는 뜻이지, 모든 메시지가 반드시 전달된다는 보장은 아닙니다.
@BotFather에서 토큰을 재발급한 경우(Bot Settings → Revoke / New token), 설정 → 채널 → Telegram 🔑에서 업데이트합니다. 새 토큰은 동일한 봇에 속해야 합니다(Telegram 내부 ID 일치) — 이렇게 해야 모든 반응, 구독자, 데이터가 보존됩니다. Telegram 채널이 표시되지 않으면 같은 창에서 «토큰 변경»을(를) 선택하세요.
실제로 상태를 볼 때는 다음을 기억하세요.
- 표시가 늦을 수 있습니다. 채널을 연결하거나 플랫폼이 재시작된 직후 ‘온라인’이 나타나기까지 위 기간만큼 걸릴 수 있습니다.
- 켜진 Telegram 채널이 몇 분 넘게 신호 없음이라면 토큰과 설정의 Bot health 카드를 확인하세요. 사용자가 프로젝트를 일시 중지하거나 요금제 때문에 동결되기 전까지 프로젝트 자체는 활성 상태입니다.
- 활동 신호는 프로세스들이 공유하므로 어떤 서버가 화면 요청에 답했는지와는 무관합니다. Telegram 채널이 여러 개라면 각 채널의 개별 가용성을 증명하지도 않습니다.
봇이 오프라인이 되면
플랫폼은 매분 활동 신호를 확인합니다. 켜진 봇에 새 신호가 하나도 없으면 장애 기록을 열고 원인을 확인한 다음 복구를 시도합니다.
가능한 원인은 네 가지이며 설정의 Bot health 카드에서 볼 수 있습니다.
- 웹훅 문제: Telegram이 업데이트를 플랫폼 주소로 보내지 못해 웹훅을 다시 등록합니다.
- 취소된 토큰:
getMe가 401을 반환합니다. 다시 시작하는 것으로 해결되지 않으므로 @BotFather에서 새 토큰을 발급받아 토큰 변경에 입력하세요. - 처리 서버 없음: 업데이트를 처리하는 서버가 없어 플랫폼이 봇을 다시 시작합니다.
- 원인 미확인: Telegram이 확인 요청에 응답하지 않았습니다.
자동 재시작은 동기화 버튼과 같은 일을 합니다. getMe로 토큰을 확인하고 웹훅을 다시 등록합니다. 재시도 간격은 점차 길어집니다. 각 시도의 시간, 성공 여부, 실패했다면 오류가 Restart log에 기록되고 다음 시도 시간도 카드에 표시됩니다.
Bot health에 설정된 시간(기본 5분) 동안 봇의 활동 신호가 없으면 소유자에게 종 모양 알림과 이메일로 ‘봇 오프라인’이 전달됩니다. 알림 수신 채팅 목록에는 봇이 직접 메시지를 보냅니다. 장애 기록당 알림은 한 번입니다. 활동 신호가 돌아오면 중단 시간과 함께 ‘봇 다시 온라인’ 알림을 보냅니다. 지난 장애의 기간과 원인도 같은 카드에 남습니다.
요금제에 따른 동결
봇은 켜짐/꺼짐과 별도로 동결될 수 있습니다. 현재 요금제가 연결된 봇 수를 감당하지 못할 때 플랫폼이 동결합니다. 원인은 두 가지뿐입니다.
- 봇 수 한도 초과: 현재 연결된 봇보다 한도가 낮은 요금제로 바뀌었습니다.
- 구독 미갱신: 유료 요금제가 끝나 무료 요금제의 한도가 적용됩니다.
동결된 봇은 메시지를 받지 않습니다. 단순 표시가 아니라 이벤트 수신이 꺼집니다. 데이터, 반응, 구독자는 모두 유지되므로 복구할 수 있습니다.
동결을 풀려면 필요한 봇 수를 지원하는 요금제를 결제하세요. 새 요금제가 활성화되면 한도에 찰 때까지 가장 오래된 봇부터 자동으로 복구됩니다. 어떤 봇을 먼저 복구할지 직접 선택할 수 없습니다. 다른 봇이 필요하다면 불필요한 연결을 제거한 뒤 요금제를 결제하세요.
봇 한 개가 동결되는 것과 계정 전체 동결은 다릅니다. 계정 전체가 동결되면 모든 봇과 대량 발송이 멈추고 ‘계정 동결’ 배너가 표시됩니다. 지원을 통해서만 해제할 수 있습니다. 결제 및 잔액도 참고하세요.
프로필과 동기화
설정의 동기화 버튼은 @BotFather에서 이름을 바꾼 경우 Telegram의 봇 이름을 다시 가져옵니다. 봇 프로필 사진은 자동으로 가져옵니다.
토큰 변경
@BotFather에서 토큰을 다시 발급했다면(Bot Settings → Revoke / New token) 프로젝트 설정 → 토큰 변경에서 새 토큰을 입력하세요. 토큰은 Telegram 내부 ID가 같은 동일한 봇의 것이어야 반응, 구독자, 데이터가 유지됩니다.
다른 계정으로 소유권 이전
프로젝트 설정 → 소유자 변경에서 이메일 주소를 입력하면 다른 GetMyBot 계정으로 프로젝트를 이전하라는 초대가 발송됩니다. 초대는 72시간 동안 유효합니다. 받는 사람이 수락하기 전까지 프로젝트는 여전히 내 계정에 있고 이전을 취소할 수 있습니다. 수락하면 소유자가 바뀌고 프로젝트에 대한 접근 권한을 잃습니다. 고객이나 동료에게 프로젝트를 넘길 때 사용하세요.
봇 템플릿
템플릿은 다른 봇에 적용할 수 있는 봇 설정과 모든 반응의 스냅샷입니다.
- 설정의 템플릿 만들기는 현재 봇을 이름이 있는 템플릿으로 저장합니다.
- 템플릿 적용은 대상 봇의 설정을 템플릿 설정으로 바꾸고, 템플릿의 반응을 기존 반응에 추가합니다.
여러 프로젝트에 비슷한 봇을 만들 때 유용합니다.
카탈로그의 준비된 솔루션 설치
준비된 솔루션 카탈로그에는 설치 안내가 있습니다. 필요한 값을 입력하고 호환성 및 연결 사항을 확인한 다음 만들어질 리소스 목록을 검토하세요. 설치 후에는 남은 설정 단계를 끝내고 시험 요청으로 실제 동작을 확인하세요.
이 설치 안내는 위에서 설명한 봇 스냅샷 템플릿 적용과 다릅니다. 설치 전 확인은 누락된 값이나 기능을 알려 줍니다. 단계 목록에 완료 표시를 했다는 사실만으로 외부 서비스의 동작이 확인되는 것은 아닙니다.
준비된 솔루션의 성과 지표
설치한 솔루션의 성과를 볼 기간을 선택하세요. 비교할 수 있는 방식을 선택하고 표본 크기와 진단 정보를 확인하세요. 데이터가 부족하거나 비교할 수 없는 상태는 결과가 0인 상태와 다릅니다.
다음 단계
- 설정, 팀, 접근 권한: 봇 동작, 역할, 템플릿, API 토큰.
- 반응: 기초: 봇 동작 구성하기.
- sambot에서 가져오기: 기존 봇 이전하기.
- 결제 및 잔액: 요금제와 봇 수 한도.