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

> Ogłaszaj nowe elementy z dowolnego kanału RSS lub Atom na swoim serwerze Discord.

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

RSS to uniwersalny wybór. Jeśli strona publikuje feed, Vetox może to ogłaszać — blogi, changelogi, strony informacyjne, sekcje forum, notatki wydań.

## Dodawanie feeda

Wklej URL feeda. Vetox pobiera i parsuje go przed zapisem; wszystko, co nie jest czytelnym feedem, jest odrzucane z komunikatem **Invalid RSS feed URL or unable to parse feed**.

<Tip>
  Użyj URL feeda, nie URL strony. Zwykle kończy się na `/feed`, `/rss`, `/atom.xml` lub `/index.xml`. Jeśli nie masz pewności, zobacz źródło strony i poszukaj linku `application/rss+xml`.
</Tip>

## Ustawienia

| Ustawienie                    | Domyślnie   | Uwagi                                                                       |
| ----------------------------- | ----------- | --------------------------------------------------------------------------- |
| **Discord Channel**           | —           | Wymagane                                                                    |
| **Notify on New Items**       | **On**      |                                                                             |
| **Custom Message**            | Brak        | Zwykły tekst, do 2 000 znaków — jedna z tylko dwóch platform, które to mają |
| **Mention Role**              | Brak        |                                                                             |
| **Custom Notification Embed** | RSS default | Pomarańczowy                                                                |

## Zmienne

| Zmienna              | Rozwiązuje się do               |
| -------------------- | ------------------------------- |
| `{item.title}`       | Tytuł elementu                  |
| `{item.url}`         | Link do elementu                |
| `{item.description}` | Podsumowanie lub treść elementu |
| `{item.author}`      | Autor                           |
| `{feed.name}`        | Tytuł feeda                     |
| `{feed.url}`         | URL strony feeda                |

<Note>
  Ile tekstu niesie `{item.description}` zależy w pełni od wydawcy. Niektóre feedy dają jedno zdanie podsumowania, inne pełny artykuł. Vetox nie przycina tego, ale obowiązuje limit 4 096 znaków opisu Discorda.
</Note>

## Co jest ogłaszane

Sprawdzane co **5 minut** z **5-minutowym cooldownem** per feed.

<Warning>
  **RSS nie ma limitu per odpytywanie.** Inne platformy patrzą na 5 najnowszych elementów; RSS bierze pod uwagę każdy element w feedzie jako kandydata.

  W praktyce próg wieku 2 godzin i 7-dniowa lista widzianych trzymają to pod kontrolą. Ale feed, który nagle republikuje wiele elementów ze świeżymi datami, może wytworzyć burzę ogłoszeń.
</Warning>

<Note>
  Elementy bez czytelnej daty publikacji omijają próg wieku 2 godzin. Źle uformowany feed może więc ogłaszać starsze elementy. Jeśli feed robi to wielokrotnie, to defekt feeda, a nie Vetox.
</Note>

Vetox używa żądań warunkowych, więc feed, który się nie zmienił, kosztuje prawie nic do sprawdzenia.

## Przykłady z życia

<AccordionGroup>
  <Accordion title="Patch notes gry">
    Wiele studiów publikuje feed changeloga. To często lepsze niż integracja Steam, bo niesie tylko oficjalne posty.
  </Accordion>

  <Accordion title="Status page">
    Większość stron statusu udostępnia feed. Kieruj go do kanału personelu jako wczesne ostrzeżenie o awarii wpływającej na Twoją społeczność.
  </Accordion>

  <Accordion title="Blog lub newsletter">
    `{item.title}` jako tytuł embedu, `{item.description}` jako treść, `{item.url}` jako link.
  </Accordion>
</AccordionGroup>

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Feed nie chce się zapisać">
    Vetox musi być w stanie pobrać go i sparsować od razu. Sprawdź URL w przeglądarce — jeśli renderuje się jako strona www, a nie XML, to nie jest URL feeda.

    Samo pobieranie również ma limity. Feed zostaje odrzucony, jeśli nie odpowie w ciągu **10 sekund**, przekracza **5 MB** lub przekierowuje więcej niż **3 razy**. Adres musi zaczynać się od `http://` lub `https://` i wskazywać na publiczny host — adres prywatny, lokalny lub z sieci wewnętrznej zostanie odrzucony.
  </Accordion>

  <Accordion title="Ogłoszono stare elementy">
    Feed nie dostarcza użytecznych dat publikacji, więc próg wieku nie może zadziałać.
  </Accordion>

  <Accordion title="Nadeszła burza ogłoszeń naraz">
    Wydawca zmienił daty wielu elementów. Nie ma limitu częstotliwości poza cooldownem per feed.
  </Accordion>

  <Accordion title="Opis jest pusty">
    Ten feed go nie zawiera. Użyj `{item.title}` i `{item.url}` zamiast.
  </Accordion>
</AccordionGroup>

<Card title="Podcasty" icon="podcast" horizontal href="/pl/notifications/podcasts">
  Wyspecjalizowany widok tej samej maszynerii feedów.
</Card>
