> ## 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

> Оголошуйте нові завантаження та live-стріми YouTube на своєму сервері Discord.

<Info>
  Потрібен **Basic**. До **10 каналів** на сервер. Загальні правила див. у [Як працюють сповіщення](/uk/notifications/overview).
</Info>

## Додавання каналу

Пошук за назвою каналу. Vetox зіставляє його з channel ID; канал, який не знайдено, відхиляється з **YouTube channel not found**.

## Налаштування

| Налаштування                  | За замовчуванням         | Примітки    |
| ----------------------------- | ------------------------ | ----------- |
| **Discord Channel**           | —                        | Обов'язково |
| **Notify on upload**          | **Увімкнено**            | Нові відео  |
| **Notify on live**            | **Увімкнено**            | Live-стріми |
| **Mention Role**              | Немає                    |             |
| **Custom Notification Embed** | За замовчуванням YouTube | Червоний    |

<Warning>
  Вимкнення **обох** перемикачів зберігається без нарікань і гарантує, що канал ніколи нічого не оголошуватиме. Попередження для цього стану немає.
</Warning>

## Змінні

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

## Як знаходиться новий контент

Перевіряється кожні **5 хвилин** з **10-хвилинним кулдауном** на канал. Vetox читає стрічку каналу і щоразу розглядає **5 найновіших** записів.

<Note>
  Канал, що публікує більше 5 відео в межах одного 5-хвилинного вікна, може «загубити» найдавніші з них.
</Note>

<Warning>
  **Заплановану прем'єру оголошено як завантаження**, з відповідним формулюванням, а не як live. Якщо ваш embed каже «went live», прем'єра прочитається неправильно.
</Warning>

## Реальне налаштування

<Steps>
  <Step title="Увімкніть YouTube у Налаштуванні сервера" />

  <Step title="Додайте канал за назвою" />

  <Step title="Розділіть завантаження й стріми, якщо хочете різні формулювання">
    Не можна направити завантаження і live-стріми в різні канали 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="/uk/notifications/twitch">
  Live-стрімінг із миттєвим відстеженням стану.
</Card>