> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube 알림

> 새 YouTube 업로드와 라이브 스트림을 Discord 서버에 알립니다.

<Info>
  **Basic**이 필요합니다. 서버당 최대 **10개 채널**. 공통 규칙은 [알림 작동 방식](/ko/notifications/overview)을 참고하세요.
</Info>

## 채널 추가

채널 이름으로 검색합니다. Vetox가 이를 채널 ID로 해석합니다; 해석 불가능한 채널은 **YouTube channel not found**로 거절됩니다.

## 설정

| 설정                            | 기본값        | 설명      |
| ----------------------------- | ---------- | ------- |
| **Discord Channel**           | —          | 필수      |
| **Notify on upload**          | **켬**      | 새 영상    |
| **Notify on live**            | **켬**      | 라이브 스트림 |
| **Mention Role**              | 없음         |         |
| **Custom Notification Embed** | YouTube 기본 | 빨강      |

<Warning>
  **두 토글을 모두** 끄면 아무 경고 없이 저장되며 그 채널은 절대 알림하지 않게 됩니다. 이 상태에 대한 경고는 없습니다.
</Warning>

## 변수

| 변수                  | 해석              |
| ------------------- | --------------- |
| `{channel.name}`    | 채널 이름           |
| `{channel.avatar}`  | 채널 아바타          |
| `{video.title}`     | 영상 제목           |
| `{video.url}`       | 영상 URL          |
| `{video.thumbnail}` | 영상 썸네일          |
| `{video.type}`      | 업로드인지 라이브 스트림인지 |

## 새 콘텐츠 감지 방식

**5분마다** 확인하며 채널당 **10분 쿨다운**을 적용합니다. Vetox는 채널의 피드를 읽고 매번 **가장 최근 5개** 항목을 고려합니다.

<Note>
  하나의 5분 창 안에 5개 이상의 영상을 게시하는 채널은 그중 가장 오래된 것이 누락될 수 있습니다.
</Note>

<Warning>
  **예약된 프리미어는 업로드로 알림됩니다**, 라이브 문구가 아닌 업로드 문구가 사용됩니다. 임베드가 "went live"라고 되어 있다면 프리미어에서는 잘못 읽힙니다.
</Warning>

## 실제 설정 예

<Steps>
  <Step title="서버 설정에서 YouTube 켜기" />

  <Step title="이름으로 채널 추가" />

  <Step title="문구를 다르게 하려면 업로드와 스트림을 분리">
    같은 YouTube 채널에서 업로드와 라이브 스트림을 서로 다른 Discord 채널로 라우팅할 수는 없습니다 — 항목당 채널 하나입니다. 대신 임베드에서 `{video.type}`을 사용해 구분하세요.
  </Step>

  <Step title="대상 채널의 Embed Links 확인" />
</Steps>

## 문제 해결

<AccordionGroup>
  <Accordion title="새 영상이 알림되지 않았어요">
    먼저 서버 설정 토글과 프리미엄을 확인하세요. 그 다음 두 알림 토글 중 최소 하나가 켜져 있는지 확인하세요. 영상이 2시간 이상 지난 것이라면 의도적으로 건너뜁니다.
  </Accordion>

  <Accordion title="프리미어가 일반 업로드로 알림됐어요">
    예상된 동작입니다 — 프리미어는 업로드로 분류됩니다.
  </Accordion>

  <Accordion title="Shorts가 알림되는데 원치 않아요">
    Shorts를 제외하는 필터는 없습니다. 채널 피드의 모든 항목이 동일하게 처리됩니다.
  </Accordion>

  <Accordion title="알림이 최대 5분 늦어요">
    이것이 폴링 간격입니다. YouTube는 즉시가 아니라 5분마다 확인됩니다.
  </Accordion>
</AccordionGroup>

<Card title="Twitch" icon="twitch" horizontal href="/ko/notifications/twitch">
  즉시 상태 추적이 되는 라이브 스트리밍.
</Card>