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

# Powiadomienia Twitch

> Ogłaszaj na Discordzie, gdy streamer Twitch zaczyna transmisję lub kończy, z w pełni konfigurowalnym embedem.

<Info>
  Wymaga **Basic**. Do **10 streamerów** na serwer. Zobacz [jak działają powiadomienia](/pl/notifications/overview) dla zasad wspólnych wszystkim platformom.
</Info>

## Dodawanie streamera

Szukaj kanału po nazwie — Vetox szuka go na Twitchu i potwierdza, że istnieje, przed dodaniem. Nazwa użytkownika, która się nie rozwiązuje, jest odrzucana z komunikatem **Twitch user not found**.

Nazwy użytkownika mają 1–25 znaków, tylko litery, cyfry i podkreślenia.

## Ustawienia

| Ustawienie                    | Domyślnie      | Uwagi                                                                                      |
| ----------------------------- | -------------- | ------------------------------------------------------------------------------------------ |
| **Discord Channel**           | —              | Wymagane. Ustawiane per streamer, więc różni streamerzy mogą publikować do różnych kanałów |
| **Notify when online**        | **On**         | Ogłoszenie live                                                                            |
| **Notify when offline**       | **Off**        | Drugie ogłoszenie, gdy stream się kończy                                                   |
| **Mention Role**              | Brak           | Pingowana z ogłoszeniem                                                                    |
| **Custom Notification Embed** | Twitch default | Fioletowy, z tytułem streamu, grą i liczbą widzów                                          |

## Zmienne

| Zmienna              | Rozwiązuje się do                                  |
| -------------------- | -------------------------------------------------- |
| `{streamer.name}`    | Nazwa wyświetlana streamera                        |
| `{streamer.url}`     | URL kanału Twitch                                  |
| `{streamer.avatar}`  | Zdjęcie profilowe                                  |
| `{stream.title}`     | Tytuł streamu — **tylko ogłoszenie live**          |
| `{stream.game}`      | Streamowana kategoria — **tylko live**             |
| `{stream.viewers}`   | Liczba widzów w chwili ogłoszenia — **tylko live** |
| `{stream.thumbnail}` | Obraz podglądu streamu — **tylko live**            |

<Warning>
  Cztery zmienne `{stream.*}` nie mają wartości w ogłoszeniu **offline**. Każde pole embedu z nich zbudowane znika z tej wiadomości. Trzymaj embed offline tylko na zmiennych `{streamer.*}`.
</Warning>

## Jak wykrywa się przejście live

Vetox sprawdza co **60 sekund** i śledzi, czy kanał jest live.

<Steps>
  <Step title="Offline → live">
    Ogłoszenie zadziała, z zastrzeżeniem **10-minutowego cooldownu** per streamer.
  </Step>

  <Step title="Wciąż live">
    Nic. Stan jest po prostu odświeżany — długi stream produkuje dokładnie jedno ogłoszenie.
  </Step>

  <Step title="Live → offline">
    Ogłoszenie offline zadziała, jeśli je włączyłeś.
  </Step>
</Steps>

<Warning>
  **Dodanie streamera, który już jest live, nie ogłasza niczego.** Tracker uruchamia się na przejściu, nie na aktualnym stanie. Twoje pierwsze ogłoszenie to będzie jego następny stream.
</Warning>

<Note>
  Stream, który krótko wypada i wraca w oknie cooldownu, produkuje jedno ogłoszenie, nie dwa — jest to celowe i dlatego cooldown wynosi 10 minut, a nie 1.
</Note>

## Konfiguracja w praktyce

<Steps>
  <Step title="Włącz Twitch w Server Setup">
    Domyślnie wyłączony. Nic nie działa, dopóki to nie jest włączone.
  </Step>

  <Step title="Dodaj streamera">
    Wyszukaj nazwę i wybierz z wyników.
  </Step>

  <Step title="Wybierz kanał i rolę">
    Dedykowany kanał `#going-live` i rola `@Stream Ping`, do której członkowie zapisują się przez [Self-Roles](/pl/engagement/self-roles) to wzorzec, na który trafia większość serwerów.
  </Step>

  <Step title="Sprawdź uprawnienia bota tam">
    View Channel, Send Messages i **Embed Links**.
  </Step>

  <Step title="Poczekaj do jego następnego streamu">
    Nie oceniaj tego, dodając kogoś w trakcie streamu.
  </Step>
</Steps>

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Poszli live i nic nie zostało opublikowane">
    Sprawdź przełącznik Twitch w Server Setup, aktywność premium i Embed Links w kanale. Jeśli dodałeś ich, gdy już streamowali, to normalne — poczekaj do następnego streamu.
  </Accordion>

  <Accordion title="Brakuje gry lub liczby widzów">
    Oglądasz ogłoszenie offline. Te zmienne istnieją tylko podczas live.
  </Accordion>

  <Accordion title="Zmiana kanału nie zadziałała">
    Wyczyszczenie pola kanału nic nie wysyła i cicho zachowuje starą wartość. Wybierz inny kanał zamiast czyścić.
  </Accordion>

  <Accordion title="Dwa serwery śledzą tego samego streamera i tylko jeden dostał ping">
    Oba powinny zadziałać. Jeśli uprawnienia jednego kanału zawiodły, ten element jest tracony bez ponowienia — sprawdź Embed Links po stronie zawodzącej.
  </Accordion>
</AccordionGroup>

<Card title="Kick" icon="tower-broadcast" horizontal href="/pl/notifications/kick">
  Ten sam model live/offline na Kick.
</Card>