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

> Kündige in Discord an, wenn ein Twitch-Streamer live geht oder offline geht, mit einem vollständig anpassbaren Embed.

<Info>
  Erfordert **Basic**. Bis zu **10 Streamer** pro Server. Siehe [wie Benachrichtigungen funktionieren](/de/notifications/overview) für die von allen Plattformen geteilten Regeln.
</Info>

## Einen Streamer hinzufügen

Suche den Kanal nach Namen — Vetox schlägt ihn auf Twitch nach und bestätigt seine Existenz vor dem Hinzufügen. Ein Benutzername, der nicht aufgelöst wird, wird mit **Twitch user not found** abgelehnt.

Benutzernamen sind 1–25 Zeichen lang, nur Buchstaben, Zahlen und Unterstriche.

## Einstellungen

| Einstellung                                     | Standard        | Hinweise                                                                                                  |
| ----------------------------------------------- | --------------- | --------------------------------------------------------------------------------------------------------- |
| **Discord-Kanal**                               | —               | Erforderlich. Pro Streamer eingestellt, sodass verschiedene Streamer in verschiedene Kanäle posten können |
| **Bei Online benachrichtigen**                  | **An**          | Die Live-Ankündigung                                                                                      |
| **Bei Offline benachrichtigen**                 | **Aus**         | Eine zweite Ankündigung, wenn der Stream endet                                                            |
| **Erwähnungsrolle**                             | Keine           | Wird mit der Ankündigung angepingt                                                                        |
| **Benutzerdefinierter Benachrichtigungs-Embed** | Twitch-Standard | Violett, mit Stream-Titel, Spiel und Zuschauerzahl                                                        |

## Variablen

| Variable             | Wird aufgelöst zu                                          |
| -------------------- | ---------------------------------------------------------- |
| `{streamer.name}`    | Der Anzeigename des Streamers                              |
| `{streamer.url}`     | Ihre Twitch-Kanal-URL                                      |
| `{streamer.avatar}`  | Ihr Profilbild                                             |
| `{stream.title}`     | Der Stream-Titel — **nur Live-Ankündigung**                |
| `{stream.game}`      | Die gestreamte Kategorie — **nur live**                    |
| `{stream.viewers}`   | Zuschauerzahl zum Zeitpunkt der Ankündigung — **nur live** |
| `{stream.thumbnail}` | Das Stream-Vorschaubild — **nur live**                     |

<Warning>
  Die vier `{stream.*}`-Variablen haben in einer **Offline**-Ankündigung keinen Wert. Jedes daraus aufgebaute Embed-Feld verschwindet aus dieser Nachricht. Beschränke dein Offline-Embed auf `{streamer.*}`-Variablen.
</Warning>

## Wie das Live-Gehen erkannt wird

Vetox prüft alle **60 Sekunden** und verfolgt, ob der Kanal live ist.

<Steps>
  <Step title="Offline → live">
    Die Ankündigung feuert, mit einer **10-Minuten-Abklingzeit** pro Streamer.
  </Step>

  <Step title="Weiter live">
    Nichts. Der Zustand wird einfach aktualisiert — ein langer Stream erzeugt genau eine Ankündigung.
  </Step>

  <Step title="Live → offline">
    Die Offline-Ankündigung feuert, wenn du sie aktiviert hast.
  </Step>
</Steps>

<Warning>
  **Das Hinzufügen eines bereits live seienden Streamers kündigt nichts an.** Der Tracker feuert beim Übergang, nicht auf den aktuellen Zustand. Deine erste Ankündigung wird ihr nächster Stream sein.
</Warning>

<Note>
  Ein Stream, der kurz abbricht und innerhalb des Abklingzeit-Fensters wieder verbindet, erzeugt eine Ankündigung, nicht zwei — das ist beabsichtigt, und deshalb beträgt die Abklingzeit 10 Minuten statt 1.
</Note>

## Einrichtung in der Praxis

<Steps>
  <Step title="Twitch in der Server-Einrichtung einschalten">
    Standardmäßig aus. Nichts funktioniert, bis das an ist.
  </Step>

  <Step title="Den Streamer hinzufügen">
    Suche seinen Namen und wähle ihn aus den Ergebnissen.
  </Step>

  <Step title="Wähle einen Kanal und eine Rolle">
    Ein dedizierter `#going-live`-Kanal und eine `@Stream Ping`-Rolle, für die sich Mitglieder über [Self-Roles](/de/engagement/self-roles) entscheiden, ist das Muster, auf das die meisten Server kommen.
  </Step>

  <Step title="Prüfe dort die Berechtigungen des Bots">
    Kanal anzeigen, Nachrichten senden und **Links einbetten**.
  </Step>

  <Step title="Warte auf den nächsten Stream">
    Beurteile es nicht, indem du jemanden mitten im Stream hinzufügst.
  </Step>
</Steps>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Sie sind live gegangen und nichts wurde gepostet">
    Prüfe den Twitch-Schalter in der Server-Einrichtung, dass Premium aktiv ist, und Links einbetten im Kanal. Wenn du sie hinzugefügt hast, während sie bereits streamten, ist das erwartet — warte auf den nächsten Stream.
  </Accordion>

  <Accordion title="Das Spiel oder die Zuschauerzahl fehlt">
    Du siehst die Offline-Ankündigung. Diese Variablen existieren nur während live.
  </Accordion>

  <Accordion title="Das Ändern des Kanals hat nicht gegriffen">
    Das Leeren des Kanalfelds sendet nichts und behält den alten Wert stillschweigend. Wähle einen anderen Kanal, statt ihn zu leeren.
  </Accordion>

  <Accordion title="Zwei Server folgen demselben Streamer, und nur einer hat den Ping bekommen">
    Beide sollten feuern. Wenn die Berechtigungen eines Kanals fehlschlugen, ist das Element ohne Retry verloren — prüfe Links einbetten auf der ausfallenden Seite.
  </Accordion>
</AccordionGroup>

<Card title="Kick" icon="tower-broadcast" horizontal href="/de/notifications/kick">
  Dasselbe Live/Offline-Modell auf Kick.
</Card>