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

# Сповіщення Twitch

> Оголошуйте в Discord, коли стример Twitch виходить у ефір або завершує стрім, з повністю налаштовуваним embed.

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

## Додавання стримера

Шукайте канал за назвою — Vetox знайде його на Twitch і підтвердить існування перед додаванням. Ім'я користувача, яке не знайдено, відхиляється з **Twitch user not found**.

Імена користувачів — 1–25 символів, лише літери, цифри та підкреслення.

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

| Налаштування                  | За замовчуванням        | Примітки                                                                                           |
| ----------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------- |
| **Discord Channel**           | —                       | Обов'язково. Задається на кожного стримера, тож різні стримери можуть публікуватися в різні канали |
| **Notify when online**        | **Увімкнено**           | Live-оголошення                                                                                    |
| **Notify when offline**       | **Вимкнено**            | Друге оголошення після завершення стріму                                                           |
| **Mention Role**              | Немає                   | Згадується разом з оголошенням                                                                     |
| **Custom Notification Embed** | За замовчуванням Twitch | Фіолетовий, із назвою стріму, грою та кількістю глядачів                                           |

## Змінні

| Змінна               | Значення                                                   |
| -------------------- | ---------------------------------------------------------- |
| `{streamer.name}`    | Ім'я для показу стримера                                   |
| `{streamer.url}`     | URL каналу Twitch                                          |
| `{streamer.avatar}`  | Аватар профілю                                             |
| `{stream.title}`     | Назва стріму — **лише в live-оголошенні**                  |
| `{stream.game}`      | Категорія стріму — **лише в ефірі**                        |
| `{stream.viewers}`   | Кількість глядачів на момент оголошення — **лише в ефірі** |
| `{stream.thumbnail}` | Прев'ю стріму — **лише в ефірі**                           |

<Warning>
  Чотири змінні `{stream.*}` не мають значення в **offline**-оголошенні. Будь-яке поле embed, побудоване з них, зникне з цього повідомлення. Тримайте offline-embed лише на змінних `{streamer.*}`.
</Warning>

## Як виявляється вихід у ефір

Vetox перевіряє кожні **60 секунд** і відстежує, чи канал у ефірі.

<Steps>
  <Step title="Offline → live">
    Спрацьовує оголошення з **10-хвилинним кулдауном** на стримера.
  </Step>

  <Step title="Все ще в ефірі">
    Нічого. Стан просто оновлюється — довгий стрім дасть рівно одне оголошення.
  </Step>

  <Step title="Live → offline">
    Спрацьовує offline-оголошення, якщо ви його ввімкнули.
  </Step>
</Steps>

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

<Note>
  Стрім, який ненадовго обірвався й повернувся в межах вікна кулдауну, дасть одне оголошення, а не два — так задумано, і саме тому кулдаун 10 хвилин, а не 1.
</Note>

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

<Steps>
  <Step title="Увімкніть Twitch у Налаштуванні сервера">
    За замовчуванням він вимкнений. Нічого не працює, поки це не ввімкнено.
  </Step>

  <Step title="Додайте стримера">
    Знайдіть за іменем і оберіть у результатах.
  </Step>

  <Step title="Оберіть канал і роль">
    Виділений канал `#going-live` і роль `@Stream Ping`, на яку учасники підписуються через [Self-Roles](/uk/engagement/self-roles) — типовий патерн, до якого приходять більшість серверів.
  </Step>

  <Step title="Перевірте права бота">
    View Channel, Send Messages і **Embed Links**.
  </Step>

  <Step title="Дочекайтеся наступного стріму">
    Не оцінюйте роботу, додавши когось під час стріму.
  </Step>
</Steps>

## Усунення несправностей

<AccordionGroup>
  <Accordion title="Вийшов у ефір, а нічого не опубліковано">
    Перевірте перемикач Twitch у Налаштуванні сервера, активність преміуму й Embed Links у каналі. Якщо ви додали під час стріму — це очікувано, чекайте наступного.
  </Accordion>

  <Accordion title="Відсутня гра або кількість глядачів">
    Ви дивитесь на offline-оголошення. Ці змінні існують лише в ефірі.
  </Accordion>

  <Accordion title="Зміна каналу не спрацювала">
    Очищення поля каналу нічого не надсилає і мовчки залишає старе значення. Оберіть інший канал замість очищення.
  </Accordion>

  <Accordion title="Два сервери стежать за тим самим стримером, а пінг отримав тільки один">
    Мають спрацьовувати обидва. Якщо права одного каналу не спрацювали, той елемент втрачається без повторної спроби — перевірте Embed Links на проблемному боці.
  </Accordion>
</AccordionGroup>

<Card title="Kick" icon="tower-broadcast" horizontal href="/uk/notifications/kick">
  Та сама модель live/offline на Kick.
</Card>