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

# Jak działają powiadomienia

> Ogłaszaj nowe streamy, filmy, posty i odcinki z ośmiu zewnętrznych platform bezpośrednio na swoim serwerze Discord.

Vetox obserwuje osiem zewnętrznych platform i publikuje ogłoszenie na Twoim serwerze, gdy tylko pojawia się coś nowego.

<CardGroup cols={4}>
  <Card title="Twitch" icon="twitch" href="/pl/notifications/twitch" />

  <Card title="Kick" icon="tower-broadcast" href="/pl/notifications/kick" />

  <Card title="YouTube" icon="youtube" href="/pl/notifications/youtube" />

  <Card title="Reddit" icon="reddit" href="/pl/notifications/reddit" />

  <Card title="Bluesky" icon="cloud" href="/pl/notifications/bluesky" />

  <Card title="Steam" icon="steam" href="/pl/notifications/steam" />

  <Card title="RSS" icon="rss" href="/pl/notifications/rss" />

  <Card title="Podcasty" icon="podcast" href="/pl/notifications/podcasts" />
</CardGroup>

## Trzy rzeczy muszą być prawdą

To zdecydowanie najczęstszy powód, dla którego powiadomienia wydają się nie działać. Wszystkie trzy są wymagane, a tylko pierwsza jest widoczna na samej stronie powiadomień.

<Steps>
  <Step title="Premium Basic lub wyższe">
    Każda platforma wymaga co najmniej poziomu **Basic**. Dodanie subskrypcji na Starterze jest odrzucane z komunikatem nazywającym platformę.

    Sprawdzenie działa dwukrotnie — raz przy dodawaniu elementu, a drugi raz w chwili, gdy ogłoszenie miałoby zostać wysłane.
  </Step>

  <Step title="Przełącznik platformy w Server Setup">
    Każda platforma ma własny przełącznik na stronie [Server Setup](/pl/server-management/setup) i jest **domyślnie wyłączony**. Konfigurowanie samego powiadomienia to za mało.

    <Warning>
      Żadna strona powiadomień nie pokazuje stanu tego przełącznika. W pełni skonfigurowany, opłacony premium feed nigdy cicho się nie uruchomi, bez wskazówki gdziekolwiek w UI powiadomień. **Sprawdź najpierw Server Setup.**
    </Warning>
  </Step>

  <Step title="Uprawnienia kanału">
    Vetox potrzebuje **View Channel**, **Send Messages** i **Embed Links** w kanale docelowym. Zobacz poniżej.
  </Step>
</Steps>

## Limity

**10 elementów na platformę, na serwer** — 10 streamerów Twitch, 10 kanałów YouTube, 10 subredditów itd.

To sztywny limit produktu. **Nie** rośnie z wyższym poziomem premium i jest taki sam na Basic, Max i Black.

## Jak szybko dochodzą powiadomienia

Vetox odpytuje każdą platformę według stałego harmonogramu. Ogłoszenie dociera przy następnym odpytaniu po pojawieniu się treści.

| Platforma | Sprawdzane co | Cooldown per źródło |
| --------- | ------------- | ------------------- |
| Twitch    | 60 sekund     | 10 minut            |
| Kick      | 60 sekund     | 10 minut            |
| Bluesky   | 60 sekund     | 2 minuty            |
| Reddit    | 3 minuty      | 2 minuty            |
| Steam     | 3 minuty      | 2 minuty            |
| YouTube   | 5 minut       | 10 minut            |
| RSS       | 5 minut       | 5 minut             |
| Podcasty  | 5 minut       | 5 minut             |

**Cooldown** to podłoga między dwoma ogłoszeniami dla tego samego źródła, niezależna od interwału odpytywania. Subreddit publikujący trzy razy w ciągu minuty produkuje jedno ogłoszenie, nie trzy.

<Note>
  Odpytywanie robi pojedyncza wybrana instancja, więc zajęty serwer nigdy nie otrzymuje duplikatów od równoległych workerów.
</Note>

### Dwa różne modele śledzenia

| Model          | Platformy       | Zachowanie                                                                       |
| -------------- | --------------- | -------------------------------------------------------------------------------- |
| **Stan live**  | Twitch, Kick    | Śledzi, czy stream jest live czy offline, i ogłasza w chwili *zmiany* tego stanu |
| **Nowa treść** | Pozostałe sześć | Śledzi pojedyncze elementy i ogłasza każdy nowy raz                              |

