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

# Wie Benachrichtigungen funktionieren

> Kündige neue Streams, Videos, Posts und Episoden von acht externen Plattformen direkt in deinem Discord-Server an.

Vetox beobachtet acht externe Plattformen und postet eine Ankündigung in deinem Server, sobald etwas Neues erscheint.

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

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

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

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

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

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

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

  <Card title="Podcasts" icon="podcast" href="/de/notifications/podcasts" />
</CardGroup>

## Drei Dinge müssen wahr sein

Dies ist der bei weitem häufigste Grund, warum Benachrichtigungen scheinbar nicht funktionieren. Alle drei sind erforderlich, und nur das erste ist auf der Benachrichtigungsseite selbst sichtbar.

<Steps>
  <Step title="Premium Basic oder höher">
    Jede Plattform erfordert mindestens das **Basic**-Tier. Das Hinzufügen eines Abonnements auf Starter wird mit einer Meldung abgelehnt, die die Plattform nennt.

    Die Prüfung läuft zweimal — einmal beim Hinzufügen des Elements und erneut in dem Moment, in dem eine Ankündigung gesendet würde.
  </Step>

  <Step title="Der Schalter der Plattform in der Server-Einrichtung">
    Jede Plattform hat ihren eigenen Schalter auf der Seite [Server-Einrichtung](/de/server-management/setup), und er ist **standardmäßig aus**. Die Benachrichtigung selbst zu konfigurieren, reicht nicht.

    <Warning>
      Keine der Benachrichtigungsseiten zeigt dir den Zustand dieses Schalters. Ein vollständig konfigurierter, mit Premium bezahlter Feed wird stillschweigend nie feuern, ohne jeden Hinweis in der Benachrichtigungs-UI. **Prüfe zuerst die Server-Einrichtung.**
    </Warning>
  </Step>

  <Step title="Kanalberechtigungen">
    Vetox benötigt **Kanal anzeigen**, **Nachrichten senden** und **Links einbetten** im Zielkanal. Siehe unten.
  </Step>
</Steps>

## Limits

**10 Elemente pro Plattform, pro Server** — 10 Twitch-Streamer, 10 YouTube-Kanäle, 10 Subreddits usw.

Dies ist ein festes Produktlimit. Es **erhöht sich nicht** mit einem höheren Premium-Tier und ist auf Basic, Max und Black gleich.

## Wie schnell Benachrichtigungen ankommen

Vetox pollt jede Plattform nach einem festen Zeitplan. Eine Ankündigung kommt beim nächsten Poll nach dem Erscheinen des Inhalts an.

| Plattform | Wird geprüft alle | Abklingzeit pro Quelle |
| --------- | ----------------- | ---------------------- |
| Twitch    | 60 Sekunden       | 10 Minuten             |
| Kick      | 60 Sekunden       | 10 Minuten             |
| Bluesky   | 60 Sekunden       | 2 Minuten              |
| Reddit    | 3 Minuten         | 2 Minuten              |
| Steam     | 3 Minuten         | 2 Minuten              |
| YouTube   | 5 Minuten         | 10 Minuten             |
| RSS       | 5 Minuten         | 5 Minuten              |
| Podcasts  | 5 Minuten         | 5 Minuten              |

Die **Abklingzeit** ist eine Untergrenze zwischen zwei Ankündigungen für dieselbe Quelle, unabhängig vom Poll-Intervall. Ein Subreddit, das in einer Minute dreimal postet, erzeugt eine Ankündigung, nicht drei.

<Note>
  Das Polling wird von einer einzelnen gewählten Instanz durchgeführt, sodass ein ausgelasteter Server nie Duplikate von parallelen Workern erhält.
</Note>

### Zwei verschiedene Tracking-Modelle

| Modell           | Plattformen       | Verhalten                                                                                                     |
| ---------------- | ----------------- | ------------------------------------------------------------------------------------------------------------- |
| **Live-Zustand** | Twitch, Kick      | Verfolgt, ob der Stream live oder offline ist, und kündigt den Moment an, in dem sich dieser Zustand *ändert* |
| **Neuer Inhalt** | Die anderen sechs | Verfolgt einzelne Elemente und kündigt jedes neue einmal an                                                   |

<Warning>
  **Das Hinzufügen eines bereits live seienden Streamers erzeugt nichts.** Der Live-Zustandstracker feuert nur beim Übergang offline → online. Wenn du jemanden mitten im Stream hinzufügst, ist die erste Ankündigung, die du bekommst, ihr *nächster* Stream.

  Teste mit jemandem, der gerade offline ist, oder warte einfach.
</Warning>

