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

# Twitch-meldingen

> Kondig in Discord aan wanneer een Twitch-streamer live gaat of offline gaat, met een volledig aanpasbare embed.

<Info>
  Vereist **Basic**. Tot **10 streamers** per server. Zie [hoe meldingen werken](/nl/notifications/overview) voor de regels die door alle platforms worden gedeeld.
</Info>

## Een streamer toevoegen

Zoek het kanaal op naam — Vetox zoekt hem op Twitch op en bevestigt dat hij bestaat voordat hij wordt toegevoegd. Een gebruikersnaam die niet resolveert wordt afgewezen met **Twitch user not found**.

Gebruikersnamen zijn 1–25 tekens, alleen letters, cijfers en underscores.

## Instellingen

| Instelling                    | Standaard        | Opmerkingen                                                                                               |
| ----------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------- |
| **Discord-kanaal**            | —                | Verplicht. Per streamer ingesteld, zodat verschillende streamers naar verschillende kanalen kunnen posten |
| **Notify when online**        | **Aan**          | De live-aankondiging                                                                                      |
| **Notify when offline**       | **Uit**          | Een tweede aankondiging wanneer de stream eindigt                                                         |
| **Mention Role**              | Geen             | Gepingd met de aankondiging                                                                               |
| **Custom Notification Embed** | Twitch standaard | Paars, met de stream-titel, game en kijkersaantal                                                         |

## Variabelen

| Variabele            | Resolveert naar                                            |
| -------------------- | ---------------------------------------------------------- |
| `{streamer.name}`    | De weergavenaam van de streamer                            |
| `{streamer.url}`     | Hun Twitch-kanaal-URL                                      |
| `{streamer.avatar}`  | Hun profielafbeelding                                      |
| `{stream.title}`     | De stream-titel — **alleen live-aankondiging**             |
| `{stream.game}`      | De gestreamde categorie — **alleen live**                  |
| `{stream.viewers}`   | Kijkersaantal op moment van aankondiging — **alleen live** |
| `{stream.thumbnail}` | De voorbeeldafbeelding van de stream — **alleen live**     |

<Warning>
  De vier `{stream.*}`-variabelen hebben geen waarde in een **offline**-aankondiging. Elk embed-veld dat daaruit is opgebouwd verdwijnt uit dat bericht. Houd je offline-embed op `{streamer.*}`-variabelen alleen.
</Warning>

## Hoe live gaan wordt gedetecteerd

Vetox controleert elke **60 seconden** en houdt bij of het kanaal live is.

<Steps>
  <Step title="Offline → live">
    De aankondiging gaat af, onder voorbehoud van een **cooldown van 10 minuten** per streamer.
  </Step>

  <Step title="Nog steeds live">
    Niets. De status wordt gewoon ververst — een lange stream produceert precies één aankondiging.
  </Step>

  <Step title="Live → offline">
    De offline-aankondiging gaat af, als je die hebt ingeschakeld.
  </Step>
</Steps>

<Warning>
  **Een streamer toevoegen die al live is kondigt niets aan.** De tracker gaat af op de transitie, niet op de huidige status. Je eerste aankondiging is hun volgende stream.
</Warning>

<Note>
  Een stream die kortstondig wegvalt en binnen het cooldown-venster opnieuw verbindt produceert één aankondiging, niet twee — dit is bewust, en daarom is de cooldown 10 minuten in plaats van 1.
</Note>

## Praktijkinstallatie

<Steps>
  <Step title="Zet Twitch aan in Server-instellingen">
    Het staat standaard uit. Niets werkt totdat dit aan staat.
  </Step>

  <Step title="Voeg de streamer toe">
    Zoek hun naam en selecteer ze uit de resultaten.
  </Step>

  <Step title="Kies een kanaal en een rol">
    Een speciaal `#going-live`-kanaal en een `@Stream Ping`-rol waar leden zich via [Self-Roles](/nl/engagement/self-roles) voor opgeven is het patroon waar de meeste servers op uitkomen.
  </Step>

  <Step title="Controleer de permissies van de bot daar">
    Kanaal bekijken, Berichten verzenden en **Links insluiten**.
  </Step>

  <Step title="Wacht op hun volgende stream">
    Beoordeel het niet door iemand mid-stream toe te voegen.
  </Step>
</Steps>

## Problemen oplossen

<AccordionGroup>
  <Accordion title="Ze zijn live gegaan en er is niets gepost">
    Controleer de Twitch-schakelaar in Server-instellingen, of premium actief is en of Links insluiten in het kanaal aan staat. Als je hen toevoegde terwijl ze al streamden, is dit verwacht — wacht op de volgende stream.
  </Accordion>

  <Accordion title="De game of het kijkersaantal ontbreekt">
    Je kijkt naar de offline-aankondiging. Die variabelen bestaan alleen tijdens live.
  </Accordion>

  <Accordion title="Kanaal wijzigen werd niet toegepast">
    Het kanaalveld wissen verzendt niets en behoudt stilzwijgend de oude waarde. Selecteer een ander kanaal in plaats van het te wissen.
  </Accordion>

  <Accordion title="Twee servers volgen dezelfde streamer en maar één kreeg de ping">
    Beide zouden moeten afgaan. Als de permissies van één kanaal faalden, is dat item verloren zonder retry — controleer Links insluiten aan de falende kant.
  </Accordion>
</AccordionGroup>

<Card title="Kick" icon="tower-broadcast" horizontal href="/nl/notifications/kick">
  Hetzelfde live/offline-model op Kick.
</Card>
