YouTube-Benachrichtigungen
Neue YouTube-Inhalte sofort in Discord ankündigen
Das YouTube-Benachrichtigungsmodul überwacht bis zu 15 YouTube-Kanäle und postet automatisch eine Nachricht in einen Discord-Channel, sobald ein neues Video, Short, Live-Stream oder Premiere erscheint. Für jeden Inhaltstyp lässt sich ein eigener Discord-Channel und eine eigene Nachricht konfigurieren.
Einrichten
- YouTube-Benachrichtigungen im Dashboard aktivieren
- Kanal hinzufügen: YouTube-URL einfügen (Kanal-URL, Handle, oder Video-URL)
- Bot löst den Kanal auf und zeigt eine Vorschau (Name, Avatar, Abonnentenzahl)
- Ziel-Discord-Channel auswählen (gilt als Fallback für alle Typen)
- Gewünschte Video-Typen aktivieren (Video, Short, Live, Premiere)
- Optional: Separate Channels und Nachrichtentemplate pro Typ konfigurieren
- Speichern
Unterstützte YouTube-URL-Formate
Beim Hinzufügen akzeptiert der Bot verschiedene URL-Formate:
youtube.com/channel/UC...youtube.com/@handleyoutube.com/c/kanalnameBeliebige Video-URL des Kanals (youtube.com/watch?v=...)
Video-Typen
| Typ | Wann ausgelöst |
|---|---|
video | Reguläres YouTube-Video (Länge > 60 s) |
short | YouTube Short (Vertical, max. 60 s) |
live | Live-Stream beginnt |
premiere | Premiere (vorankündigtes Video mit Countdown) |
Nachrichtentemplate
Der Standard-Template lautet: {channel_name} hat ein neues {type} hochgeladen! — gefolgt von der URL. Du kannst ihn frei anpassen.
| Variable | Inhalt |
|---|---|
{channel_name} | Name des YouTube-Kanals |
{title} | Titel des Videos |
{url} | Direktlink zum Video |
{type} | Typ (video / short / live / premiere) |
{duration} | Dauer des Videos (leer bei Live-Streams) |
{published_at} | Veröffentlichungsdatum |
Beispiel: 🎬 **{channel_name}** hat ein neues Video veröffentlicht: **{title}**\n{url}Rollen-Erwähnungen
Pro Subscription kannst du bis zu 20 Rollen eintragen, die beim Post erwähnt werden. Die Erwähnungen werden dem Nachrichtentemplate automatisch vorangestellt.
Benachrichtigungs-Mechanismus
Primär: WebSub (PubSubHubbub) — Google sendet eine Echtzeit-Benachrichtigung, sobald ein neues Video erscheint. Latenz typischerweise unter 1 Minute.
Fallback-Polling: Wenn WebSub keine Benachrichtigung sendet (passiert gelegentlich), fällt der Bot auf RSS-Polling zurück. Aktive Kanäle (letztes Video vor weniger als 7 Tagen): alle 15 Minuten. Inaktive Kanäle: alle 60 Minuten.
Grenzen
| Einstellung | Limit |
|---|---|
| Max. Subscriptions pro Server | 15 |
| Rollen-Erwähnungen pro Subscription | 20 |
| Template-Länge | max. 2.000 Zeichen |
History-Tab
Der History-Tab zeigt für jede Subscription alle zuletzt gesendeten und fehlgeschlagenen Benachrichtigungen: Video-Titel, Typ, Ziel-Channel, Status (sent/failed/skipped/rate_limited), Zeitstempel und Fehlermeldung (bei Fehler).
Fehlersuche
- Keine Benachrichtigung für neues Video
- Prüfe den History-Tab: Steht dort "failed"? Dann hat der Bot das Video erkannt, aber die Discord-Nachricht ist fehlgeschlagen. Prüfe Bot-Schreibrechte im Ziel-Channel. Steht gar kein Eintrag? Möglicherweise hat WebSub nicht gefeuert — warte das nächste Polling-Intervall (15 min für aktive Kanäle) ab.
- Doppelte Benachrichtigungen
- Stelle sicher, dass du denselben Kanal nicht zweimal abonniert hast. Deduplizierung verhindert Doppelposts innerhalb einer Subscription, nicht zwischen zwei Subscriptions desselben Kanals.
Häufige Fragen
- Wie schnell nach dem Upload kommt die Benachrichtigung?
- Mit WebSub typischerweise unter 1 Minute. Im Polling-Fallback bis zu 15 Minuten für aktive Kanäle.
- Kann ich denselben YouTube-Kanal für verschiedene Discord-Server abonnieren?
- Ja. Jeder Server hat seine eigene unabhängige Subscription.
- Was passiert mit den Benachrichtigungen, wenn der Bot kurz offline war?
- Videos, die während des Offline-Zeitraums erschienen sind, werden beim nächsten Polling-Durchlauf geprüft. Wenn das Video neu ist und noch nicht geloggt wurde, wird die Benachrichtigung nachträglich gesendet.