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

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

> Оголошуйте нові елементи з будь-якої стрічки RSS чи Atom на своєму сервері Discord.

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

RSS — універсальне рішення. Якщо сайт публікує стрічку, Vetox може оголошувати з неї — блоги, changelog-и, новинні сайти, розділи форуму, release notes.

## Додавання стрічки

Вставте URL стрічки. Vetox завантажить і розпарсить її перед збереженням; усе, що не є читабельною стрічкою, відхиляється з **Invalid RSS feed URL or unable to parse feed**.

<Tip>
  Використовуйте URL стрічки, а не URL сайту. Зазвичай він закінчується на `/feed`, `/rss`, `/atom.xml` або `/index.xml`. Якщо не впевнені, перегляньте вихідний код сторінки й пошукайте посилання `application/rss+xml`.
</Tip>

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

| Налаштування                  | За замовчуванням     | Примітки                                                          |
| ----------------------------- | -------------------- | ----------------------------------------------------------------- |
| **Discord Channel**           | —                    | Обов'язково                                                       |
| **Notify on New Items**       | **Увімкнено**        |                                                                   |
| **Custom Message**            | Немає                | Звичайний текст до 2 000 символів — одна з двох платформ, де це є |
| **Mention Role**              | Немає                |                                                                   |
| **Custom Notification Embed** | За замовчуванням RSS | Помаранчевий                                                      |

## Змінні

| Змінна               | Значення               |
| -------------------- | ---------------------- |
| `{item.title}`       | Назва елемента         |
| `{item.url}`         | Посилання на елемент   |
| `{item.description}` | Опис або тіло елемента |
| `{item.author}`      | Автор                  |
| `{feed.name}`        | Заголовок стрічки      |
| `{feed.url}`         | URL сайту стрічки      |

<Note>
  Скільки тексту несе `{item.description}` — повністю на розсуд видавця. Одні стрічки дають одну лінійку, інші — цілу статтю. Vetox не обрізає, але діє ліміт Discord у 4 096 символів для description.
</Note>

## Що оголошується

Перевіряється кожні **5 хвилин** із **5-хвилинним кулдауном** на стрічку.

<Warning>
  **У RSS немає обмеження на опитування.** Інші платформи дивляться 5 останніх елементів; RSS розглядає кожен елемент у стрічці як кандидата.

  На практиці 2-годинне відсікання за віком і 7-денний список переглянутого це стримують. Але стрічка, яка раптом «переопубліковує» багато елементів зі свіжими датами, може дати сплеск оголошень.
</Warning>

<Note>
  Елементи без читабельної дати публікації обходять 2-годинне відсікання. Тож погано сформована стрічка може оголошувати старі елементи. Якщо стрічка постійно так робить — це дефект стрічки, а не Vetox.
</Note>

Vetox використовує умовні запити, тож стрічка, яка не змінилася, обходиться майже безкоштовно.

## Приклади з життя

<AccordionGroup>
  <Accordion title="Патч-ноути гри">
    Багато студій публікують стрічку changelog. Часто це краще, ніж інтеграція Steam, бо містить лише офіційні пости.
  </Accordion>

  <Accordion title="Сторінка статусу">
    Більшість сторінок статусу мають стрічку. Спрямуйте її в канал персоналу для раннього попередження про збій, що зачіпає вашу спільноту.
  </Accordion>

  <Accordion title="Блог або розсилка">
    `{item.title}` як заголовок embed, `{item.description}` як тіло, `{item.url}` як посилання.
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="Стрічка не зберігається">
    Vetox має змогти саме зараз завантажити й розпарсити її. Перевірте URL у браузері — якщо він рендериться як вебсторінка, а не XML, це не URL стрічки.

    Саме завантаження теж обмежене. Стрічку буде відхилено, якщо вона не відповідає протягом **10 секунд**, більша за **5 МБ** або перенаправляє більше ніж **3 рази**. Адреса має починатися з `http://` або `https://` та вказувати на публічний хост — приватна, локальна чи внутрішня мережева адреса відхиляється.
  </Accordion>

  <Accordion title="Оголошено старі елементи">
    Стрічка не дає придатних дат публікації, тож відсікання за віком не діє.
  </Accordion>

  <Accordion title="Прийшов сплеск оголошень одразу">
    Видавець переставив дати кільком елементам. Rate-ліміту, крім кулдауну на стрічку, немає.
  </Accordion>

  <Accordion title="Опис порожній">
    Ця стрічка його не має. Використайте `{item.title}` і `{item.url}` замість цього.
  </Accordion>
</AccordionGroup>

<Card title="Подкасти" icon="podcast" horizontal href="/uk/notifications/podcasts">
  Спеціалізований варіант тієї ж механіки стрічок.
</Card>