<Warning>
  **Dodanie streamera, który już jest live, nic nie daje.** Tracker stanu live uruchamia się tylko przy przejściu offline → online. Jeśli dodasz kogoś w trakcie streamu, pierwsze ogłoszenie, jakie dostaniesz, to *następny* stream.

  Testuj z kimś, kto jest obecnie offline, albo po prostu poczekaj.
</Warning>

<Note>
  Stan live/offline jest śledzony **per streamer, nie per serwer**. Jeśli kilka serwerów śledzi tego samego streamera, są napędzane z jednego wspólnego stanu.
</Note>

## Co nie zostanie ogłoszone

<AccordionGroup>
  <Accordion title="Cokolwiek opublikowanego przed dodaniem" icon="clock-rotate-left">
    Dodanie subskrypcji nigdy nie uzupełnia wstecz. Ogłaszana jest tylko treść opublikowana po dodaniu elementu, aby Twój kanał nie był zalewany podczas konfiguracji.
  </Accordion>

  <Accordion title="Treść starsza niż 2 godziny" icon="hourglass-end">
    Dla sześciu platform treściowych wszystko opublikowane ponad 2 godziny temu jest ignorowane, nawet jeśli Vetox nigdy tego nie widział. Zapobiega to zrzucaniu zaległości po awarii.

    Element, którego feed nie dostarcza czytelnej daty publikacji, omija to sprawdzenie i może być ogłoszony niezależnie od wieku. Sporadycznie to przyczyna, że pojawia się stary element RSS.
  </Accordion>

  <Accordion title="Ten sam element dwukrotnie" icon="copy">
    Każdy ogłoszony element jest pamiętany przez **7 dni**, per serwer, więc restart lub wolne odpytywanie nie mogą wytworzyć duplikatu. Dwa serwery śledzące ten sam feed każdy dostaje własną kopię — jeden serwer widząc element nie tłumi go dla innego.
  </Accordion>

  <Accordion title="Odpowiedzi i reposty Bluesky" icon="reply">
    Ogłaszane są tylko oryginalne posty. Odpowiedzi i reposty są filtrowane dwukrotnie. **Quote posty nie są filtrowane** i zostaną ogłoszone.
  </Accordion>

  <Accordion title="Cokolwiek, co przyszło, gdy premium wygasło" icon="triangle-exclamation">
    Element widziany, gdy Twoje premium jest nieaktywne, jest oznaczony jako widziany przez 7 dni, mimo że nic nie zostało opublikowane. Upgrade nie ogłasza go wstecznie.

    Po reaktywacji premium spodziewaj się cichego okresu, dopóki nie pojawi się prawdziwie nowa treść.
  </Accordion>
</AccordionGroup>

## Uprawnienia Discord

Sprawdzane na żywo w kanale docelowym w chwili wysyłania:

| Uprawnienie       | Dlaczego                                                                                                         |
| ----------------- | ---------------------------------------------------------------------------------------------------------------- |
| **View Channel**  | Vetox nie może publikować w kanale, którego nie widzi                                                            |
| **Send Messages** | Aby opublikować ogłoszenie                                                                                       |
| **Embed Links**   | Każde powiadomienie to embed. Bez tego wiadomość jest odrzucana wprost, nawet jeśli Send Messages jest przyznane |

<Warning>
  **Awaria uprawnień trwale traci ten element.** Element jest oznaczany jako widziany przed próbą wysłania i nie ma ponowienia. Napraw uprawnienia *przed* publikacją treści, na której Ci zależy — nie po.
</Warning>

<Tip>
  Jeśli kanał ma niestandardowe nadpisania uprawnień, sprawdź *efektywne* uprawnienia bota tam, a nie jego rolę na poziomie serwera. Embed Links to to, którego najczęściej brakuje.
</Tip>

## Dostosowywanie ogłoszenia

| Opcja               | Co robi                                                                                                                     |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Discord channel** | Gdzie publikowane jest ogłoszenie. Ustawiane per śledzony element, więc różni streamerzy mogą publikować do różnych kanałów |
| **Mention role**    | Rola pingowana z ogłoszeniem                                                                                                |
| **Custom embed**    | Pełna kontrola nad tytułem, opisem, kolorem, autorem, stopką, miniaturą, obrazem i polami                                   |
| **Custom message**  | Zwykły tekst używany jako treść embedu. **Dostępne tylko dla RSS i Podcastów**                                              |

