Custom Bot Account

Standardmäßig postet AveloBot in deinem Chat unter seiner Standard-AveloBot-Identität. Das Pro-Feature Custom Bot ersetzt diese Standard-Identität durch einen eigenen Twitch-Account: AveloBot wendet weiterhin dieselbe Bot-Logik an, die Nachrichten erscheinen jedoch unter dem verbundenen Account. Das Feature wird typischerweise eingesetzt, wenn Chat-Nachrichten unter einem vom Broadcaster kontrollierten Namen erscheinen sollen, etwa @deinnamebot statt @avelobot.

Die Feature-Seite befindet sich unter /pro/custom-bot. Zugriff hat ausschließlich der Workspace-Owner. Das Verbinden eines Twitch-Accounts wirkt sich auf den gesamten Workspace aus, und der OAuth-Flow benötigt die Session des Broadcasters, um die Aktion korrekt zuzuordnen.

Voraussetzungen

Zwei Voraussetzungen müssen erfüllt sein:

• Das Entitlement pro.custom-bot für deinen Workspace. Fehlt das Entitlement, zeigt die Seite eine Pro required-Karte mit einem Link zurück zur Pro-Übersicht; der Connect-Button ist dann ausgeblendet.
• Ein separater Twitch-Account für den Bot. Twitch erlaubt es nicht, dass derselbe Account gleichzeitig Broadcaster und Bot ist. Der Bot-Account muss sich also vom Broadcaster-Account unterscheiden. Jeder ungenutzte oder neu angelegte Twitch-Account ist geeignet; gebräuchlich ist es, einen Account mit dem Namen <kanalname>bot für diesen Zweck anzulegen.

Bot-Account verbinden

1. Melde dich in einer separaten Browser-Session (oder einem Inkognito-Fenster) bei Twitch mit dem Bot-Account an. Dieser Schritt ist die häufigste Fehlerquelle: Ist dein regulärer Browser noch mit dem Broadcaster bei Twitch angemeldet, wird der folgende Schritt diesen Account standardmäßig verwenden.
2. Klicke in AveloBot auf /pro/custom-bot auf Connect Bot Account.
3. Die Twitch-Autorisierungsseite öffnet sich. Wähle den Bot-Account, nicht den Broadcaster. AveloBot erzwingt die Twitch-Account-Auswahl, damit eine bewusste Auswahl getroffen werden muss.
4. Bestätige die angefragten Scopes. Sie decken die Chat-Lese- und Sende-Berechtigungen ab, die AveloBot benötigt, sowie eine kleine Anzahl unterstützender Scopes.
5. Du wirst zurück auf /pro/custom-bot geleitet. Die Seite zeigt nun Connected as <bot_login>, ergänzt um Anzeigename, gewährte Scopes, Verbindungszeitpunkt und Token-Ablauf.

AveloBot validiert die Verbindung serverseitig. Gibt Twitch den Broadcaster-Account zurück oder fehlt einer der erforderlichen Scopes, wird die Verbindung nicht gespeichert; auf der Seite erscheint ein Fehler-Banner mit dem konkreten Prüfgrund.

Nach dem Verbinden

• Chat-Nachrichten, die AveloBot postet, erscheinen nun unter dem Namen und Avatar des Bot-Accounts statt unter AveloBot.
• Die Aktion wird im Admin-Audit-Log als tenant.custom-bot.connected festgehalten.
• Alle übrigen Funktionen laufen unverändert weiter: Built-in-Befehle, eigene Befehle, Counter, Timer und Event-Reaktionen. Es ändert sich ausschließlich die Identität, unter der gepostet wird.

Neu autorisieren

Twitch-Access-Tokens werden von AveloBot automatisch erneuert. Die automatische Erneuerung schlägt in zwei Fällen fehl:

• Das Passwort des Bot-Accounts wurde geändert.
• Die AveloBot-App wurde in den Twitch-Einstellungen des Bot-Accounts widerrufen.

In beiden Fällen zeigt die Seite einen roten Banner Bot connection needs re-authorization. Bis die Verbindung wiederhergestellt ist, fällt AveloBot auf seine Standard-Chat-Identität zurück, sodass der Chat weiterhin funktioniert. Klicke Reconnect, um den OAuth-Flow mit dem Bot-Account erneut zu durchlaufen.

Verbindung trennen

Klicke Disconnect auf der Seite und bestätige. AveloBot widerruft die Twitch-Tokens, entfernt den gespeicherten Verbindungseintrag und schreibt einen Eintrag ins Audit-Log. Ab der nächsten Nachricht postet AveloBot wieder unter seiner Standard-Chat-Identität.

Wenn das Pro-Entitlement endet

Die gespeicherte Bot-Verbindung wird nicht gelöscht; AveloBot stellt lediglich die Nutzung ein und fällt auf seine Standard-Chat-Identität zurück. Wird das Pro-Entitlement später reaktiviert (durch Verlängerung oder eine neue Freischaltung), wird die Verbindung automatisch wieder aktiv. Eine neue OAuth-Runde ist nicht erforderlich.

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.