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

# Come funzionano le notifiche

> Annuncia nuovi stream, video, post ed episodi da otto piattaforme esterne direttamente nel tuo server Discord.

Vetox monitora otto piattaforme esterne e pubblica un annuncio nel tuo server ogni volta che appare qualcosa di nuovo.

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

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

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

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

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

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

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

  <Card title="Podcast" icon="podcast" href="/it/notifications/podcasts" />
</CardGroup>

## Tre cose devono essere vere

Questo è il motivo singolarmente più comune per cui le notifiche sembrano non funzionare. Tutte e tre sono obbligatorie, e solo la prima è visibile sulla pagina delle notifiche stessa.

<Steps>
  <Step title="Premium Basic o superiore">
    Ogni piattaforma richiede almeno il tier **Basic**. Aggiungere un abbonamento su Starter viene rifiutato con un messaggio che nomina la piattaforma.

    Il controllo viene eseguito due volte — una volta quando aggiungi l'elemento, e di nuovo nel momento in cui un annuncio verrebbe inviato.
  </Step>

  <Step title="Il toggle della piattaforma in Server Setup">
    Ogni piattaforma ha il proprio interruttore nella pagina [Server Setup](/it/server-management/setup), ed è **disattivato per impostazione predefinita**. Configurare la notifica stessa non è sufficiente.

    <Warning>
      Nessuna delle pagine di notifiche ti mostra lo stato di questo toggle. Un feed completamente configurato e a pagamento non scatterà mai silenziosamente, senza alcuna indicazione nell'UI delle notifiche. **Controlla prima Server Setup.**
    </Warning>
  </Step>

  <Step title="Permessi del canale">
    Vetox necessita di **View Channel**, **Send Messages** ed **Embed Links** nel canale di destinazione. Vedi sotto.
  </Step>
</Steps>

## Limiti

**10 elementi per piattaforma, per server** — 10 streamer Twitch, 10 canali YouTube, 10 subreddit, e così via.

Questo è un limite di prodotto piatto. **Non** aumenta con un tier premium più alto, ed è lo stesso su Basic, Max e Black.

## Quanto velocemente arrivano le notifiche

Vetox interroga ogni piattaforma su un programma fisso. Un annuncio arriva al prossimo poll dopo che il contenuto appare.

| Piattaforma | Controllato ogni | Cooldown per fonte |
| ----------- | ---------------- | ------------------ |
| Twitch      | 60 secondi       | 10 minuti          |
| Kick        | 60 secondi       | 10 minuti          |
| Bluesky     | 60 secondi       | 2 minuti           |
| Reddit      | 3 minuti         | 2 minuti           |
| Steam       | 3 minuti         | 2 minuti           |
| YouTube     | 5 minuti         | 10 minuti          |
| RSS         | 5 minuti         | 5 minuti           |
| Podcast     | 5 minuti         | 5 minuti           |

Il **cooldown** è un pavimento tra due annunci per la stessa fonte, indipendente dall'intervallo di poll. Un subreddit che pubblica tre volte in un minuto produce un annuncio, non tre.

<Note>
  Il polling è fatto da una singola istanza eletta, quindi un server occupato non riceve mai duplicati da worker paralleli.
</Note>

### Due modelli di tracking diversi

| Modello         | Piattaforme  | Comportamento                                                                             |
| --------------- | ------------ | ----------------------------------------------------------------------------------------- |
| **Live state**  | Twitch, Kick | Traccia se lo stream è live o offline, e annuncia il momento in cui quello stato *cambia* |
| **New content** | Le altre sei | Traccia elementi individuali e annuncia ognuno una volta                                  |

<Warning>
  **Aggiungere uno streamer che è già live non produce nulla.** Il tracker live-state scatta solo su una transizione offline → online. Se aggiungi qualcuno a metà stream, il primo annuncio che ottieni è il loro *prossimo* stream.

  Testa con qualcuno che è attualmente offline, o semplicemente aspetta.
</Warning>

