> ## 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 лент** на сервер. См. [как работают уведомления](/ru/notifications/overview) для общих правил.
</Info>

RSS — универсальный вариант. Если сайт публикует ленту, Vetox может её объявлять — блоги, чейнджлоги, новостные сайты, разделы форумов, релизы.

## Добавление ленты

Вставьте 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 default  | Оранжевый                                                       |

## Переменные

| Переменная           | Разворачивается в                  |
| -------------------- | ---------------------------------- |
| `{item.title}`       | Заголовок записи                   |
| `{item.url}`         | Ссылка на запись                   |
| `{item.description}` | Краткое содержание или тело записи |
| `{item.author}`      | Автор                              |
| `{feed.name}`        | Заголовок ленты                    |
| `{feed.url}`         | URL сайта ленты                    |

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

## Что объявляется

Проверка каждые **5 минут** с **5-минутным кулдауном** на ленту.

<Warning>
  **У RSS нет лимита на опрос.** Другие платформы смотрят 5 самых новых записей; RSS рассматривает каждую запись в ленте как кандидата.

  На практике 2-часовая отсечка и 7-дневный список просмотренного держат это под контролем. Но лента, которая внезапно переопубликует много записей с новыми датами, может дать всплеск объявлений.
</Warning>

<Note>
  Записи без читаемой даты публикации обходят 2-часовую отсечку. Поэтому плохо сформированная лента может объявлять старые записи. Если лента делает это постоянно — это дефект ленты, а не Vetox.
</Note>

Vetox использует условные запросы, поэтому лента, которая не изменилась, стоит почти ничего.

## Реальные примеры

<AccordionGroup>
  <Accordion title="Патчноуты игры">
    Многие студии публикуют чейнджлог-ленту. Часто это лучше интеграции 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="Разом пришёл всплеск объявлений">
    Издатель переставил даты у нескольких записей. Ограничений частоты сверх кулдауна на ленту нет.
  </Accordion>

  <Accordion title="Описание пустое">
    Эта лента его не содержит. Используйте `{item.title}` и `{item.url}`.
  </Accordion>
</AccordionGroup>

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