<Note>
  Kontrolka niestandardowej wiadomości pojawia się tylko na stronach RSS i Podcast. Pozostałe sześć platform używa zamiast tego niestandardowego embedu.
</Note>

### Limity rozmiaru embedu

| Pole                   | Limit                        |
| ---------------------- | ---------------------------- |
| Tytuł                  | 256 znaków                   |
| Opis                   | 4 096 znaków                 |
| Nazwa autora           | 256 znaków                   |
| Tekst stopki           | 2 048 znaków                 |
| Pola                   | 25, każde 256 / 1 024 znaków |
| URL obrazu i miniatury | 500 znaków, bez SVG          |

### Zmienne

Pola embedu i wiadomości obsługują zmienne w klamrach, jak `{streamer.name}`. Każda platforma ma swój zestaw, wypisany na jej stronie.

<Warning>
  **Nieznana zmienna staje się pustym tekstem, a nie błędem.** A pole embedu, którego tytuł lub wartość okazuje się puste, jest usuwane z wiadomości w całości.

  Więc pole, które ciągle znika, prawie zawsze oznacza źle napisaną zmienną albo taką, która nie istnieje dla tej platformy. Sprawdź nazwę na liście na stronie platformy — rozwijana lista w edytorze jest wiążąca.
</Warning>

<Note>
  Zmienne streamu Twitch i Kick (`{stream.title}`, `{stream.viewers}` itd.) istnieją tylko w ogłoszeniu **live**. Użyte w embedzie offline rozwiązują się do niczego, a ich pole znika.
</Note>

## Wzmianki

Rola wzmianki, którą konfigurujesz, jest pingowana normalnie.

<Warning>
  Wzmianki w embedzie powiadomienia **nie** są ograniczone do skonfigurowanej roli. Wzmianka roli lub użytkownika wpisana w niestandardową wiadomość lub treść embedu zapinguje. Uważaj z `@everyone` w niestandardowym szablonie.
</Warning>

## Dwa ustawienia, których nie można zmienić

<Note>
  **Główny przełącznik włączania** i **kolor embedu** każdej platformy są przechowywane, ale nie mają działającej kontrolki w panelu. Każda platforma używa swojego domyślnego koloru brandu, a głównego przełącznika nie da się przełączyć.

  Użyj przełącznika w [Server Setup](/pl/server-management/setup), aby wyłączyć platformę, i niestandardowego embedu, aby ustawić kolor.
</Note>

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Nic w ogóle nie jest publikowane">
    Po kolei:

    1. Przełącznik platformy w **Server Setup** jest włączony — domyślnie wyłączony i niewidoczny stąd
    2. Serwer ma aktywne premium **Basic** lub wyższe
    3. Kanał docelowy wciąż istnieje
    4. Vetox ma tam **View Channel + Send Messages + Embed Links**
    5. Dla Twitch i Kick — streamer poszedł offline i wrócił od momentu dodania
  </Accordion>

  <Accordion title="Otrzymuję ogłoszenie live, ale nie offline">
    Ogłoszenia offline są **domyślnie wyłączone** na Twitch i Kick. Włącz je na śledzonym streamerze.
  </Accordion>

  <Accordion title="Pole embed ciągle znika">
    Jego tytuł lub wartość rozwiązała się do pustego i pole zostało odrzucone. Prawie zawsze źle napisana lub niewłaściwa dla platformy zmienna.
  </Accordion>

  <Accordion title="Nie mogę dodać jedenastego elementu">
    Dziesięć na platformę to maksimum i nie skaluje się z poziomem. Najpierw usuń jeden.
  </Accordion>

  <Accordion title="Działało, potem przestało po wygaśnięciu premium">
    Konfiguracja jest zachowywana, nie usuwana, i wznawia automatycznie. Ale wszystko opublikowane podczas przerwy jest już oznaczone jako widziane i nie zostanie ogłoszone wstecznie.
  </Accordion>

  <Accordion title="Wyczyszczenie kanału na streamerze Twitch lub Kick nic nie dało">
    Opróżnione pole kanału nie jest wysyłane, więc poprzedni kanał jest zachowywany bez błędu. Zamiast czyścić, wybierz inny kanał.
  </Accordion>
</AccordionGroup>