Discord verbinden

Chatlix bringt einen echten Discord-Bot mit (kein reiner Webhook-Trick). Der Bot läuft mit eigenem Bot-Token, wird per OAuth auf deinen Server eingeladen und postet dort Events aus deinem Stream. Wenn du keinen Bot in deinem Server willst oder kein Admin bist, nimm stattdessen die Pure-Webhook-Variante.

Wofür?

Wenn du Chatlix mit Discord verbindest, kann der Bot in deinem Server:

• Stream-Alerts posten, wenn du live gehst oder offline gehst.
• Raid-Alerts posten, wenn dein Stream geraided wird.
• Shoutouts für andere Streamer in einen Channel pushen.
• Songrequests und Giveaways in dedizierten Channels ankündigen.
• Mod-Alerts posten (Bans/Timeouts/Smart-Shield-Events).

Es gibt zusätzlich eine Role-Mapping-Konfiguration (Subscriber/VIP/Mod → Discord-Rolle). Wichtig: das ist aktuell nur eine Einstellungs-UI — automatisch vergeben wird darüber (Stand 2026-07) noch keine Rolle. Details und der Grund dafür stehen auf der Seite Rollen syncen.

Voraussetzungen

• Du bist Server-Admin (oder hast "Manage Server") auf dem Discord-Server, den du verbinden willst.
• Du bist mit Chatlix per Twitch eingeloggt.

Schritt 1 — OAuth Connect

1. Öffne im Dashboard Discord (/dashboard/discord).
2. Klick Discord verbinden.
3. Es öffnet sich der Discord-OAuth-Dialog (mit State-Parameter abgesichert, serverseitig gegen Redis validiert). Bestätige.
4. Du landest zurück im Chatlix-Dashboard. Dein Discord-Account ist verlinkt, deine Server-Liste erscheint.

Technisch: dieser OAuth-Schritt dient nur dazu, deinen Discord-Account zu identifizieren und dir die Server-Auswahl zu zeigen, in denen du Admin bist — Chatlix muss dafür keine dauerhaften User-Zugriffstoken speichern. Alle späteren Bot-Aktionen (Posten, Rollen setzen) laufen über den Bot-Token von Chatlix selbst, nicht über deinen persönlichen OAuth-Token.

Schritt 2 — Bot einladen

1. Auf der Discord-Seite siehst du jetzt eine Liste deiner Discord-Server.
2. Wähle den Server, in dem der Bot posten soll.
3. Klick Bot einladen.
4. Discord öffnet die Autorisierungs-Seite. Wähle den Server, bestätige die Berechtigungen.
5. Zurück im Dashboard erscheint der Server-Status als "Bot ist online" (bot_status = online).

Der Bot fordert an: View Channels, Send Messages, Embed Links, Attach Files, Read Message History, Use External Emojis, Add Reactions und Manage Roles (Manage Roles nur für das Role-Mapping-Feld, siehe oben — genutzt wird es aktuell nicht automatisch).

Schritt 3 — Channels mappen

Auf der Server-Detail-Seite siehst du eine Liste von Channel-Purposes (die einzigen aktuell unterstützten Werte):

Pro Purpose wählst du einen Channel aus der Dropdown. Du musst nicht alle Purposes belegen — leer lassen heisst, der Bot postet diese Kategorie nicht. Wenn die Channel-Liste leer bleibt, obwohl der Bot im Server ist: siehe Troubleshooting.

Schritt 4 — Test

Auf jedem Purpose-Mapping kannst du Test-Post klicken. Wenn alles passt, kommt sofort eine Test-Nachricht im Channel an. Es gibt keinen entsprechenden Test-Button für Rollen — siehe dazu die Seite Rollen syncen.

Welche Events lösen wirklich einen Post aus?

Nicht jedes theoretisch mögliche Twitch-Event ist heute verdrahtet. Live sind:

• stream.online → Post in stream_alerts
• stream.offline → optionaler Post in stream_alerts
• channel.raid → Post in raid_alerts
• Shoutout-Trigger (aus dem Dashboard/Automation) → Post in shoutouts
• Songrequest- und Giveaway-Events aus den jeweiligen Chatlix-Modulen → Post in songrequests / giveaways

Sub-Events, Follow-Events und Mod/VIP-Updates lösen aktuell keinen Discord-Channel-Post aus (nur Rollen-relevant, siehe nächste Seite — und auch das läuft nicht automatisch).

Discord trennen

Über Discord trennen im Dashboard entfernst du die Connection. Mappings bleiben in der Datenbank erhalten (nur disconnected_at wird gesetzt) — wenn du dich neu verbindest und denselben Server wählst, sind Channel- und Role-Mappings sofort wieder aktiv.