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

# Notifiche RSS

> Annuncia nuovi elementi da qualsiasi feed RSS o Atom nel tuo server Discord.

<Info>
  Richiede **Basic**. Fino a **10 feed** per server. Vedi [come funzionano le notifiche](/it/notifications/overview) per le regole comuni.
</Info>

RSS è il catch-all. Se un sito pubblica un feed, Vetox può annunciarlo — blog, changelog, siti di notizie, sezioni di forum, note di rilascio.

## Aggiungere un feed

Incolla l'URL del feed. Vetox lo recupera e lo analizza prima di salvarlo; qualsiasi cosa che non sia un feed leggibile viene rifiutata con **Invalid RSS feed URL or unable to parse feed**.

<Tip>
  Usa l'URL del feed, non l'URL del sito. Solitamente termina in `/feed`, `/rss`, `/atom.xml` o `/index.xml`. Se non sei sicuro, visualizza il sorgente della pagina e cerca un link `application/rss+xml`.
</Tip>

## Impostazioni

| Impostazione                  | Predefinito     | Note                                                                               |
| ----------------------------- | --------------- | ---------------------------------------------------------------------------------- |
| **Discord Channel**           | —               | Obbligatorio                                                                       |
| **Notify on New Items**       | **On**          |                                                                                    |
| **Custom Message**            | Nessuno         | Testo semplice, fino a 2.000 caratteri — una delle due sole piattaforme con questo |
| **Mention Role**              | Nessuno         |                                                                                    |
| **Custom Notification Embed** | Predefinito RSS | Arancione                                                                          |

## Variabili

| Variabile            | Si risolve in                   |
| -------------------- | ------------------------------- |
| `{item.title}`       | Titolo dell'elemento            |
| `{item.url}`         | Link all'elemento               |
| `{item.description}` | Riassunto o corpo dell'elemento |
| `{item.author}`      | Autore                          |
| `{feed.name}`        | Il titolo del feed              |
| `{feed.url}`         | L'URL del sito del feed         |

<Note>
  Quanto testo porta `{item.description}` dipende interamente dal publisher. Alcuni feed danno un riassunto di una riga, altri l'articolo completo. Vetox non lo tronca, ma si applica il limite di 4.096 caratteri della descrizione di Discord.
</Note>

## Cosa viene annunciato

Controllato ogni **5 minuti** con un **cooldown di 5 minuti** per feed.

<Warning>
  **RSS non ha alcun limite per poll.** Le altre piattaforme guardano ai loro 5 elementi più recenti; RSS considera ogni elemento nel feed come candidato.

  In pratica il cutoff di età di 2 ore e la seen-list di 7 giorni mantengono questo sotto controllo. Ma un feed che improvvisamente ripubblica molti elementi con date fresche può produrre una raffica di annunci.
</Warning>

<Note>
  Gli elementi senza data di pubblicazione leggibile bypassano il cutoff di età di 2 ore. Un feed mal formato può quindi annunciare elementi più vecchi. Se un feed fa questo ripetutamente, è un difetto del feed, non di Vetox.
</Note>

Vetox usa richieste condizionali, quindi un feed che non è cambiato costa quasi nulla da controllare.

## Esempi reali

<AccordionGroup>
  <Accordion title="Le note di patch di un gioco">
    Molti studi pubblicano un feed changelog. Questo è spesso meglio dell'integrazione Steam perché porta solo post ufficiali.
  </Accordion>

  <Accordion title="Una pagina di stato">
    La maggior parte delle pagine di stato espone un feed. Instradalo al canale del tuo staff per un preavviso di un'interruzione che colpisce la tua community.
  </Accordion>

  <Accordion title="Un blog o una newsletter">
    `{item.title}` come titolo dell'embed, `{item.description}` come corpo, `{item.url}` come link.
  </Accordion>
</AccordionGroup>

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Il feed non si salva">
    Vetox deve essere in grado di recuperarlo e analizzarlo proprio in quel momento. Controlla l'URL in un browser — se viene renderizzato come pagina web piuttosto che XML, non è l'URL del feed.

    Anche il recupero in sé ha dei limiti. Un feed viene rifiutato se non risponde entro **10 secondi**, supera i **5 MB** o effettua più di **3 reindirizzamenti**. L'indirizzo deve essere `http://` o `https://` e puntare a un host pubblico: un indirizzo privato, locale o di rete interna viene rifiutato.
  </Accordion>

  <Accordion title="Sono stati annunciati vecchi elementi">
    Il feed non fornisce date di pubblicazione utilizzabili, quindi il cutoff di età non può applicarsi.
  </Accordion>

  <Accordion title="Una raffica di annunci è arrivata insieme">
    Il publisher ha ridatato più elementi. Non c'è alcun rate limit oltre il cooldown per feed.
  </Accordion>

  <Accordion title="La descrizione è vuota">
    Quel feed non ne include una. Usa `{item.title}` e `{item.url}` invece.
  </Accordion>
</AccordionGroup>

<Card title="Podcast" icon="podcast" horizontal href="/it/notifications/podcasts">
  Una vista specializzata dello stesso meccanismo di feed.
</Card>