Streamer.bot Adapter

Mit dem Streamer.bot Adapter empfängt Streamer.bot bestätigte KALYIX Tip-Events. Deine bestehenden Alert-Actions können bleiben. Du ersetzt nur alte Donation-Variablen durch KALYIX-Variablen.

Was du brauchst

Streamer.bot 1.0.4 oder neuer.
Die aktuelle KALYIX Streamer.bot Import-Datei aus den Downloads.
Einen Extension Token aus dem Extensions Dashboard.
Eine aktive KALYIX Tip-Page.

Einrichtung

Lade die Streamer.bot Import-Datei herunter.
Importiere die Datei in Streamer.bot.
Öffne die importierte Action KALYIX Setup.
Trage deinen Extension Token beim Argument bridgeToken ein.
Prüfe die Bridge URL beim Argument bridgeUrl:

wss://extensions.kalyix.de/extensions/ws

Prüfe im WebSocket Client KALYIX Tip Bridge, dass TLS auf TLS 1.2 oder Default/System steht.
Starte bei KALYIX Setup den importierten Test Trigger einmal. Dadurch speichert Streamer.bot Token, URL und WebSocket-Index.
Starte bei KALYIX Connect den importierten Streamer.bot Started Trigger einmal manuell oder nutze den zusätzlichen Test-Trigger, falls dein Import ihn enthält.
Öffne die Streamer.bot History. Nach dem Connect muss erst hello und danach auth.ok erscheinen.
Sende im Extensions Dashboard einen Test.
Erstelle oder öffne eine Alert-Action in Streamer.bot.
Nutze den Trigger KALYIX Tip Paid.

Nach dem ersten erfolgreichen Setup verbindet sich Streamer.bot beim nächsten Start automatisch, weil KALYIX Connect über den importierten Streamer.bot Started Trigger ausgeführt wird.

Importierte Actions und Trigger

Action	Trigger	Zweck
`KALYIX Setup`	`Core -> Test`	Nach dem Token-Eintrag einmal starten. Speichert Token, Bridge URL und WebSocket-Index.
`KALYIX Connect`	`Core -> Streamer.bot -> Started`	Verbindet Streamer.bot beim Start automatisch mit KALYIX.
`KALYIX Connect`	optional `Core -> Test`	Für den ersten manuellen Connect oder Troubleshooting ohne Streamer.bot Neustart.
`KALYIX WebSocket Message`	`Core -> WebSocket -> Client -> Message`	Verarbeitet `hello`, sendet Auth, empfängt Deliveries und sendet ACK.

Streamer.bot Events

Wenn ein bezahlter Tip oder ein Test-Event ankommt, löst der Adapter dieses Custom Event aus:

kalyix.tip.paid

In Streamer.bot findest du es als Custom Trigger. Danach kannst du normale Sub-Actions verwenden, zum Beispiel OBS, Sound, TTS, Log, Discord oder eigene C#-Logik.

Variablen

Die wichtigsten Variablen im Trigger:

Variable	Bedeutung
`%kalyixEvent%`	Eventname, zum Beispiel `kalyix.tip.paid`.
`%kalyixDeliveryId%`	ID der Delivery.
`%kalyixEventId%`	ID des KALYIX Events.
`%kalyixTipId%`	ID des Tips.
`%kalyixPaidStatus%`	`True`, wenn der Tip bezahlt ist.
`%kalyixAmount%`	Betrag als Zahl.
`%kalyixAmountCents%`	Betrag in Cent.
`%kalyixCurrency%`	Währung, zum Beispiel `EUR`.
`%kalyixUsername%`	Nutzername, wenn freigegeben.
`%kalyixDisplayName%`	Anzeigename, wenn freigegeben.
`%kalyixMessage%`	Nachricht, wenn freigegeben.
`%kalyixGoalId%`	Goal-ID, wenn freigegeben.
`%kalyixGoalTitle%`	Goal-Titel, wenn freigegeben.
`%kalyixPageSlug%`	Page-Slug, wenn freigegeben.
`%kalyixCreatedAt%`	Zeitpunkt des Events.
`%kalyixRawPayload%`	Original-Payload als JSON.

Wenn ein Feld nicht freigegeben ist, wird es nicht geliefert. Baue deine Actions deshalb so, dass optionale Variablen leer sein dürfen.

Test senden

Der Button Test senden im Extensions Dashboard erzeugt ein echtes Extension-Event für den Adapter. Es wird wie tip.paid ausgeliefert, aber nicht als echte Zahlung in der Tip-Zahlungshistory gespeichert.

Fehler prüfen

Problem	Check
Kein Event in Streamer.bot	Ist `KALYIX Connect` aktiv und die WebSocket-Verbindung offen?
`auth_timeout`	Wurde nach dem Connect die Auth-Action ausgelöst und ist der Token eingetragen?
`already_authenticated`	Die Verbindung ist schon authentifiziert. Nicht mehrfach Auth senden.
Felder fehlen	Prüfe im Dashboard, ob die passenden Datenfelder aktiv sind.
Test kommt an, echte Tips nicht	Prüfe, ob `event:tip.paid` aktiv ist und die Tip-Page wirklich Zahlungen auslöst.