Direkt zum Hauptinhalt

Erste Reaction einrichten

Wir bauen jetzt die erste echte Reaction: Wenn jemand deinem Kanal folgt, schreibt dein Bot eine Willkommensnachricht in den Chat — und wenn du ein Overlay verbunden hast, poppt zusätzlich automatisch ein Follow-Alert auf.

Hinweis: Diese Seite wurde am 2026-07-08 vollständig gegen den Live-Code geprüft und korrigiert. Die alte Fassung beschrieb einen „Action-Typ: Combo" mit frei wählbarer Sound-Datei und Overlay-Vorlage — das gibt es in diesem Feature nicht. Was du hier konfigurierst, ist ausschließlich der Chat-Text. Der Overlay-Alert läuft separat und automatisch, gesteuert über den Tab „Alert-Steuerung".

Voraussetzungen

  • Ein aktiver Bot-Channel — ohne Bot zeigt /dashboard/events-reactions nur die Meldung „Kein Bot verbunden" mit Link zum Setup-Wizard.
  • Twitch-Konto in Chatlix verknüpft und die Dev-App des Betreibers registriert (Bereich „Event-Abos" zeigt sonst „⚠ Twitch-Dev-App noch nicht registriert" — Subscriptions landen dann als pending, aktivieren sich aber automatisch, sobald die App-Credentials hinterlegt sind).
  • Für den vollen Effekt (Overlay-Alert zusätzlich zur Chat-Nachricht): ein Overlay unter /dashboard/overlays eingerichtet und als Browser-Source in OBS geladen. Ohne Overlay kannst du trotzdem schon Chat-Reaktionen vorbereiten und speichern — der Tab „Testen" ist dann aber leer/deaktiviert.

Schritt 1 — EventSub-Abo aktivieren

Bevor eine Reaction feuern kann, muss Chatlix bei Twitch für das jeweilige Event abonniert sein. Das ist ein separater Schritt von der Reaction selbst:

  1. Im Dashboard zu /dashboard/events-reactions?tab=subscriptions (Tab Event-Abos).
  2. Suche 👋 Neuer Follower (Twitch-Topic channel.follow) in der Liste.
  3. Klick Subscribe. Twitch braucht 1–3 Sekunden für die Webhook-Verifikation — die Seite fragt automatisch nach 2 s und 5 s erneut nach, der Status wechselt von Wird aktiviert… auf Aktiv.

Bleibt der Status auf Fehlgeschlagen oder Twitch hat zurückgezogen: meistens fehlt ein Twitch-Scope. Konkret bekannte Fälle: channel:read:hype_train für die Hype-Train-Events, user:read:chat für Prime-Sub-Erkennung (sub_prime/sub_prime_upgrade laufen technisch über das Topic channel.chat.notification). Die Seite bietet dafür direkt einen Button 🔁 Twitch erneut verbinden — das holt die aktuellen Scopes nach.

Schritt 2 — Chat-Reaction anlegen

  1. Wechsle zum Tab Chat-Reaktionen (?tab=reactions).
  2. Ist noch keine Reaction konfiguriert, siehst du Schnellstart-Presets (aktuell für Follow, Sub, Raid) — ein Klick füllt das Template vor, du musst nur noch speichern. Für alles andere: die Karte für 👋 Neuer Follower suchen (die Liste zeigt aktive Reactions zuerst, dann pausierte, dann unkonfigurierte).
  3. Feld „Was antwortet chatlix_bot im Chat?" ausfüllen, z. B.: Willkommen im Channel, @{user}! 👋
  4. Optional Cooldown in Sekunden setzen (Standard 0 = kein Cooldown) und Bedingungen aufklappen (siehe Seite Reaction-Tiers für Details zu Bedingungen).
  5. Checkbox Aktiv gesetzt lassen, dann ✨ Einrichten klicken.

Direkt unter dem Textfeld zeigt Chatlix eine Live-Vorschau mit Platzhalterwerten (StreamerMax, 42, Tier 1 …) — so siehst du sofort, ob dein Text mit echten Werten Sinn ergibt, bevor überhaupt ein Event feuert.

Schritt 3 — Alert-Steuerung prüfen (nur relevant mit Overlay)

