시청자용 이용 가이드

1. 방송 화면에 나오는 벽지·MVP란?

스트리머가 OBS에 넣어 둔 추가 화면입니다.

• 벽지 — 그날 후원 중에서 고른 항목이 계속 보입니다.
• 오늘의 MVP — 그날 누적 후원이 가장 큰 닉네임을 보여 줍니다.

시청자는 그냥 보시면 됩니다. 설치할 것은 없습니다.

2. 시청자가 할 수 있는 것: 도네 알림을 내 디스코드로

특정 방송의 후원 소식을 내 디스코드 채널로 받고 싶을 때 쓰는 기능입니다. **현재(테스트 운영)** 는 등록된 Oven 채널이면 웹훅만 맞으면 구독할 수 있습니다.

이건 결제나 정산과 무관한 알림만 받는 설정입니다.

2.0 웹에서 구독하기 (권장)

대부분은 아래 **웹 페이지**에서 채널 ID·웹훅만 넣으면 등록·목록·해지까지 할 수 있어요. curl 없이 시작하는 방법을 권장합니다.

도네 알림 구독 페이지로 이동

2.1 준비물 (개발자·자동화용 API)

• 방송 채널 ID — Oven에서 쓰는 UUID이거나, 연동 플랫폼(예: 치지직 URL 경로)의 채널 식별자입니다. 네이버 로그인 ID와 다릅니다. 모르면 방송인에게 물어보세요.
• 디스코드 웹훅 URL — 알림을 받을 채널에서 만든 웹훅 주소입니다.

2.2 웹훅 만드는 법 (디스코드)

1. 알림을 받을 채널로 갑니다.
2. 채널 설정 → 연동 → 웹후크 → 새 웹후크.
3. 이름을 정하고, 웹후크 URL 복사를 눌러 주소를 저장합니다.

2.3 구독 등록 (API 예시)

방송인이 허용한 뒤, 아래처럼 한 번 호출하면 됩니다. 서비스API주소는 운영자/스트리머가 알려 주는 주소로 바꿉니다.

curl -X POST "https://서비스API주소/v1/donations/subscriptions" \
  -H "Content-Type: application/json" \
  -d '{"channelId":"방송채널ID","webhookUrl":"여기에_웹훅_URL","label":"메모"}'

• channelId — 구독할 방송의 채널 ID(Oven에서 쓰는 값). 스트리머에게 문의하세요.
• webhookUrl — 위에서 복사한 디스코드 웹훅.
• label — (선택) 나중에 구분할 메모.

성공하면 그 채널에 후원이 들어올 때마다 디스코드로 알림이 전달됩니다.

2.4 빠르게 확인하는 순서

1. 방송 채널 ID가 Oven에 등록된 값인지 방송인·운영자에게 확인합니다.
2. 웹훅을 만들고 URL을 복사합니다.
3. 위 POST로 구독을 등록합니다.
4. 테스트 후원이 한 번 들어오면 내 채널에 알림이 오는지 봅니다.

2.5 구독 끊기

구독 목록에서 ID를 확인한 뒤, 아래처럼 삭제하면 해지됩니다.

curl -X DELETE "https://서비스API주소/v1/donations/subscriptions/구독ID"

3. 잘 안 될 때 — 이렇게 확인해 보세요

• 등록이 안 된다 → 채널 ID를 스트리머에게 다시 확인하고, 웹훅 URL이 디스코드에서 복사한 **https** 주소인지 봐 주세요.
• 등록은 됐는데 알림이 없다 → 그 방송에 아직 후원이 없을 수 있어요. 테스트 후원이 있는지 스트리머에게 물어보세요.
• 디스코드에 안 온다 → 웹훅 오타, 삭제된 웹훅, 알림 채널 권한을 순서대로 확인하세요.

4. 주의사항

• 구독 정책은 배포·운영 방식에 따라 달라질 수 있습니다. 등록 전 채널 ID를 꼭 확인하세요.
• 웹훅 URL은 비밀번호처럼 다루세요. 노출되면 다른 사람이 같은 채널로 보낼 수 있습니다.
• 구독은 알림용이며, 후원 결제·정산과는 별개입니다.
• 익명 후원은 플랫폼 정책상 누구인지까지 안 내려올 수 있습니다.

5. 요약 표

API 주소·세부 정책은 서비스 제공 측 안내를 따르세요.