Telegram connection guide

텔레그램 알림 연결 가이드

개인 deep link로 계정과 Telegram chat_id를 매핑하고, 연결 확인 후 리포트 시간을 저장하는 흐름입니다.

Deep link shape
https://t.me/YourBot?start=USER_LINK_TOKEN

링크 토큰은 사용자를 식별하는 원문 ID가 아니라 서버가 검증할 수 있는 서명 payload로 관리합니다.

Connection flow

연결은 네 단계로 끝납니다.

Step 01

알림 설정 열기

로그인 후 알림 화면에서 현재 봇 준비 상태와 리포트 시간을 확인합니다.

Step 02

개인 링크 생성

텔레그램 알림 연결 버튼을 누르면 사용자 계정에 서명된 deep link가 만들어집니다.

Step 03

Telegram에서 Start

열린 봇 화면에서 Start를 누르면 `/start <link_token>` 형태로 서버에 전달됩니다.

Step 04

연결 확인

웹 화면으로 돌아와 연결 확인을 누르면 user_id와 chat_id 매핑 상태를 갱신합니다.

Notification tiers

티어별 알림/리포트 매트릭스

연결은 활성 계정이면 허용하고, 알림 종류와 리포트 깊이/빈도는 티어별로 차등 적용합니다.

phase4-day25-2026-05-09

Free

일반
연결
연결 가능
알림
연결 상태, 주간 요약 준비 알림
리포트
주간 요약 리포트 · 주 1회

총자산 변화, BTC 보유량, 최근 주요 상태만 간단히 확인합니다.

Gold

골드
연결
연결 가능
알림
거래 체결, 일간 리포트, 리스크 기준 알림
리포트
일간 요약 리포트 · 일 1회

체결 요약, 현금 보유율, MDD, 운용금 기준 성과를 함께 제공합니다.

VIP

VIP/어드민
연결
연결 가능
알림
거래/리스크/전략 이벤트, 이상 징후 즉시 알림
리포트
일간 리포트 + 전략 인사이트 · 일 1회 + 중요 이벤트 즉시

전략별 성과, drawdown 해석, 다음 리밸런싱 후보까지 확장합니다.

Status labels

화면의 상태 문구를 이렇게 읽으면 됩니다.

봇 토큰 미설정

운영 서버에 Telegram bot token이 없으면 링크 생성 버튼을 사용할 수 없습니다.

연결 필요

봇은 준비됐지만 아직 Telegram Start 메시지가 확인되지 않은 상태입니다.

연결 완료

계정별 chat_id가 저장되어 일간 리포트와 알림을 받을 수 있는 상태입니다.

Troubleshooting

연결이 막히면 이 순서로 확인합니다.

링크 생성이 되지 않음

서버의 Telegram bot token과 bot username 확인이 먼저 필요합니다.

Start를 눌렀는데 연결 확인이 실패함

Telegram 앱에서 봇 채팅을 다시 열어 Start를 누른 뒤 몇 초 후 연결 확인을 다시 실행합니다.

다른 Telegram 계정으로 바꾸고 싶음

알림 설정에서 연결 해제를 누른 뒤 새 계정으로 개인 링크를 다시 엽니다.

리포트 시간이 맞지 않음

알림 설정에서 리포트 시간을 저장하면 다음 전송부터 새 시간이 적용됩니다.