Keyword Alerts: Benachrichtigung bei Stichwörtern

Keyword Alerts benachrichtigt dein Team, sobald in einer Nachricht ein bestimmtes Stichwort oder eine Phrase vorkommt, zum Beispiel einen Produktnamen, einen Streitfall-Begriff oder ein Hilfe-Stichwort. Die Nachricht selbst bleibt stehen: Anders als der Wortfilter löscht Kage nichts, er meldet nur.

Eine kurze Anleitung findest du im Ratgeber Keyword Alerts einrichten.

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten (oder einen für dieses Modul freigegebenen Zugriff).
• Tarif: Welchen Tarif das Modul braucht, zeigt der Tarifhinweis oben auf dieser Seite. Läuft der Tarif aus, pausiert Kage das Modul, bis er wieder gilt.
• Rechte von Kage im Meldungskanal: Nachrichten senden und Links einbetten. Soll eine Rolle gepingt werden, muss sie in Discord als erwähnbar eingestellt sein, oder Kage braucht das Recht @everyone, @here und alle Rollen erwähnen.
• Für die DM-Option: Die Person muss auf dem Server sein und Direktnachrichten von Servermitgliedern erlauben.

So arbeitet ein Alert

1. Kage ignoriert Nachrichten von Bots und Nachrichten ohne Text.
2. Für jeden Eintrag prüft Kage, ob die Nachricht im beobachteten Kanal geschrieben wurde. Ist kein Kanal gewählt („Alle Kanäle beobachten“), gilt der Eintrag überall.
3. Dann gleicht Kage das Stichwort ab, ohne auf Groß- und Kleinschreibung zu achten:

- Einzelnes Wort: muss als ganzes Wort vorkommen. „gvg“ löst bei „GvG heute?“ aus, aber nicht bei „gvging“ oder in einem zusammengesetzten Wort.
- Phrase mit Leerzeichen: wird als Textstück gesucht.

1. Der Cooldown pro Eintrag verhindert Wiederholungen: Innerhalb der eingestellten Minuten (Standard 30, einstellbar von 1 bis 1.440) meldet Kage dasselbe Stichwort nicht erneut.
2. Kage postet ein Embed „Keyword: …“ mit dem Nachrichtentext (bis 1.500 Zeichen), Autor, Kanal und einem Sprunglink zur Nachricht.
3. Wo das Embed erscheint, bestimmst du mit Alert-Kanal: In einem festen Kanal oder, ohne Auswahl, im Kanal, in dem die Nachricht fiel.
4. Optional pingt Kage eine Rolle und schickt das Embed zusätzlich als Direktnachricht an eine Person.
5. Der Treffer erscheint im Reiter Logs des Moduls.

Nur neue Nachrichten lösen aus. Bearbeitete Nachrichten prüft Kage nicht erneut. Der Cooldown liegt im Arbeitsspeicher und beginnt nach einem Neustart des Bots von vorn.

Einstellungen im Überblick

Premium erlaubt bis zu 50 Stichwörter, Enterprise bis zu 200. Bereits vorhandene Einträge über der Grenze werden nicht gekürzt. Die Discord-ID findest du per Rechtsklick auf das Profil, wenn in Discord der Entwicklermodus aktiv ist. Keyword Alerts hat keine Slash-Befehle.

Ergebnis überprüfen

1. Eintrag anlegen: Lege einen Test-Eintrag für einen Testkanal an, mit kurzem Cooldown.
2. Auslösen: Schreibe mit einem Zweitkonto eine Nachricht mit dem Stichwort. Im Alert-Kanal erscheint das Embed, die Rolle wird erwähnt.
3. Cooldown prüfen: Eine zweite Nachricht innerhalb der Cooldown-Zeit löst nichts aus.
4. Reiter Logs: Der Treffer steht dort mit Zeitpunkt.

Fehlerbehebung

Es kommt kein Alert

Prüfe, ob „Keyword Alerts aktiv“ an ist, der Eintrag gespeichert ist und der Tarif gilt. Prüfe, ob die Nachricht im beobachteten Kanal fiel und ob das Stichwort als ganzes Wort vorkommt. Nachrichten von Bots und bearbeitete Nachrichten werden nicht ausgewertet.

Der Alert kommt nur einmal

Das ist der Cooldown. Verkürze ihn für dichtere Meldungen, oder erhöhe ihn gegen Spam.

Das Embed erscheint, aber die Rolle wird nicht gepingt

Prüfe, ob im Eintrag eine Rolle gewählt ist. Existiert die Rolle nicht mehr, wähle sie neu. Ist die Rolle in Discord nicht als erwähnbar eingestellt, braucht Kage das Recht @everyone, @here und alle Rollen erwähnen. Außerdem braucht er im Kanal die Rechte zum Senden und Einbetten.

Die DM kommt nicht an

Die Person muss auf dem Server sein und Direktnachrichten von Servermitgliedern erlauben. Sonst überspringt Kage die DM stillschweigend. Der Alert im Kanal funktioniert trotzdem.

Die Meldung erscheint im falschen Kanal

Ohne gewählten Alert-Kanal postet Kage im Kanal, in dem die Nachricht fiel. Wähle einen festen Alert-Kanal, damit nur das Team sie sieht.

Weiterführend

Nachrichten mit verbotenen Begriffen automatisch löschen: Wortfilter. Bewusste Moderationsaktionen: Moderation.