<Note>
  Lo stato live/offline è tracciato **per streamer, non per server**. Se diversi server seguono lo stesso streamer, sono guidati da uno stato condiviso.
</Note>

## Cosa non verrà annunciato

<AccordionGroup>
  <Accordion title="Qualsiasi cosa pubblicata prima che tu la aggiungessi" icon="clock-rotate-left">
    Aggiungere un abbonamento non fa mai il backfill. Solo il contenuto pubblicato dopo che hai aggiunto l'elemento viene annunciato, quindi il tuo canale non viene inondato durante la configurazione.
  </Accordion>

  <Accordion title="Contenuto più vecchio di 2 ore" icon="hourglass-end">
    Per le sei piattaforme basate su contenuto, qualsiasi cosa pubblicata più di 2 ore fa viene ignorata anche se Vetox non l'ha mai vista. Questo previene che un arretrato venga scaricato dopo un'interruzione.

    Un elemento il cui feed non fornisce una data di pubblicazione leggibile bypassa questo controllo e può essere annunciato indipendentemente dall'età. Questo è occasionalmente il motivo per cui appare un vecchio elemento RSS.
  </Accordion>

  <Accordion title="Lo stesso elemento due volte" icon="copy">
    Ogni elemento annunciato viene ricordato per **7 giorni**, per server, quindi un riavvio o un poll lento non può produrre un duplicato. Due server che seguono lo stesso feed ottengono ognuno la propria copia — un server che vede un elemento non lo sopprime per un altro.
  </Accordion>

  <Accordion title="Risposte e repost Bluesky" icon="reply">
    Solo i post originali vengono annunciati. Risposte e repost vengono filtrati due volte. **I quote post non vengono filtrati** e verranno annunciati.
  </Accordion>

  <Accordion title="Qualsiasi cosa sia arrivata mentre il premium era scaduto" icon="triangle-exclamation">
    Un elemento visto mentre il tuo premium è inattivo viene marcato come visto per 7 giorni anche se nulla è stato pubblicato. Fare l'upgrade non lo annuncia retroattivamente.

    Dopo aver riattivato il premium, aspettati un periodo silenzioso finché non appare contenuto genuinamente nuovo.
  </Accordion>
</AccordionGroup>

## Permessi Discord

Controllati sui permessi live del bot nel canale di destinazione al momento dell'invio:

| Permesso          | Perché                                                                                                               |
| ----------------- | -------------------------------------------------------------------------------------------------------------------- |
| **View Channel**  | Vetox non può pubblicare in un canale che non può vedere                                                             |
| **Send Messages** | Per pubblicare l'annuncio                                                                                            |
| **Embed Links**   | Ogni notifica è un embed. Senza questo il messaggio viene rifiutato completamente, anche se Send Messages è concesso |

<Warning>
  **Un fallimento dei permessi perde quell'elemento permanentemente.** L'elemento viene marcato come visto prima che l'invio venga tentato, e non c'è retry. Sistema i permessi *prima* che il contenuto che ti interessa venga pubblicato — non dopo.
</Warning>

<Tip>
  Se un canale ha overwrite personalizzati dei permessi, controlla i permessi *effettivi* del bot lì piuttosto che il suo ruolo a livello di server. Embed Links è quello che manca più spesso.
</Tip>

## Personalizzare l'annuncio

| Opzione             | Cosa fa                                                                                                                  |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Discord channel** | Dove pubblica l'annuncio. Impostato per elemento tracciato, quindi streamer diversi possono pubblicare in canali diversi |
| **Mention role**    | Un ruolo pingato con l'annuncio                                                                                          |
| **Custom embed**    | Controllo completo di titolo, descrizione, colore, autore, footer, thumbnail, immagine e campi                           |
| **Custom message**  | Testo semplice usato come corpo dell'embed. **Disponibile solo su RSS e Podcast**                                        |

<Note>
  Un controllo di messaggio personalizzato appare solo nelle pagine RSS e Podcast. Le altre sei piattaforme usano invece un embed personalizzato.
