디스코드 봇 — 치지직·디스코드 채널 한눈 · 명령어
봇이 들어 있는 서버에서는 **관리자가 아닌 일반 멤버**도 아래 명령으로 치지직·디스코드 채널 요약을 볼 수 있어요. 방송 연결 전에도 **치지직 주소(URL)나 채널 ID**만 있으면 치지직 한눈을 쓸 수 있습니다. **같은 서버**의 텍스트 채널이 Oven 방송과 연결돼 있으면, 디스코드 채널 한눈에서 **오늘 후원**도 함께 보여 줍니다.
봇이 서버에 없을 때 (초대)
**치지직 후원 알림만 웹훅으로 받는 경우**에는 봇 초대가 **필수가 아닙니다.** `/help`, `!후원`, `/link_channel`을 쓰려면 서버에 Oven 봇을 넣어야 합니다. 레포에서 `npm run discord:invite-url` 로 초대 링크를 출력한 뒤, 브라우저에서 서버를 선택해 승인하세요. Developer Portal에서 **MESSAGE CONTENT INTENT**를 켜야 `!` 접두사 명령이 동작합니다. 자세한 단계: 저장소 `docs/DISCORD_BOT_INVITE_KO.md`.
한눈이 안 나올 때
한눈이 안 나올 때 — 주소·채널 ID 오타가 없는지 확인하고, **8초 정도** 기다린 뒤 다시 시도해 보세요. **치지직·디스코드 한눈**은 API와 봇에 동일한 **`DONATION_INGEST_SECRET`** 이 있어야 합니다. 계속되면 스트리머나 서버 운영자에게 알려 주세요.
치지직 한눈 — 슬래시와 접두사
슬래시(`/`)는 디스코드가 자동 완성을 보여 줍니다. 접두사는 아래 문구를 **메시지 맨 앞**에 그대로 붙여 넣으면 됩니다.
| 종류 | 명령 | 설명 | 예시 |
|---|---|---|---|
| 슬래시 | /chzzk_glance | `channel`에 ID 또는 프로필·라이브 URL — 채널에 임베드로 공개 | /chzzk_glance channel:https://chzzk.naver.com/live/여기에채널ID |
| 접두사 | !치지직한눈 | 붙여 쓴 형태, 뒤에 한 칸 띄우고 질의 | !치지직한눈 https://chzzk.naver.com/live/여기에채널ID |
| 접두사 | !치지직 한눈 | 띄어쓰기 있는 형태 | !치지직 한눈 여기에채널ID |
| 접두사 | !치지직 | 짧은 한글 접두사 | !치지직 여기에채널ID |
| 접두사 | !chzzk | 영문 접두사(대소문자 무관) | !chzzk 여기에채널ID |
디스코드 텍스트 채널 한눈
**같은 서버**의 텍스트·공지·스레드 채널을 지정하면, 봇이 읽을 수 있는 범위에서 **최근 디스코드 메시지**와, Oven 방송이 연결돼 있으면 **오늘 후원**을 함께 보여 줍니다. 대상 채널에서 봇 역할에 **채널 보기·메시지 기록 읽기**가 있어야 합니다.
| 종류 | 명령 | 설명 | 예시 |
|---|---|---|---|
| 슬래시 | /discord_channel_glance | `channel`에 `<#…>` · 숫자 ID · discord.com 채널 URL · `#채널이름`(캐시 일치) | /discord_channel_glance channel:#일반 |
| 접두사 | !디코한눈 | 짧은 한글 접두사 | !디코한눈 <#123456789012345678> |
| 접두사 | !디스코드한눈 | 한글 전체 표기 | !디스코드한눈 https://discord.com/channels/0/123456789012345678 |
| 접두사 | !discord_glance | 영문 밑줄(대소문자 무관) | !discord_glance 123456789012345678 |
| 접두사 | !discordglance | 영문 붙여 쓴 형태 | !discordglance <#123456789012345678> |
시장 인텔 (연결된 채널만)
**이 디스코드 텍스트 채널**에 `!채널연결` 또는 **마스터 채널 멤버**로 묶인 스트리머만, 일별 치즈(후원) 요약을 볼 수 있습니다. 전역·무관 채널로 알림이 가지 않습니다. 웹에서는 **대시보드·전체 관리자** 화면에서도 같은 데이터를 조회할 수 있습니다.
| 종류 | 명령 | 설명 | 예시 |
|---|---|---|---|
| 슬래시 | /market_daily | 선택 `source` · `view` · `tag`(vtuber/cam/other, Bench 등록 채널). Top10 / 요약 / 내 순위 | /market_daily tag:vtuber view:summary |
| 슬래시 | /market_week | 최근 7일 주간 — `/market_daily`와 동일 옵션 | /market_week tag:cam view:top10 |
| 접두사 | !시장 | 접두사 — `!시장 vtuber summary` · `!시장 me` · `!시장 lives_ws_sample me` | !시장 vtuber summary |
| 접두사 | !market | 영문 접두사 | !market summary |
| 접두사 | !시장주간 | 주간 접두사 — `!시장주간` · `!market_week cam top10` | !market_week other summary |
최고 운영자 슬래시 (`DISCORD_SUPER_OPERATOR_USER_IDS`)
아래 명령은 **API(Railway)** 와 **discord-bot** 모두에 `DISCORD_SUPER_OPERATOR_USER_IDS`(디스코드 **숫자 사용자 ID**)와 동일한 `DONATION_INGEST_SECRET`이 있어야 합니다. 일반 서버 멤버는 사용할 수 없습니다.
| 종류 | 명령 | 설명 | 예시 |
|---|---|---|---|
| 슬래시 | /service_status | 전체 서비스 현황 — shadow·bridge·후원·ingest 모니터 수 | /service_status |
| 슬래시 | /ops_pipeline | 마스터 멤버 도네 파이프라인 점검(수집 경로·24h 브리지·웹훅) | /ops_pipeline |
| 슬래시 | /ops_linked_overview | 전역 디스코드↔방송 연결 수 | /ops_linked_overview |
| 슬래시 | /ops_streamer_donations | 스트리머 후원 합계 — 필수 `channel_id`(Oven UUID 또는 치지직 ID) | /ops_streamer_donations channel_id:여기에채널ID |
| 슬래시 | /ops_alerts_pause | 스트리머 디스코드 후원 알림 on/off — `channel_id` + `paused` | /ops_alerts_pause channel_id:여기에채널ID paused:true |
쿨다운
같은 사용자는 약 **8초에 한 번**만 치지직·디스코드 채널 한눈·**시장 인텔**을 요청할 수 있습니다. 스팸·과부하 방지용입니다.
전체 도움말
서버 채팅에서 `/help` 또는 `!도움말`·`!명령어`로 후원·연결 등 다른 명령도 확인할 수 있습니다. 봇이 **다시 시작**될 때 짧은 안내가 올 수 있는데 정상이며, 끄려면 서버 운영자에게 문의하세요.
스트리머·연결
디스코드 텍스트 채널을 Oven 방송에 붙이는 코드·후원 등록은 스트리머 가이드와 웹 관리 화면을 함께 보세요. **OBS 주간 랭킹·오늘 MVP**는 봇 명령이 아니라 **설정 → OBS URL** 발급 시 함께 나오는 `leaderboard.html` 브라우저 소스입니다. 대시보드의 후원 랭킹 표와 같은 집계를 씁니다. 스트리머 가이드 → · LoL 티어 인증방 →