Discord Webhook Adapter

Mit dem Discord Webhook Adapter sendet KALYIX Tip-Events als fertige Discord-Nachricht in einen Discord Channel. Du brauchst dafür keinen Discord Bot und keinen eigenen Server.

Der Adapter ist für einfache Channel-Nachrichten gedacht: zum Beispiel neue Tips, Test-Events oder später weitere freigegebene KALYIX Events. Rollen, Commands oder Server-Verwaltung gehören nicht zu diesem Adapter.

Was du brauchst

  • Einen Discord Server, in dem du Webhooks für einen Channel erstellen darfst.
  • Eine Discord Webhook URL.
  • Den Discord Webhook Adapter im Extensions Dashboard.
  • Aktivierte Events und Datenfelder, zum Beispiel Tip bezahlt, amount, currency und displayName.

Discord Webhook URL erstellen

  1. Öffne Discord.
  2. Öffne den Server und den Channel, in den KALYIX posten soll.
  3. Öffne die Channel-Einstellungen.
  4. Gehe zu Integrationen.
  5. Öffne Webhooks.
  6. Erstelle einen neuen Webhook oder nutze einen vorhandenen.
  7. Kopiere die Webhook URL.

Die URL sieht ungefähr so aus:

https://discord.com/api/webhooks/123456789/abcdef...

Teile diese URL nicht öffentlich. Wer die URL kennt, kann in diesen Discord Channel posten.

Einrichtung in KALYIX

  1. Öffne das Extensions Dashboard.
  2. Aktiviere den Adapter Discord Webhook.
  3. Klicke bei Bedarf auf Ziel hinzufügen.
  4. Trage die Discord Webhook URL ein.
  5. Schreibe die Discord Nachricht.
  6. Aktiviere das Event Tip bezahlt.
  7. Wähle die Datenfelder aus, die du in der Nachricht nutzen möchtest.
  8. Speichere die Auswahl.
  9. Speichere die Discord-Konfiguration.
  10. Nutze Test senden, um den Channel zu prüfen.

Du kannst bis zu 5 Discord Webhook Ziele anlegen. So kannst du zum Beispiel verschiedene Server oder Channels aus demselben KALYIX Account bedienen.

Nachricht mit Tokens bauen

Im Feld Discord Nachricht kannst du normalen Discord Markdown-Text schreiben und KALYIX Tokens einsetzen.

Beispiel:

Danke {{displayName}} für {{amount}} {{currency}}!

Nachricht:
{{message}}

Tokens werden nur gefüllt, wenn das passende Datenfeld im Dashboard aktiviert und gespeichert ist. Wenn du {{message}} nutzt, aber das Feld message nicht freigibst, bleibt der Token leer.

Verfügbare Tokens

Die Token-Liste im Dashboard zeigt dir die Werte, die für dieses Ziel durch deine gespeicherte Auswahl verfügbar sind.

Typische Tip-Tokens sind:

TokenBedeutung
{{amount}}Betrag, zum Beispiel 10.
{{amountCents}}Betrag in Cent, zum Beispiel 1000.
{{currency}}Währung, zum Beispiel EUR.
{{username}}Technischer Username, wenn vorhanden.
{{displayName}}Anzeigename, wenn vorhanden.
{{message}}Nachricht des Supporters.
{{goalId}}Interne Goal-ID.
{{goalTitle}}Titel des Goals.
{{pageSlug}}Slug der Tip-Seite.
{{createdAt}}Zeitpunkt des Events.
{{isTest}}Kennzeichnet ein Test-Event.

Nicht jedes Event hat jedes Feld. Aktivierte, aber leere Felder werden leer ersetzt.

Test senden

Test senden erzeugt ein echtes Extension-Test-Event für genau dieses Discord Ziel. Es nutzt denselben Weg wie ein echtes tip.paid Event, wird aber nicht als echte Zahlung in der Tip-Zahlungshistory gespeichert.

Wenn kein Post in Discord ankommt:

  • Prüfe, ob die Discord Webhook URL gespeichert ist.
  • Prüfe, ob das Ziel auf An steht.
  • Prüfe, ob Tip bezahlt aktiviert und gespeichert ist.
  • Prüfe, ob Discord den Webhook noch erlaubt.
  • Prüfe den Verlauf im Extensions Dashboard auf Fehler.

Unterschied zu Raw Webhook

Discord Webhook baut eine Discord-Nachricht und sendet sie direkt an Discord.

Raw Webhook sendet rohe KALYIX JSON-Daten an deinen eigenen Server. Eine Discord Webhook URL gehört nicht in den Raw Webhook Adapter, weil Discord kein KALYIX JSON versteht.

Nutze:

ZielAdapter
Discord Channel ohne eigenen ServerDiscord Webhook
Eigener Server, Automatisierung oder MapperRaw Webhook
Streamer.bot AlertsStreamer.bot

Unterschied zum Discord Bot

Der Discord Webhook Adapter kann Nachrichten posten. Er kann keine Rollen vergeben, Commands ausführen, Member prüfen oder Server verwalten.

Solche Funktionen gehören später in einen eigenen KALYIX Discord Bot.