Quickstart

가입부터 첫 메시지 아카이브까지의 순서입니다.

1. Workspace 생성

app에서 이메일로 가입하면 workspace·free plan·entitlement가 자동 생성됩니다.

2. Onboarding

• Connector 생성 (platform-managed)
• Telegram Chat ID 또는 @username으로 Source 등록
• 표시되는 Workspace ID 복사

3. Telegram session (로컬 1회)

my.telegram.org에서 API ID / Hash 발급. StringSession:

cd services/collector
.\scripts\generate_session.ps1

4. Railway collector (1회 env)

DEFAULT_WORKSPACE_ID=<your-workspace-uuid>
TG_API_ID=
TG_API_HASH=
TG_SESSION_STRING=
SUPABASE_URL=
SUPABASE_SECRET_KEY=

TG_TARGET_CHATS는 선택 사항. 이후 채널은 앱 Sources에서 추가합니다.

5. 채널 추가

App → Sources. Pause/Delete도 동일 화면. Collector가 ~60초 내 구독 목록 갱신.

6. Processor cron

Live collector → raw_ingest_events. Processor cron(3분) → messages.

7. 확인

App Dashboard → Messages에서 아카이브된 공지를 확인합니다.