Shoutouts Troubleshooting

"Target not found" / `not_found`

Streamer-Login korrekt? Achte auf die exakte Schreibweise. Chatlix sucht über Helix nach login (lowercase, 3-25 Zeichen, nur a-z 0-9 _) — Logins außerhalb dieses Formats werden schon vorher mit invalid_login abgelehnt, bevor überhaupt ein Twitch-Lookup passiert.
Streamer-Account in Twitch gesperrt / gelöscht? Helix liefert dann effektiv "nicht gefunden".
Gerade erst umbenannt? Ein "nicht gefunden"-Ergebnis wird nur 15s gecacht — nach spätestens 15s nochmal probieren, falls der Login gerade frisch existiert.

"Konnte gerade nicht geprüft werden" / `helix_unavailable`

Das ist ein anderer Fall als "not_found": Twitch selbst antwortet nicht sauber (Auth-Problem, Rate-Limit, 5xx). Chatlix verkauft das bewusst nicht als "Streamer existiert nicht" — die Bot-Antwort ist eine neutrale "bitte gleich nochmal"-Meldung.
Meist selbstheilend innerhalb von Sekunden. Passiert es dauerhaft, ist die Twitch-Verbindung des Accounts vermutlich abgelaufen — neu verbinden/reauthorisieren.
Wird nie zwischengespeichert (kein Cache), damit ein einzelner Ausrutscher nicht 30s lang alle Shoutouts blockiert.

"cooldown" als Result

Globaler Cooldown läuft noch (default 60s seit dem letzten erfolgreichen Shoutout, egal ob per Chat, Dashboard oder Automation ausgelöst). Im History-Tab siehst du den letzten ok-Eintrag.
Per-Target-Cooldown läuft noch (default 600s = 10 Min). Derselbe Streamer kann erst nach Ablauf nochmal geshoutet werden — auch wenn der globale Cooldown längst vorbei ist.

Lösung: warten, oder Cooldown in Shoutouts → Settings senken (0-3600s global, 0-86400s pro Target — mit Bedacht senken, sonst nervt Dauerspam deine Mods). Details zur Cooldown-Logik in Shoutouts Grundlagen.

!so / !shoutout reagiert im Chat gar nicht

Bist du Mod oder Broadcaster? !so/!shoutout sind mod-only — normale Zuschauer bekommen schlicht keine Reaktion, das ist kein Bug.
Hast du versehentlich einen eigenen Custom-Command !so oder mit Alias so/shoutout angelegt? Das geht beim Speichern eigentlich nicht durch (reservierter Trigger), aber falls doch ein alter Command so heißt: er wird beim Chatten ignoriert, nicht ausgeführt — der eingebaute Shoutout-Handler hat immer Vorrang.
Ohne Zielangabe (nur !so) kommt eine Hinweiszeile statt eines Shoutouts — kein Fehler, sondern Absicht.

Browser-Source-URL mit Token kopiert? Der Token ist Bestandteil der URL (?token=...) und zugleich die einzige Auth — ohne Token lädt das Overlay nichts.
Browser-Source Always Active aktiviert? Ohne das reagiert die Source nicht, solange sie nicht in der sichtbaren Szene liegt.
OBS-Cache: Browser-Source rechtsklick → Refresh drücken.
Source in der aktiven Szene sichtbar?
Token kürzlich regeneriert? Dann ist die alte URL in OBS sofort ungültig — neue URL aus dem Dashboard holen und in OBS einfügen. Siehe Templates und Presets.

"Wo ist der echte Twitch-Shoutout-Effekt?"

Kurz: den gibt es in Chatlix nicht. Es ist kein Bug und keine fehlende Berechtigung — Chatlix ruft den offiziellen Twitch-Helix-Shoutout-Endpoint schlicht nie auf, es gibt dafür keinen Code-Pfad und keinen Scope-Request. Was du siehst (Overlay-Banner, Chat-Message, Discord-Post) ist der komplette Funktionsumfang. Willst du zusätzlich den Twitch-eigenen Sidebar-Shoutout, tippe /shoutout <name> direkt im Twitch-Chat — das ist ein reines Twitch-Feature und läuft unabhängig von Chatlix. Mehr dazu in Shoutouts Grundlagen.

Template-Variablen werden nicht ersetzt

Schreibweise: {user} mit geschweiften Klammern, nicht [user] oder %user%.
Bei {game} / {title}: ist der Ziel-Streamer offline, liefert Twitch keine Stream-Info — die Felder bleiben leer, der Shoutout selbst funktioniert trotzdem.
Template leer gelassen? Dann greift automatisch der Fallback Schaut bei {url} vorbei 👀 Zuletzt gespielt: {game}, kein Fehler.

Discord-Shoutout-Post bleibt aus

Discord verbunden und ein Channel mit Zweck shoutouts gemappt? Ohne dieses Mapping passiert beim Discord-Schritt einfach nichts (No-Op, kein Fehler im Dashboard sichtbar).
Bot hat Send-Messages-Permission im gemappten Channel?
Ein Fehlschlag beim Discord-Post killt niemals den restlichen Shoutout — Overlay und Chat-Message laufen unabhängig davon durch. Wenn nur Discord fehlt, der Rest aber funktioniert, ist das erwartetes Verhalten und kein Grund zur Sorge.

Mein eigener Shoutout-Sound spielt nicht

Sound-URL überhaupt gesetzt? Sound ist eine globale Einstellung unter Shoutouts → Settings, nicht Teil der Overlay-Presets — die fünf Presets in Templates und Presets ändern nur die Optik.
Sound-URL muss mit http:// oder https:// beginnen — alles andere wird beim Speichern stillschweigend verworfen (Feld bleibt leer).
Browser-Source in OBS auf Audio Monitoring "Monitor and Output" stellen, sonst hört dein Stream den Sound nicht.
Custom-Sound-URL muss public + CORS-tauglich sein. Wenn unsicher, Sound in die Chatlix-Media-Library hochladen, dann nutzt das Asset eine Chatlix-eigene URL.