Custom Bot Account

Standardmäßig postet AveloBot in deinem Chat unter dem geteilten AveloBot-Account, den dein Betreiber laufen lässt. Mit dem Pro-Feature Custom Bot verbindest du einen Twitch-Account, der dir gehört, und AveloBot postet ab dann unter diesem Namen — gleiche Bot-Logik, nur eine andere Identität im Chat. Typische Gründe dafür: Der Chat soll @deinnamebot statt @avelobot lesen, oder du willst Nachrichten einfach unter Zugangsdaten rausgehen lassen, die in deiner Hand liegen.

Die Seite findest du unter /pro/custom-bot. Sie ist nur für den Workspace-Owner sichtbar — einen Twitch-Account zu verbinden wirkt sich auf den ganzen Workspace aus, und der OAuth-Flow braucht die Session des Broadcasters, um die Aktion korrekt zuzuordnen.

Bevor du anfängst

Du brauchst zwei Dinge:

• Das Entitlement pro.custom-bot auf deinem Workspace. Ohne dieses zeigt die Seite eine „Pro required"-Karte mit einem Link zurück zur Pro-Übersicht; der Connect-Button ist dann ausgeblendet.
• Einen separaten Twitch-Account für den Bot. Twitch erlaubt nicht, dass derselbe Account gleichzeitig Broadcaster und Bot ist — der Bot-Account muss also ein anderer sein als deiner. Jeder ungenutzte oder frisch angelegte Twitch-Account passt; viele Streamer legen sich gezielt einen <kanalname>bot-Account dafür an.

Bot-Account verbinden

1. Melde dich in einer separaten Browser-Session (oder einem Inkognito-Fenster) bei Twitch mit dem Bot-Account an. Genau hier passiert der häufigste Fehler — wenn dein normales Browserfenster mit dem Broadcaster eingeloggt ist, würde der nächste Schritt stillschweigend diesen Account nehmen.
2. In AveloBot auf /pro/custom-bot auf Connect Bot Account klicken.
3. Die Twitch-Autorisierungsseite öffnet sich. Wähle den Bot-Account, nicht deinen Broadcaster. AveloBot erzwingt die Twitch-Account-Auswahl, sodass du eine bewusste Entscheidung treffen musst — aber dir wird nur die Session vorgesetzt, in der du gerade eingeloggt bist, also zählt Schritt 1.
4. Bestätige die angefragten Scopes. Es sind dieselben, die der geteilte Bot nutzt: Chat lesen/senden plus ein paar Helfer.
5. Du landest wieder auf /pro/custom-bot und siehst Connected as <bot_login>, dazu Display-Name, gewährte Scopes, Verbindungszeitpunkt und Token-Ablauf.

AveloBot prüft die Verbindung danach noch einmal serverseitig: Hat Twitch denselben Account zurückgegeben, der bereits dein Broadcaster ist, oder fehlt einer der nötigen Scopes, wird die Verbindung nicht gespeichert. Du bekommst dann ein Fehler-Banner mit dem konkreten Grund.

Was sich nach dem Verbinden ändert

• Neue Chat-Nachrichten von AveloBot erscheinen unter dem Namen und Avatar deines Bot-Accounts statt unter AveloBot.
• Die Aktion wird im Admin-Audit-Log als tenant.custom-bot.connected festgehalten.
• Alles andere läuft unverändert weiter: Built-in-Befehle, eigene Befehle, Counter, Timer, Event-Reaktionen. Nur die Identität, unter der gepostet wird, wechselt.

Neu autorisieren

Twitch-Tokens laufen rollierend ab, und AveloBot erneuert sie automatisch. Die zwei Situationen, in denen das automatische Erneuern nicht mehr durchgeht:

• Der Bot-Account hat sein Passwort geändert.
• Die AveloBot-App wurde in den Twitch-Einstellungen des Bot-Accounts widerrufen.

In beiden Fällen kippt die Seite auf einen roten Banner Bot connection needs re-authorization. Bis du das beheben kannst, fällt AveloBot auf den geteilten Bot zurück, dein Chat läuft also weiter — kein stiller Ausfall. Klicke Reconnect, um den OAuth-Flow mit dem Bot-Account noch einmal zu durchlaufen.

Verbindung trennen

Klicke Disconnect auf der Seite und bestätige. AveloBot widerruft die Twitch-Tokens, entfernt den gespeicherten Verbindungseintrag und schreibt einen Audit-Eintrag. Ab der nächsten Nachricht postet wieder der geteilte Bot.

Wenn dein Pro-Entitlement endet

Die gespeicherte Bot-Verbindung wird nicht gelöscht — AveloBot hört nur auf, sie zu nutzen, und fällt auf den geteilten Bot zurück. Aktivierst du Pro später wieder (Verlängerung, neue Freischaltung, …), wacht die Verbindung automatisch auf. Eine erneute OAuth-Runde ist dafür nicht nötig.

Troubleshooting

Symptom	Wahrscheinliche Ursache	Lösung
Twitch-Autorisierungsseite zeigt deinen Broadcaster, nicht den Bot.	Im selben Browser ist noch der Broadcaster bei Twitch eingeloggt.	Inkognito-Fenster für die OAuth-Runde nutzen, oder im Hauptfenster vorher abmelden.
Fehler „Bot account must differ from broadcaster".	Auf der Twitch-Seite wurde der Broadcaster gewählt.	Connect-Vorgang mit dem richtigen Account neu starten.
Fehler „Missing scopes".	Auf dem Twitch-Bestätigungsdialog wurde ein Scope abgelehnt.	Neu verbinden und alle Scopes bestätigen.
Bot-Verbindung in Rot („needs reauthorization").	Token-Erneuerung abgelehnt — meist Passwortwechsel oder App-Widerruf am Bot-Account.	Reconnect klicken.
Chat-Nachrichten kommen weiterhin von AveloBot.	Pro-Entitlement nicht aktiv für deinen Workspace, oder die Verbindung steht im „needs reauth"-Zustand.	Status auf /pro prüfen, Verbindungsstatus auf /pro/custom-bot.