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

> Annuncia in Discord quando uno streamer Twitch va live o va offline, con un embed completamente personalizzabile.

<Info>
  Richiede **Basic**. Fino a **10 streamer** per server. Vedi [come funzionano le notifiche](/it/notifications/overview) per le regole condivise da tutte le piattaforme.
</Info>

## Aggiungere uno streamer

Cerca il canale per nome — Vetox lo cerca su Twitch e conferma che esiste prima di aggiungerlo. Un username che non si risolve viene rifiutato con **Twitch user not found**.

Gli username sono di 1–25 caratteri, solo lettere, numeri e underscore.

## Impostazioni

| Impostazione                  | Predefinito        | Note                                                                                               |
| ----------------------------- | ------------------ | -------------------------------------------------------------------------------------------------- |
| **Discord Channel**           | —                  | Obbligatorio. Impostato per streamer, quindi streamer diversi possono pubblicare in canali diversi |
| **Notify when online**        | **On**             | L'annuncio live                                                                                    |
| **Notify when offline**       | **Off**            | Un secondo annuncio quando lo stream termina                                                       |
| **Mention Role**              | Nessuno            | Pingato con l'annuncio                                                                             |
| **Custom Notification Embed** | Predefinito Twitch | Viola, con titolo dello stream, gioco e conteggio spettatori                                       |

## Variabili

| Variabile            | Si risolve in                                                 |
| -------------------- | ------------------------------------------------------------- |
| `{streamer.name}`    | Il nome visualizzato dello streamer                           |
| `{streamer.url}`     | Il loro URL del canale Twitch                                 |
| `{streamer.avatar}`  | La loro immagine del profilo                                  |
| `{stream.title}`     | Il titolo dello stream — **solo annuncio live**               |
| `{stream.game}`      | La categoria in streaming — **solo live**                     |
| `{stream.viewers}`   | Conteggio spettatori al momento dell'annuncio — **solo live** |
| `{stream.thumbnail}` | L'immagine di anteprima dello stream — **solo live**          |

<Warning>
  Le quattro variabili `{stream.*}` non hanno valore in un annuncio **offline**. Qualsiasi campo embed costruito da esse scompare da quel messaggio. Mantieni il tuo embed offline solo con variabili `{streamer.*}`.
</Warning>

## Come viene rilevato il go live

Vetox controlla ogni **60 secondi** e traccia se il canale è live.

<Steps>
  <Step title="Offline → live">
    L'annuncio scatta, soggetto a un **cooldown di 10 minuti** per streamer.
  </Step>

  <Step title="Ancora live">
    Nulla. Lo stato viene semplicemente aggiornato — uno stream lungo produce esattamente un annuncio.
  </Step>

  <Step title="Live → offline">
    L'annuncio offline scatta, se lo hai attivato.
  </Step>
</Steps>

<Warning>
  **Aggiungere uno streamer che è già live non annuncia nulla.** Il tracker scatta sulla transizione, non sullo stato corrente. Il tuo primo annuncio sarà il loro prossimo stream.
</Warning>

<Note>
  Uno stream che si interrompe brevemente e si riconnette entro la finestra di cooldown produce un annuncio, non due — questo è deliberato, ed è il motivo per cui il cooldown è di 10 minuti piuttosto che 1.
</Note>

## Configurazione reale

<Steps>
  <Step title="Attiva Twitch in Server Setup">
    È disattivato per impostazione predefinita. Nulla funziona finché questo non è attivo.
  </Step>

  <Step title="Aggiungi lo streamer">
    Cerca il loro nome e selezionali dai risultati.
  </Step>

  <Step title="Scegli un canale e un ruolo">
    Un canale dedicato `#going-live` e un ruolo `@Stream Ping` a cui i membri optano tramite [Self-Roles](/it/engagement/self-roles) è il pattern su cui la maggior parte dei server atterra.
  </Step>

  <Step title="Controlla i permessi del bot lì">
    View Channel, Send Messages e **Embed Links**.
  </Step>

  <Step title="Aspetta il loro prossimo stream">
    Non giudicarlo aggiungendo qualcuno a metà stream.
  </Step>
</Steps>

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Sono andati live e nulla è stato pubblicato">
    Controlla il toggle Twitch di Server Setup, il premium è attivo e Embed Links nel canale. Se li hai aggiunti mentre stavano già streamando, questo è previsto — aspetta il prossimo stream.
  </Accordion>

  <Accordion title="Il gioco o il conteggio spettatori è mancante">
    Stai guardando l'annuncio offline. Quelle variabili esistono solo mentre live.
  </Accordion>

  <Accordion title="Cambiare il canale non ha preso">
    Svuotare il campo del canale non invia nulla e mantiene silenziosamente il vecchio valore. Seleziona un canale diverso piuttosto che svuotarlo.
  </Accordion>

  <Accordion title="Due server seguono lo stesso streamer e solo uno ha ricevuto il ping">
    Entrambi dovrebbero scattare. Se i permessi di un canale sono falliti, quell'elemento è perduto senza retry — controlla Embed Links sul lato che fallisce.
  </Accordion>
</AccordionGroup>

<Card title="Kick" icon="tower-broadcast" horizontal href="/it/notifications/kick">
  Lo stesso modello live/offline su Kick.
</Card>