Referenz

Bot-Befehle

Alle verfügbaren Befehle und automatischen Aktionen auf einen Blick.


Verfügbare Befehle

Befehle werden als normale Nachricht im Matrix-Space oder im DM mit dem Bot eingegeben.

Berechtigungen: Befehle mit der Markierung Admin können nur von Space-Administratoren (Power-Level ≥ 50) ausgeführt werden.
Befehl Wo Berechtigung Beschreibung
!setup Im Space Admin Startet den Einrichtungs-Dialog per DM. Verbindet den Space mit einem Twitch-Kanal und konfiguriert Live-Raum und Subscriber-Raum. Kann jederzeit erneut ausgeführt werden, um die Konfiguration zu ändern.
In Planung: !status (aktuelle Konfiguration), !stats (Sub-Statistiken), !reload (Konfiguration neu laden).

Der !setup Dialog

Nach !setup führt der Bot per DM durch folgende Schritte:

Schritt Bot fragt Erwartete Antwort
1 „Wie heißt dein Twitch-Kanal?" Dein Twitch-Login-Name, z.B. meinkanal
2 Sendet einen Twitch-OAuth-Link Link öffnen und Zugriff bestätigen
3 „Welcher Raum = Live-Benachrichtigungen?" (nummerierte Liste) Zahl des gewünschten Raums, z.B. 1
4 „Welcher Raum = Subscriber-Raum?" (nummerierte Liste) Zahl des gewünschten Raums, z.B. 2
5 Bestätigung mit Zusammenfassung Keine Antwort nötig – Setup abgeschlossen

Automatische Aktionen

Diese Aktionen laufen vollautomatisch nach abgeschlossenem Setup – ohne Befehle.

Twitch-Event Ziel-Raum Was passiert
stream.online Live-Raum Bot postet Live-Meldung mit Link zum Stream
stream.offline Live-Raum Bot postet Offline-Meldung
channel.subscribe Sub-Raum Neuer Subscriber wird als @twitchname:chattygo.de eingeladen + Begrüßung
channel.subscription.message Sub-Raum Re-Subscriber wird eingeladen (falls noch nicht im Raum) + Glückwunsch
channel.subscription.gift Sub-Raum Ankündigung mit Gifter-Name und Anzahl der verschenkten Abos

Technische Details

Eigenschaft Wert
Bot Matrix-ID @chatybot:chattygo.de
Bot Home-Server matrix.chattygo.de
Twitch OAuth Scope channel:read:subscriptions
Verschlüsselung (E2EE) Nicht unterstützt – Räume müssen unverschlüsselt sein
Benötigte Bot-Rechte Admin (Power-Level 100) – für Einladungen in Unterräume
Webhook-Endpunkt https://bot.chatygo.de/webhook

Bereit loszulegen?

Die Schritt-für-Schritt Anleitung führt dich durch die komplette Einrichtung.

Zur Anleitung