Setup-Guide

chatybot einrichten

Schritt-für-Schritt – von Null bis zum laufenden Bot. Dauert ca. 5 Minuten.

Voraussetzungen

Was du brauchst

Matrix-Account

Auf einem beliebigen Matrix-Server. Nutze deinen Account auf chatygo.de oder deinem eigenen Server.
Jetzt auf chatygo.de registrieren →

Twitch-Kanal

Ein aktiver Twitch-Account mit Broadcaster-Rechten – also deinen eigenen Kanal.

Matrix-Space

Ein Space auf deinem Matrix-Server, in dem du Admin-Rechte hast. Du kannst einen neuen erstellen oder einen bestehenden nutzen.

Hinweis: Dein Matrix-Account und dein Space müssen auf chatygo.de erstellt sein. Melde dich einfach mit deinem Twitch-Account auf chat.chatygo.de an – kein separates Passwort nötig.
Phase 1

Bot einladen

Folge den Schritten der Reihe nach.

Schritt 1

Space öffnen oder erstellen

Öffne deinen Matrix-Client (z.B. Element) und navigiere zu deinem Space. Falls du noch keinen hast: neuen Space über das „+" Symbol in der linken Seitenleiste erstellen.

Schritt 2

Unterräume anlegen (empfohlen)

Erstelle zwei Räume in deinem Space, bevor du den Bot einlädst: einen für Live-Benachrichtigungen (z.B. „News") und einen für Subscriber (z.B. „SUB-Only"). Du wählst sie später im Setup-Dialog aus.

Schritt 3

Bot in den Space einladen

Space-Einstellungen → „Mitglieder" → „Person einladen". Diese Matrix-ID eingeben:

@chatybot:chattygo.de

Der Bot tritt via Matrix-Federation automatisch bei – das kann einige Sekunden dauern.

Schritt 4

Bot zum Admin machen

Space-Einstellungen → „Rollen & Berechtigungen" → Power-Level von @chatybot:chattygo.de auf Admin (100) setzen. Der Bot braucht Admin-Rechte, um Subscriber einzuladen.

Schritt 5

Willkommensnachricht abwarten

Der Bot sendet automatisch eine Nachricht im Space. Wenn sie erscheint, ist er bereit für den nächsten Schritt.

Phase 2

Setup-Dialog

Der Bot führt dich per DM durch die Einrichtung.

Schritt 1

!setup tippen

Schreibe !setup als Nachricht in einen Raum deines Spaces. Nur Admins können diesen Befehl ausführen.

Der Bot öffnet ein privates DM-Gespräch mit dir und führt dich durch alle weiteren Schritte.
Schritt 2

Twitch-Kanal eingeben

Der Bot fragt nach deinem Twitch-Login-Namen. Antworte mit deinem Kanal-Namen (nur der Name, z.B. meinkanal).

Schritt 3

Twitch-Autorisierung

Der Bot sendet dir einen Autorisierungs-Link. Klicke darauf und bestätige den Zugriff auf channel:read:subscriptions.

Der Link ist 10 Minuten gültig. Danach einfach !setup erneut starten.
Schritt 4

Live-Raum auswählen

Der Bot zeigt eine nummerierte Liste aller Räume in deinem Space. Antworte mit der Nummer des Raums für Live-Meldungen.

Schritt 5

Subscriber-Raum auswählen

Genauso: Nummer des Raums eingeben, in den neue Subscriber eingeladen werden sollen.

Phase 3

Fertig

Abgeschlossen

Vollautomatisch ab sofort

Der Bot bestätigt mit einer Zusammenfassung und registriert alle Twitch-Events. Ab sofort läuft alles automatisch:

  • Neue Subscriber werden automatisch in den Subscriber-Raum eingeladen
  • Re-Subs und Gift-Subs erhalten eine Ankündigung im Subscriber-Raum
  • Stream online/offline postet eine Meldung im Live-Raum
Hilfe

Häufige Probleme

Problem

Bot tritt dem Space nicht bei

Prüfe ob Federation auf deinem Matrix-Server aktiviert ist. Frage deinen Server-Administrator – manche Server haben Federation deaktiviert. Auf chatygo.de läuft der Bot auf demselben Server – Federation wird nicht benötigt.

Problem

„Du hast keine Berechtigung" beim !setup

Nur Nutzer mit Power-Level ≥ 50 können den Setup-Befehl ausführen. Prüfe deine Rechte in den Space-Einstellungen unter „Rollen & Berechtigungen".

Problem

OAuth-Link abgelaufen

OAuth-Links sind nur 10 Minuten gültig. Starte das Setup mit !setup einfach neu.

Problem

Subscriber erscheinen nicht im Subscriber-Raum

Prüfe ob der Bot Admin-Rechte im Subscriber-Raum hat – nicht nur im Space. Der Bot muss in jedem Raum einladen dürfen.

Noch Fragen?

Alle Bot-Befehle und automatischen Aktionen auf einen Blick:

Befehle ansehen