Telegram connector

Platform-managed collector는 Telethon user session으로 채널 이벤트를 수집합니다.

1회 설정 vs 채널 관리

• 1회 (Railway live): TG_API_ID, TG_API_HASH, TG_SESSION_STRING, TG_SESSION_EXCLUSIVE_OWNER=live, DEFAULT_WORKSPACE_ID
• 채널마다 (앱 Sources): Chat ID 또는 @username — collector가 DB에서 자동 구독
• 세션 공유 금지: 동일 StringSession을 repair/backfill에 넣으면 AuthKeyDuplicated로 키가 폐기됩니다

Chat ID 찾기

• 권장: services/collector/scripts/generate_session.ps1 <username> → -100… 형식 출력
• 또는 Sources에 @username만 등록 (collector가 ID 자동 해석)
• 채널/슈퍼그룹 형식: -100xxxxxxxxxx

StringSession 생성 (로컬, 계정당 1번)

권장: QR PNG — python -m pip install -e ".[qr]" 후 python scripts/generate_session_qr.py → 폰 Devices → Link Desktop Device로 tg_login_qr.png 스캔 (web.telegram.org 안내 무시). 상세: docs/TG_SESSION_SETUP.md

cd services/collector
python -m pip install -e ".[qr]"
python scripts/generate_session_qr.py
# 전화 로그인 대안:
.\scripts\generate_session.ps1
python scripts/generate_session.py fundingfeefutures

UX 라이팅

• 「텔레그램 봇을 추가하세요」→ ❌ (기본 경로 아님)
• 「이미 접근 가능한 채널 ID 또는 @username을 등록하세요」→ ✅
• 「메시지를 보내지 않습니다. 읽기·보존만 합니다」→ ✅
• 「전용 Telegram 계정 사용을 권장합니다」→ ✅

채널 추가·삭제: Managing sources