<Note>
  Der Live/Offline-Zustand wird **pro Streamer verfolgt, nicht pro Server**. Wenn mehrere Server demselben Streamer folgen, werden sie aus einem gemeinsamen Zustand angesteuert.
</Note>

## Was nicht angekündigt wird

<AccordionGroup>
  <Accordion title="Alles, was vor dem Hinzufügen veröffentlicht wurde" icon="clock-rotate-left">
    Das Hinzufügen eines Abonnements füllt nie rückwirkend auf. Nur Inhalte, die nach dem Hinzufügen des Elements veröffentlicht wurden, werden angekündigt, damit dein Kanal während der Einrichtung nicht überflutet wird.
  </Accordion>

  <Accordion title="Inhalte älter als 2 Stunden" icon="hourglass-end">
    Für die sechs inhaltsbasierten Plattformen wird alles, was vor mehr als 2 Stunden veröffentlicht wurde, ignoriert, auch wenn Vetox es noch nie gesehen hat. Dies verhindert, dass nach einem Ausfall ein Rückstau abgeladen wird.

    Ein Element, dessen Feed kein lesbares Veröffentlichungsdatum liefert, umgeht diese Prüfung und kann unabhängig vom Alter angekündigt werden. Das ist gelegentlich der Grund, warum ein alter RSS-Eintrag erscheint.
  </Accordion>

  <Accordion title="Dasselbe Element zweimal" icon="copy">
    Jedes angekündigte Element wird pro Server **7 Tage** lang gemerkt, damit ein Neustart oder ein langsamer Poll kein Duplikat erzeugen kann. Zwei Server, die demselben Feed folgen, erhalten jeweils ihre eigene Kopie — dass ein Server ein Element sieht, unterdrückt es nicht für einen anderen.
  </Accordion>

  <Accordion title="Bluesky-Antworten und -Reposts" icon="reply">
    Nur Originalposts werden angekündigt. Antworten und Reposts werden zweifach herausgefiltert. **Quote-Posts werden nicht gefiltert** und werden angekündigt.
  </Accordion>

  <Accordion title="Alles, was ankam, während Premium abgelaufen war" icon="triangle-exclamation">
    Ein Element, das gesehen wird, während dein Premium inaktiv ist, wird 7 Tage lang als gesehen markiert, obwohl nichts gepostet wurde. Ein Upgrade kündigt es nicht rückwirkend an.

    Nach der Reaktivierung von Premium erwarte eine ruhige Phase, bis wirklich neue Inhalte erscheinen.
  </Accordion>
</AccordionGroup>

## Discord-Berechtigungen

Werden zum Sendezeitpunkt an den Live-Berechtigungen des Bots im Zielkanal geprüft:

| Berechtigung           | Warum                                                                                                                         |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Kanal anzeigen**     | Vetox kann nicht in einen Kanal posten, den es nicht sehen kann                                                               |
| **Nachrichten senden** | Um die Ankündigung zu posten                                                                                                  |
| **Links einbetten**    | Jede Benachrichtigung ist ein Embed. Ohne dies wird die Nachricht rundweg abgelehnt, auch wenn Nachrichten senden erlaubt ist |

<Warning>
  **Ein Berechtigungsfehler verliert dieses Element dauerhaft.** Das Element wird als gesehen markiert, bevor der Sendevorgang versucht wird, und es gibt keinen Retry. Behebe Berechtigungen *bevor* der Inhalt veröffentlicht wird, der dir wichtig ist — nicht danach.
</Warning>

<Tip>
  Wenn ein Kanal benutzerdefinierte Berechtigungsüberschreibungen hat, prüfe die *effektiven* Berechtigungen des Bots dort statt seiner serverweiten Rolle. Links einbetten fehlt am häufigsten.
</Tip>

## Die Ankündigung anpassen

| Option                           | Was sie tut                                                                                                                            |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Discord-Kanal**                | Wo die Ankündigung gepostet wird. Wird pro getrackt Element gesetzt, sodass verschiedene Streamer in verschiedene Kanäle posten können |
| **Erwähnungsrolle**              | Eine Rolle, die mit der Ankündigung angepingt wird                                                                                     |
| **Benutzerdefinierter Embed**    | Volle Kontrolle über Titel, Beschreibung, Farbe, Autor, Footer, Thumbnail, Bild und Felder                                             |
| **Benutzerdefinierte Nachricht** | Klartext, der als Embed-Body verwendet wird. **Nur bei RSS und Podcasts verfügbar**                                                    |

<Note>
  Ein Steuerelement für benutzerdefinierte Nachrichten erscheint nur auf den Seiten RSS und Podcasts. Die anderen sechs Plattformen verwenden stattdessen einen benutzerdefinierten Embed.
</Note>

