> ## 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 каналов** на сервер. См. [как работают уведомления](/ru/notifications/overview) для общих правил.
</Info>

## Добавление канала

Ищите по имени канала. Vetox привязывает его к channel ID; нераспознаваемый канал отклоняется с ошибкой **YouTube channel not found**.

## Настройки

| Настройка                     | По умолчанию    | Примечания  |
| ----------------------------- | --------------- | ----------- |
| **Discord Channel**           | —               | Обязательно |
| **Notify on upload**          | **Вкл**         | Новые видео |
| **Notify on live**            | **Вкл**         | Стримы      |
| **Mention Role**              | Нет             |             |
| **Custom Notification Embed** | YouTube default | Красный     |

<Warning>
  Отключение **обоих** переключателей сохраняется без нареканий и гарантирует, что канал никогда не объявит ничего. Предупреждения об этом состоянии нет.
</Warning>

## Переменные

| Переменная          | Разворачивается в      |
| ------------------- | ---------------------- |
| `{channel.name}`    | Имя канала             |
| `{channel.avatar}`  | Аватар канала          |
| `{video.title}`     | Название видео         |
| `{video.url}`       | URL видео              |
| `{video.thumbnail}` | Миниатюра видео        |
| `{video.type}`      | Загрузка это или стрим |

## Как ищется новый контент

Проверка каждые **5 минут**, с **10-минутным кулдауном** на канал. Vetox читает ленту канала и рассматривает **5 самых свежих** записей каждый раз.

<Note>
  Канал, публикующий больше 5 видео за одно 5-минутное окно, может пропустить самое старое из них.
</Note>

<Warning>
  **Запланированная премьера объявляется как загрузка**, с формулировкой загрузки, а не эфира. Если ваш embed говорит "went live", премьера будет прочитана некорректно.
</Warning>

## Настройка на практике

<Steps>
  <Step title="Включите YouTube в настройках сервера" />

  <Step title="Добавьте канал по имени" />

  <Step title="Разделите загрузки и стримы, если нужны разные формулировки">
    Нельзя направить загрузки и стримы в разные каналы Discord для одного канала YouTube — один канал на запись. Используйте `{video.type}` в embed, чтобы их различать.
  </Step>

  <Step title="Проверьте Embed Links в целевом канале" />
</Steps>

## Устранение неполадок

<AccordionGroup>
  <Accordion title="Новое видео не объявлено">
    Сначала проверьте переключатель в настройках сервера и премиум. Затем убедитесь, что включён хотя бы один из двух переключателей notify. Если видео старше 2 часов — оно намеренно пропускается.
  </Accordion>

  <Accordion title="Премьера объявлена как обычная загрузка">
    Ожидаемо — премьеры классифицируются как загрузки.
  </Accordion>

  <Accordion title="Объявляются Shorts, а мне не нужно">
    Фильтра для исключения Shorts нет. Всё в ленте канала обрабатывается одинаково.
  </Accordion>

  <Accordion title="Объявления запаздывают до пяти минут">
    Это интервал опроса. YouTube проверяется каждые 5 минут, а не мгновенно.
  </Accordion>
</AccordionGroup>

<Card title="Twitch" icon="twitch" horizontal href="/ru/notifications/twitch">
  Стриминг с мгновенным отслеживанием состояния.
</Card>
