Twitch-Benachrichtigungen
Sofort-Alerts, wenn dein Lieblingsstreamer live geht
Das Twitch-Benachrichtigungsmodul lässt den Bot bis zu 25 Twitch-Streamer beobachten und postet automatisch eine Nachricht in einen Discord-Channel, sobald jemand live geht. Benachrichtigungen kommen per Twitch EventSub innerhalb von Sekunden — kein Polling, kein API-Kontingent-Verbrauch.
Überblick
Sobald ein Streamer hinzugefügt und ein Ziel-Discord-Channel gewählt ist, registriert der Bot beim Twitch-EventSub-Dienst eine Webhook-Subscription. Wenn Twitch erkennt, dass der Stream startet, schickt es ein signiertes Event an TeraOne's Server — innerhalb weniger Sekunden. Der Bot postet dann das konfigurierte Nachrichten-Template mit Stream-Titel, Spielname und einem direkten Twitch-Link in den gewählten Discord-Channel.
Einrichten
- Twitch-Benachrichtigungen im Dashboard öffnen und das Modul aktivieren
- Twitch-Benutzernamen oder Kanal-URL eingeben und auf Hinzufügen klicken
- Ziel-Discord-Channel auswählen, in den die Live-Alerts gepostet werden sollen
- Optional: Nachrichtentemplate anpassen und Rollen-Erwähnungen hinzufügen
- Speichern — der Bot registriert sofort die EventSub-Subscription bei Twitch
Funktionen
Das Twitch-Benachrichtigungs-Tab im Dashboard bietet folgende Möglichkeiten pro Streamer-Subscription:
| Funktion | Beschreibung |
|---|---|
| Streamer hinzufügen | Suche per Twitch-Login-Name oder Kanal-URL. Der Bot prüft den Account und zeigt eine Vorschau (Anzeigename, Profilbild, Follower-Anzahl). |
| Subscription bearbeiten | Ziel-Discord-Channel wechseln, Nachrichtentemplate ändern, Rollen-Erwähnungen hinzufügen oder entfernen, oder die Subscription vorübergehend deaktivieren ohne sie zu löschen. |
| History-Tab | Protokoll aller letzten Benachrichtigungen pro Subscription: Stream-Titel, Spiel, Ziel-Channel, Status (sent / failed / skipped), Zeitstempel und Fehlermeldung bei Fehler. |
| Nachrichtentemplate | Freitext mit Platzhalter-Variablen. Das Template unterstützt Discord-Markdown und Erwähnungen. Bis zu 2.000 Zeichen. |
| Rollen-Erwähnungen | Bis zu 20 Discord-Rollen anhängen, die im Benachrichtigungs-Post gepingt werden. Die Erwähnungen werden automatisch vor dem Template-Text eingefügt. |
| Test-Vorschau | Sendet eine simulierte Live-Nachricht mit realistischen Dummy-Daten in den Ziel-Channel, um Layout und Berechtigungen zu prüfen, bevor ein echter Stream startet. |
Template-Variablen
Verwende diese Platzhalter im Nachrichtentemplate. Sie werden zum Zeitpunkt der Benachrichtigung durch echte Stream-Daten ersetzt:
| Variable | Inhalt |
|---|---|
{streamer} | Anzeigename des Twitch-Kanals (z. B. Shroud) |
{login} | Kleingeschriebener Login-Name (z. B. shroud) — nützlich für manuelle Twitch-URLs |
{title} | Stream-Titel zum Zeitpunkt des Go-Live-Events |
{game} | Kategorie / Spielname, den der Streamer ausgewählt hat (z. B. Valorant) |
{url} | docs.twitch-notifications.template_variables.row_url_desc |
{started_at} | ISO-8601-Zeitstempel des Stream-Starts (UTC) |
So funktioniert es
Twitch-Benachrichtigungen nutzen das EventSub-Push-Modell statt Polling:
- Sobald du einen Streamer hinzufügst, ruft der Bot die Twitch Helix API auf, um eine EventSub-Subscription für das stream.online-Event dieses Kanals zu registrieren.
- Twitch sendet einen signierten HTTPS-POST an TeraOne's Webhook-Endpunkt, sobald der Streamer live geht. Die Signatur wird geprüft, um gefälschte Events abzulehnen.
- Das Payload wird in BullMQ eingereiht. Ein Delivery-Worker löst die Template-Variablen auf, baut die Discord-Nachricht zusammen und postet sie in den konfigurierten Channel.
- EventSub-Subscriptions werden automatisch erneuert, bevor sie ablaufen. Verwaiste Subscriptions (Server verlassen, Modul deaktiviert) werden nächtlich bereinigt.
Datenschutz & Aufbewahrung
Das Twitch-Modul speichert nur die Metadaten, die zum Senden und Protokollieren von Benachrichtigungen nötig sind. Stream-Inhalte, Chat-Nachrichten oder Zuschauerdaten werden zu keinem Zeitpunkt gelesen oder gespeichert. Folgende Kategorien werden aufbewahrt:
| Datenkategorie | Aufbewahrung |
|---|---|
| Benachrichtigungs-Protokoll pro Eintrag (Status, Zeitstempel, Fehler) | 90 Tage |
| Rohe EventSub-Payloads (Stream-Titel, Spiel, Startzeit) | 365 Tage |
| Verwaiste EventSub-Subscriptions (Server verlassen / Modul deaktiviert) | Bereinigung innerhalb von 30 Tagen |
Die automatische Bereinigung läuft jede Nacht. Ältere Einträge werden dauerhaft gelöscht und können nicht wiederhergestellt werden.
Fehlersuche
- History ist leer, nachdem ein Streamer hinzugefügt wurde
- Der History-Tab füllt sich erst, wenn der Streamer nach dem Erstellen der Subscription tatsächlich live geht. Um die Einrichtung sofort zu prüfen, nutze die Test-Vorschau-Schaltfläche. Schlägt auch der Test fehl, prüfe die Schreibrechte des Bots im Ziel-Channel.
- Rollen-Ping erscheint nicht in der Benachrichtigung
- Öffne den Subscription-Editor und prüfe, ob die Rollen gespeichert sind. Kontrolliere außerdem, ob der Bot die Berechtigung "@everyone, @here und alle Rollen erwähnen" im Ziel-Channel hat — ohne sie entfernt Discord die Erwähnungen stillschweigend.
- Fehler "Streamer bereits hinzugefügt" beim Versuch, einen Kanal hinzuzufügen
- Jeder Twitch-Login kann pro Discord-Server nur einmal abonniert werden. Um Benachrichtigungen in einen zweiten Channel zu senden, bearbeite die bestehende Subscription und ändere den Ziel-Channel, oder lösche zuerst die alte Subscription.
Häufige Fragen
- Wie schnell kommt die Benachrichtigung, nachdem der Stream gestartet ist?
- Twitch sendet das Event innerhalb von Sekunden, nachdem der Stream live geht. Die Ende-zu-Ende-Latenz (Twitch-Event → Discord-Nachricht) beträgt typischerweise 3–8 Sekunden.
- Kann derselbe Twitch-Kanal mehrere Discord-Server benachrichtigen?
- Ja. Jeder Discord-Server hat seine eigene unabhängige Subscription. Ein Twitch-Kanal kann gleichzeitig beliebig viele Server benachrichtigen.
- Was passiert, wenn der Bot kurz offline ist, wenn ein Stream startet?
- Twitch wiederholt die EventSub-Zustellung bis zu 10 Minuten nach dem ersten fehlgeschlagenen Versuch. Kommt der Bot innerhalb dieses Zeitfensters wieder online, wird die Benachrichtigung zugestellt. Events, die älter als 10 Minuten sind, werden von Twitch nicht erneut gesendet.
- Kann ich eine Benachrichtigung erhalten, wenn der Stream endet?
- Stream-Ende-Benachrichtigungen (stream.offline) werden im Dashboard noch nicht unterstützt, sind aber in Planung. Die EventSub-Infrastruktur verarbeitet diesen Event-Typ bereits intern.
- Wie viele Twitch-Streamer kann ich pro Server hinzufügen?
- Bis zu 25 Twitch-Subscriptions pro Discord-Server.