### Embed-Größenlimits

| Feld                     | Limit                           |
| ------------------------ | ------------------------------- |
| Titel                    | 256 Zeichen                     |
| Beschreibung             | 4.096 Zeichen                   |
| Autorenname              | 256 Zeichen                     |
| Footer-Text              | 2.048 Zeichen                   |
| Felder                   | 25, jeweils 256 / 1.024 Zeichen |
| Bild- und Thumbnail-URLs | 500 Zeichen, kein SVG           |

### Variablen

Embed- und Nachrichtenfelder unterstützen Variablen in geschweiften Klammern, wie `{streamer.name}`. Jede Plattform hat ihren eigenen Satz, aufgelistet auf der Seite dieser Plattform.

<Warning>
  **Eine unbekannte Variable wird zu leerem Text, nicht zu einem Fehler.** Und ein Embed-Feld, dessen Titel oder Wert leer wird, wird vollständig aus der Nachricht entfernt.

  Ein Feld, das immer wieder verschwindet, bedeutet also fast immer eine falsch geschriebene Variable oder eine, die für diese Plattform nicht existiert. Prüfe den Namen gegen die Liste auf der Plattformseite — das Dropdown im Editor ist maßgeblich.
</Warning>

<Note>
  Twitch- und Kick-Stream-Variablen (`{stream.title}`, `{stream.viewers}` usw.) existieren nur in der **Live**-Ankündigung. Verwendet in einem Offline-Embed werden sie zu nichts aufgelöst und ihr Feld verschwindet.
</Note>

## Erwähnungen

Die von dir konfigurierte Erwähnungsrolle wird normal angepingt.

<Warning>
  Erwähnungen in einem Benachrichtigungs-Embed sind **nicht** auf die konfigurierte Rolle beschränkt. Eine Rollen- oder Nutzererwähnung, die in eine benutzerdefinierte Nachricht oder einen Embed-Body eingegeben wird, pingt. Sei vorsichtig mit `@everyone` in einer benutzerdefinierten Vorlage.
</Warning>

## Zwei Einstellungen, die du nicht ändern kannst

<Note>
  Der **Haupt-Aktivierungsschalter** und die **Embed-Farbe** für jede Plattform sind gespeichert, haben aber im Dashboard kein funktionierendes Steuerelement. Jede Plattform verwendet ihre Marken-Standardfarbe, und der Hauptschalter kann nicht umgelegt werden.

  Verwende den Schalter in der [Server-Einrichtung](/de/server-management/setup), um eine Plattform auszuschalten, und einen benutzerdefinierten Embed, um eine Farbe zu setzen.
</Note>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Es wird überhaupt nichts gepostet">
    Der Reihe nach:

    1. Der Schalter der Plattform auf der Seite **Server-Einrichtung** ist an — er ist standardmäßig aus und von hier unsichtbar
    2. Der Server hat aktives **Basic**-Premium oder höher
    3. Der Zielkanal existiert noch
    4. Vetox hat dort **Kanal anzeigen + Nachrichten senden + Links einbetten**
    5. Für Twitch und Kick — der Streamer ist seit dem Hinzufügen offline gegangen und zurückgekehrt
  </Accordion>

  <Accordion title="Ich bekomme die Live-Ankündigung, aber nicht die Offline-Ankündigung">
    Offline-Ankündigungen sind bei Twitch und Kick **standardmäßig aus**. Aktiviere sie am verfolgten Streamer.
  </Accordion>

  <Accordion title="Ein Embed-Feld verschwindet immer wieder">
    Sein Titel oder sein Wert wurde zu leer aufgelöst, und das Feld wurde verworfen. Fast immer eine falsch geschriebene oder plattformfremde Variable.
  </Accordion>

  <Accordion title="Ich kann kein elftes Element hinzufügen">
    Zehn pro Plattform ist das Maximum und skaliert nicht mit dem Tier. Entferne zuerst eines.
  </Accordion>

  <Accordion title="Es hat funktioniert, dann aufgehört, nachdem mein Premium abgelaufen ist">
    Die Konfiguration wird beibehalten, nicht gelöscht, und wird automatisch wieder aufgenommen. Aber alles, was während der Pause veröffentlicht wurde, ist bereits als gesehen markiert und wird nicht rückwirkend angekündigt.
  </Accordion>

  <Accordion title="Das Löschen des Kanals bei einem Twitch- oder Kick-Streamer hat nichts bewirkt">
    Ein geleertes Kanalfeld wird nicht gesendet, sodass der vorherige Kanal beibehalten und kein Fehler angezeigt wird. Wähle einen anderen Kanal, statt ihn zu löschen.
  </Accordion>
</AccordionGroup>