Shoutouts Grundlagen

Ein Shoutout ist eine kurze visuelle und/oder Chat-Empfehlung an einen anderen Streamer aus deinem Stream. Chatlix kombiniert dabei:

• Chatlix-Side: ein Overlay-Banner mit Stream-Vorschau, Spiel, Titel — optional mit Sound.
• Chat-Side: eine Bot-Message im Kanal-Chat mit deinem Template.
• Discord-Side: optional ein Discord-Post, wenn du einen Discord-Channel mit dem Zweck shoutouts gemappt hast (Format: "📣 Shoutout an <Name>" + Spiel + Link + Auslöser).

Wichtig, weil oft missverstanden: Es gibt keinen nativen Twitch-/shoutout-Effekt in Chatlix (kein Aufruf des offiziellen Twitch-Helix-Shoutout-Endpoints, kein moderator:manage:shoutouts-Scope, kein Eintrag in Twitchs eigener Sidebar). Was hier "Shoutout" heißt, ist ein Chatlix-eigenes Feature aus Overlay-Banner + Chat-Message + Discord-Post + Automations-Trigger. Willst du zusätzlich den echten Twitch-Sidebar-Shoutout, musst du den weiterhin selbst über Twitch auslösen — Chatlix macht das nicht für dich. (Details zum Overlay-Teil in Templates und Presets, Fehlerbilder in Shoutouts Troubleshooting.)

Was du brauchst

• Twitch-Verbindung in Chatlix (für den Helix-Lookup des Ziel-Streamers: Avatar, Spiel, Titel, Live-Status).
• Optional: Browser-Source in OBS für das Shoutout-Overlay (Setup siehe Templates und Presets).
• Optional: Discord verbunden + ein Channel mit Zweck shoutouts gemappt, wenn du den Discord-Post willst.

Auslöser

Drei Wege, einen Shoutout auszulösen:

1. Manuell im Dashboard — Shoutouts-Seite öffnen, Streamer-Login eintippen, auf "Shoutout" klicken. Läuft intern als source=manual.
2. Chat-Kommando — !so <login> oder !shoutout <login>. Beispiel: !so kevin oder !so @kevin (das @ wird automatisch entfernt, auch doppelt wie @@kevin). Diese beiden Trigger sind fest eingebaut und reserviert — du kannst sie nicht im Command-Builder umbenennen oder überschreiben; ein Custom-Command mit demselben Namen/Alias wird beim Speichern blockiert und im Chat stillschweigend ignoriert. Nur Mods und der Broadcaster dürfen !so/!shoutout im Chat auslösen — normale Zuschauer nicht. Ohne Ziel (nur !so) antwortet der Bot mit einer Hinweiszeile statt einen leeren Lookup loszuschicken.
3. Automation — Action shoutout_user in einer Automation-Regel, z.B. beim Trigger "Raid empfangen". Lässt du das Username-Feld leer, wird automatisch der Event-Akteur geshoutet (bei einem Raid also der Raider). Läuft technisch mit jedem Automation-Trigger, nicht nur Raids. Der intern dafür vorgesehene History-Source-Wert auto_raid existiert zwar im DB-Schema, wird aber von keinem aktuellen Code-Pfad gesetzt — Automation-Shoutouts landen im Verlauf faktisch mit source=command (der Wert automation ist nicht auf der erlaubten Liste und wird beim Speichern stillschweigend auf command zurückgesetzt).

Was passiert beim Shoutout?

1. Chatlix validiert den Login (3-25 Zeichen, nur a-z 0-9 _) und prüft die Cooldowns.
2. Chatlix fragt Twitch-Helix nach User-Info, Stream-Info, Channel-Info des Ziel-Streamers.
3. Erfolgreiche Lookups werden 30s gecacht (gegen Spam-Spike auf dieselben Targets). "Nicht gefunden" wird nur 15s gecacht, damit ein frisch angelegter Account nicht unnötig lange als "nicht gefunden" hängen bleibt. Ein technischer Twitch-Fehler (Auth/Rate-Limit/5xx) wird nie als "nicht gefunden" verkauft, sondern als eigener Code helix_unavailable zurückgegeben — sonst bekäme der Chat eine irreführende Antwort.
4. Overlay bekommt (wenn aktiviert) einen Banner-Burst mit Stream-Thumbnail, Spiel, Titel.
5. Chat-Bot postet optional eine Message mit deinem Template ({user}, {display_name}, {game}, {title}, {url}) — Details und Beispiele in Templates und Presets.
6. Discord-Post (wenn Channel gemappt) mit Name, Spiel, Link, Auslöser.
7. History-Eintrag mit Result (ok / not_found / cooldown / error / permission_denied).
8. Intern feuern zusätzlich die Events shoutout_started und shoutout_displayed, auf die eigene Automations-Regeln reagieren können.

Cooldowns

Zwei Cooldowns gleichzeitig aktiv — egal ob der Shoutout manuell, per Chat-Kommando oder per Automation ausgelöst wurde, sie zählen alle in dieselben Töpfe:

• Global: zwischen je zwei erfolgreichen Shoutouts (default 60s, einstellbar 0-3600s).
• Pro Target: zwischen je zwei Shoutouts an denselben Streamer (default 600s = 10 Min, einstellbar 0-86400s).

Werte konfigurierbar im Dashboard unter Shoutouts → Settings. Ein wegen Cooldown blockierter Versuch landet trotzdem als cooldown-Eintrag im Verlauf (mehr dazu in Shoutouts Troubleshooting).

Limits