Wenn ein Overlay verbunden ist, feuert bei jeder aktiven Chat-Reaction automatisch auch ein visueller Alert. Willst du das für Follows an-/ausschalten, Sound stumm schalten oder die Priorität setzen (z. B. damit ein Raid-Alert einen Follow-Alert übertönt/überlagert):

  1. Tab ⚙️ Alert-Steuerung öffnen.
  2. Zeile 👋 Follow suchen, alert_enabled/sound_enabled und Priorität (low/normal/high/critical) einstellen.
  3. Speichern passiert pro Zeile sofort beim Ändern, keine gesonderte „Speichern"-Aktion nötig.

Im selben Tab siehst du einen Alert-Verlauf (letzte 25 Einträge) mit Status wie ausgelöst, wiederholt, gemutet, verfallen — inklusive eines Re-Fire-Buttons, der einen Alert erneut an alle verbundenen Overlays schickt. Ehrlicher Hinweis aus dem UI-Code: Re-Fire meldet explizit zurück, wenn „kein Overlay/Browser-Source verbunden" war — es wird kein Fake-Erfolg vorgetäuscht.

Schritt 4 — Testen, ohne dass jemand wirklich folgt

Es gibt zwei Wege zu testen:

  • Kleiner 🔔-Button direkt an der Reaction-Karte (Tab „Chat-Reaktionen") — feuert sofort einen simulierten Follow an dein verbundenes Overlay.
  • Tab „🔔 Testen" — größere Kachel-Ansicht mit Testbuttons für Follow, Sub, Raid, Cheer, Chat-Keyword, Resub, Host, Goal. Zeigt danach eine Live-Vorschau „Das sehen deine Zuschauer" inklusive Hinweis, dass chatlix_bot gleich im Chat schreibt und der Alert in OBS läuft.

Beide Wege brauchen ein verbundenes Overlay — ohne Overlay ist der Test-Button ausgegraut mit dem Hinweis „Kein Overlay eingerichtet". Kommt trotz aktiver Reaction und verbundenem Overlay kein sichtbarer Alert: Browser-Source in OBS prüfen (URL korrekt geladen, nicht „inaktiv"?), dann den Alert-Verlauf im Tab „Alert-Steuerung" ansehen — steht dort „gemutet", ist alert_enabled für den Event-Typ aus.

Schritt 5 — Echten Follow abwarten

Twitch liefert EventSub-Events meist innerhalb von 1–5 Sekunden, in Ausnahmefällen später. Steht die Subscription auf Aktiv und die Reaction ist Aktiv (grüner Punkt auf der Karte), sollte beim nächsten echten Follow sowohl die Chat-Nachricht als auch — bei verbundenem Overlay — der Alert erscheinen. Kommt gar nichts an: zuerst den Tab „Event-Abos" prüfen, ob die Subscription wirklich noch Aktiv ist (Twitch kann Abos zurückziehen, Status wechselt dann auf „Twitch hat zurückgezogen").

Variablen, die im Follow-Template verfügbar sind

Für follow gibt es nur {user} (Display-Name des Followers). Andere Event-Typen haben andere Variablensätze — die vollständige, code-geprüfte Übersicht steht auf der Seite Event Reactions verstehen. Wichtig, weil es in älteren Notizen anders stand: Es gibt kein generisches {raid_size} (richtig ist {viewers}) und kein generisches {bits} (richtig ist {amount}). Unbekannte Variablen werden nicht leer ersetzt, sondern unverändert stehen gelassen — {tier} in einem Follow-Template bleibt wörtlich {tier} im ausgegebenen Text. Das ist Absicht: Der Streamer soll im Test sofort sehen, wenn eine Variable nicht existiert, statt eine leere Lücke zu übersehen.

Reaction temporär deaktivieren

Auf der Karte gibt es neben dem 🔔-Test-Button einen ⏸/▶-Button. Pausiert = die Reaction bleibt gespeichert, wird aber bei eingehenden Events ignoriert. Praktisch für Streampausen ohne die Konfiguration zu verlieren. Ganz löschen geht über den 🗑-Button (mit Sicherheits-Dialog).

Was kommt als Nächstes

  • Reaction-Tiers (Bits/Sub-Tiers) — wie du innerhalb der „nur eine Reaction pro Event-Typ"-Grenze trotzdem nach Stufe differenzierst.
  • Combos + Sequenzen — was an Mehrfach-Effekten wirklich geht, und ab wann du ins Buch Automations wechseln musst.