</Note>

### Limiti di dimensione degli embed

| Campo                    | Limite                           |
| ------------------------ | -------------------------------- |
| Titolo                   | 256 caratteri                    |
| Descrizione              | 4.096 caratteri                  |
| Nome autore              | 256 caratteri                    |
| Testo footer             | 2.048 caratteri                  |
| Campi                    | 25, ognuno 256 / 1.024 caratteri |
| URL immagine e thumbnail | 500 caratteri, no SVG            |

### Variabili

I campi embed e messaggio supportano variabili tra parentesi graffe, come `{streamer.name}`. Ogni piattaforma ha il proprio set, elencato nella pagina di quella piattaforma.

<Warning>
  **Una variabile sconosciuta diventa testo vuoto, non un errore.** E un campo embed il cui titolo o valore risulta vuoto viene scartato completamente dal messaggio.

  Quindi un campo che continua a svanire quasi sempre significa una variabile scritta male o inesistente per quella piattaforma. Controlla il nome contro l'elenco nella pagina della piattaforma — il dropdown nell'editor è autoritativo.
</Warning>

<Note>
  Le variabili stream di Twitch e Kick (`{stream.title}`, `{stream.viewers}` e così via) esistono solo nell'annuncio **live**. Usate in un embed offline si risolvono in nulla e il loro campo scompare.
</Note>

## Menzioni

Il ruolo di menzione che configuri viene pingato normalmente.

<Warning>
  Le menzioni in un embed di notifica **non** sono limitate al ruolo configurato. Una menzione di ruolo o utente digitata in un messaggio personalizzato o nel corpo dell'embed pingerà. Fai attenzione con `@everyone` in un template personalizzato.
</Warning>

## Due impostazioni che non puoi cambiare

<Note>
  L'**interruttore principale di abilitazione** e il **colore dell'embed** per ogni piattaforma sono memorizzati ma non hanno un controllo funzionante nella dashboard. Ogni piattaforma usa il proprio colore di brand predefinito, e l'interruttore principale non può essere commutato.

  Usa il toggle di [Server Setup](/it/server-management/setup) per disattivare una piattaforma, e un embed personalizzato per impostare un colore.
</Note>

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Nulla viene pubblicato affatto">
    In ordine:

    1. Il toggle della piattaforma nella pagina **Server Setup** è attivo — è disattivato per impostazione predefinita e invisibile da qui
    2. Il server ha premium **Basic** o superiore attivo
    3. Il canale di destinazione esiste ancora
    4. Vetox ha **View Channel + Send Messages + Embed Links** lì
    5. Per Twitch e Kick — lo streamer è andato offline ed è tornato da quando li hai aggiunti
  </Accordion>

  <Accordion title="Ricevo l'annuncio live ma non quello offline">
    Gli annunci offline sono **disattivati per impostazione predefinita** su Twitch e Kick. Attivali sullo streamer tracciato.
  </Accordion>

  <Accordion title="Un campo embed continua a sparire">
    Il suo titolo o il suo valore si è risolto in vuoto e il campo è stato scartato. Quasi sempre una variabile scritta male o della piattaforma sbagliata.
  </Accordion>

  <Accordion title="Non posso aggiungere un undicesimo elemento">
    Dieci per piattaforma è il massimo e non scala con il tier. Rimuovine uno prima.
  </Accordion>

  <Accordion title="Ha funzionato, poi si è fermato dopo che il mio premium è scaduto">
    La configurazione viene mantenuta, non eliminata, e riprende automaticamente. Ma qualsiasi cosa pubblicata durante il lapse è già marcata come vista e non verrà annunciata retroattivamente.
  </Accordion>

  <Accordion title="Svuotare il canale su uno streamer Twitch o Kick non ha fatto nulla">
    Un campo canale svuotato non viene inviato, quindi il canale precedente viene mantenuto e nessun errore viene mostrato. Seleziona un canale diverso invece di svuotarlo.
  </Accordion>
</AccordionGroup>