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

> Annuncia nuovi upload YouTube e live stream nel tuo server Discord.

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

## Aggiungere un canale

Cerca per nome del canale. Vetox lo risolve in un ID canale; un canale non risolvibile viene rifiutato con **YouTube channel not found**.

## Impostazioni

| Impostazione                  | Predefinito         | Note         |
| ----------------------------- | ------------------- | ------------ |
| **Discord Channel**           | —                   | Obbligatorio |
| **Notify on upload**          | **On**              | Nuovi video  |
| **Notify on live**            | **On**              | Live stream  |
| **Mention Role**              | Nessuno             |              |
| **Custom Notification Embed** | Predefinito YouTube | Rosso        |

<Warning>
  Disattivare **entrambi** i toggle salva senza lamentele e garantisce che il canale non annunci mai nulla. Non c'è alcun avviso per questo stato.
</Warning>

## Variabili

| Variabile           | Si risolve in                   |
| ------------------- | ------------------------------- |
| `{channel.name}`    | Nome del canale                 |
| `{channel.avatar}`  | Avatar del canale               |
| `{video.title}`     | Titolo del video                |
| `{video.url}`       | URL del video                   |
| `{video.thumbnail}` | Thumbnail del video             |
| `{video.type}`      | Se è un upload o un live stream |

## Come viene trovato il nuovo contenuto

Controllato ogni **5 minuti**, con un **cooldown di 10 minuti** per canale. Vetox legge il feed del canale e considera i **5 più recenti** ogni volta.

<Note>
  Un canale che pubblica più di 5 video all'interno di una finestra di 5 minuti può avere il più vecchio di essi mancato.
</Note>

<Warning>
  **Una premiere programmata viene annunciata come un upload**, usando la formulazione di upload piuttosto che quella di live. Se il tuo embed dice "went live", una premiere verrà letta in modo errato.
</Warning>

## Configurazione reale

<Steps>
  <Step title="Attiva YouTube in Server Setup" />

  <Step title="Aggiungi il canale per nome" />

  <Step title="Separa gli upload dagli stream se vuoi formulazioni diverse">
    Non puoi instradare upload e live stream in canali Discord diversi per lo stesso canale YouTube — un canale per voce. Usa `{video.type}` nell'embed per distinguerli invece.
  </Step>

  <Step title="Controlla Embed Links nel canale di destinazione" />
</Steps>

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Un nuovo video non è stato annunciato">
    Controlla prima il toggle Server Setup e il premium. Poi conferma che almeno uno dei due toggle di notifica è attivo. Se il video ha più di 2 ore, viene deliberatamente saltato.
  </Accordion>

  <Accordion title="Una premiere annunciata come un normale upload">
    Previsto — le premiere sono classificate come upload.
  </Accordion>

  <Accordion title="Gli Shorts vengono annunciati e non li voglio">
    Non c'è filtro per escludere gli Shorts. Tutto sul feed del canale viene trattato allo stesso modo.
  </Accordion>

  <Accordion title="Gli annunci sono fino a cinque minuti in ritardo">
    Quello è l'intervallo di poll. YouTube viene controllato ogni 5 minuti, non istantaneamente.
  </Accordion>
</AccordionGroup>

<Card title="Twitch" icon="twitch" horizontal href="/it/notifications/twitch">
  Streaming live con tracking istantaneo dello stato.
</Card>