왜 텔레그램 알림인가?
KimpBee는 진입/청산, 청산 방어, 잔고 경고 등 주요 이벤트를 텔레그램으로 실시간 전송할 수 있습니다. PC 화면을 보고 있지 않아도 운영 상태를 즉시 확인할 수 있어, 자동매매 환경에서 가장 권장되는 알림 채널입니다.
텔레그램 봇 토큰과 Chat ID는 KimpBee가 설치된 내 컴퓨터에만 암호화되어 저장됩니다. 서버로 전송되지 않습니다.
설정 절차
봇 생성 (BotFather)
- 텔레그램에서 @BotFather 를 검색하여 대화를 시작합니다
/newbot을 입력합니다- 봇 이름을 입력합니다 (예:
CT Strategy Alert) - 봇 username을 입력합니다 (예:
ct_strategy_alert_bot) — 반드시bot으로 끝나야 합니다 - 발급된 API 토큰을 복사해 둡니다 (예:
7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxx)
API 토큰은 봇을 제어할 수 있는 비밀키입니다. 외부에 노출되지 않도록 주의하세요.
Chat ID 확인
생성한 봇에 먼저 아무 메시지(예: hi)를 보낸 뒤, 아래 방법 중 하나로 Chat ID를 확인합니다.
방법 A — 브라우저
- 아래 주소를 브라우저에 붙여넣습니다 (
{토큰}자리에 1단계에서 받은 토큰)
https://api.telegram.org/bot{토큰}/getUpdates
- 응답 JSON에서
"chat":{"id":123456789}의 숫자가 Chat ID 입니다
방법 B — @userinfobot (더 간단)
- 텔레그램에서 @userinfobot 을 검색해 대화를 시작합니다
- 봇이 즉시 자신의 Id 를 알려주며, 그 숫자가 Chat ID 입니다
KimpBee에 등록 (권장)
- KimpBee 앱 실행 → 좌측 메뉴 "설정" → "텔레그램 설정" 섹션
- 다음을 입력합니다:
- 봇 토큰: 1단계에서 받은 API 토큰
- Chat ID: 2단계에서 확인한 숫자
- "저장" 후 "테스트 전송"을 눌러 연결을 확인합니다
- 테스트 메시지가 텔레그램으로 오면 설정 완료
UI로 저장하면 토큰/Chat ID가 로컬 데이터 폴더에 AES-256으로 암호화되어 보관됩니다.
(선택) .env 파일로 설정
UI 대신 환경변수로 지정하려면 KimpBee 설치 폴더의 .env 파일에 다음을 추가합니다.
TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxx
TELEGRAM_CHAT_ID=123456789
환경변수로 지정한 값이 암호화 파일보다 우선 적용됩니다. 저장 후 KimpBee를 재시작하세요.
문제 해결
| 증상 | 해결 방법 |
|------|----------|
| 테스트 전송 실패 | 봇 토큰이 정확한지, 봇에게 먼저 아무 메시지라도 보냈는지 확인하세요 |
| getUpdates 응답이 비어 있음 | 생성한 봇과 개인 대화창에서 메시지를 한 번 보낸 뒤 다시 호출하세요 |
| Chat ID가 음수(-100...)로 나옴 | 그룹/채널 Chat ID입니다. 그대로 입력하면 그룹에 알림이 전송됩니다 |
| 알림이 오지 않음 | 설정 저장 후 앱 재시작, 방화벽/네트워크가 api.telegram.org 접근을 차단하지 않는지 확인 |