Integrationen

Funktionsliste

Eine Liste aller Funktionen findest du auf der Funktionen-Seite.

Integrationen sind im Prinzip Customcommands 2.0 - du kannst immer noch einfach auf Message- und Slashcommands antworten, aber du hast zusätzlich die Möglichkeit, viele weitere Auslöser für Aktionen zu nutzen. Außerdem ist es möglich, erstellte Integrationen auf anderen Servern zu verwenden.

Integrationen können im Dashboard verwaltet werden.

Mögliche Auslöser

• Nachrichten- und Slashcommand
  • Argument: Slashcommand-Beschreibung. Wenn leer wird kein Slashcommand von dieser Aktion registriert.
  • Maximal 100 Slashcommands pro Server.
• Nachrichten-Kontextmenü
  • Argument: Text für das Kontextmenü, maximal 25 Zeichen.
  • Maximal fünf pro Server.
• Nutzer-Kontextmenü
  • Argument: Text für das Kontextmenü, maximal 25 Zeichen.
  • Maximal fünf pro Server.
• Nachrichteninhalt enthält
  • Argument: Nachrichteninhalt, nach dem gesucht werden soll
• Nachrichteninhalt ist gleich
  • Argument: Exakter Nachrichteninhalt mit gleicher Groß- und Kleinschreibung
• Nachrichteninhalt beginnt mit
  • Argument: Nachrichteninhalt, nach dem gesucht werden soll
• Nachrichteninhalt endet mit
  • Argument: Nachrichteninhalt, nach dem gesucht werden soll
• Nachrichteninhalt matcht RegEx
  • Argument: RegEx, mit dem geprüft werden soll, siehe RegEx-Cheatsheet
• Button gedrückt
  • Argument: Button-Custom-ID
• Selectmenü ausgewählt
  • Argument: Selectmenü-Custom-ID
• Modal abgesendet
  • Argument: Modal-Custom-ID
• Discord-AutoMod ausgelöst (z. B. für eigene Bestrafungen, wenn eine bestimmte Regel ausgelöst wird)
  • Argument (optional): ID einer Regel
• Slashcommand eines anderen Bots verwendet (z. B. für /bump-Erinnerungen)
  • Argument: Slashcommand-Name des anderen Bots
• Mitglied beigetreten/verlassen
  • Argument: join, leave oder all/leer
• Reaktion hinzugefügt/entfernt
  • Argument: add, remove oder all/leer
• Rolle erstellt/gelöscht
  • Argument: create, delete oder all/leer
• Kanal erstellt/gelöscht
  • Argument: create, delete oder all/leer
• Webhook erstellt/gelöscht
  • Argument: create, delete oder all/leer
• Thread (oder Forumpost) erstellt/gelöscht
  • Argument: create, delete oder all/leer
• Nickname geändert
• Server geboosted/Boosts entfernt
  • Argument: boost, boostend oder all/leer
• Intervall
  • Argument: Intervall-Zeit wie z. B. 45m, kann zufällige Verschiebungen nach Botneustarts haben, mindestens fünf Minuten, maximal zwei Tage
• Cronjob
  • Argument: Der Cronjob, z. B. von https://crontab.guru, maximal einmal alle fünf Minuten
• Nutzer betritt/verlässt Sprachkanal
  • Argument: join, leave oder all/leer
• Nutzer ge- oder enttimeouted
  • Argument: timeout, timeoutend oder all/leer
• Discord-Systemnachricht
  • Argument: Interne Discord-System-Nachrichten-Typ-ID: https://discord.com/developers/docs/resources/channel#message-object-message-types

Synchronisations-Modi

Es gibt verschiedene Sync-Modi, die beim Importieren einer Integration auf einen anderen Server ausgewählt werden können:

Keine Synchronisation

Deaktiviert jegliche Synchronisation und entfernt den Hinweis, von welcher Integration die aktuelle ursprünglich stammt.

Manuelle Synchronisation

Änderungen können manuell mit einem Button im Dashboard synchronisiert werden. Die Inhalte können normal bearbeitet werden, werden beim Synchronisieren aber überschrieben.

Automatische Synchronisation

Synchronisiert alle Änderungen am Original automatisch, sobald dieses bearbeitet wird. Wird empfohlen, wenn du dem Besitzer bzw. Server der Integration vertraust. Inhalte können nicht bearbeitet werden.

Sichere Synchronisation

Eine Mischung zwischen manueller und automatischer Synchronisation. Die Inhalte können nicht bearbeitet werden. Bei einer Änderung muss entweder - wie bei der manuellen Synchronisation - ein Teammitglied der Servers die Änderung annehmen, oder ein TomatenKuchen-Teamler. Durch diese Kombination können Änderungen schneller zugelassen werden.

Beispiele

Diese Integrationen wurden von unserem Team erstellt oder von diesem verifiziert.

• FiveM-Server-Info anzeigen, zeigt die Verwendung von {jsonAPI}
• Wetterinfo eines Ortes anzeigen, zeigt die Verwendung von {jsonAPI} und Argumenten
• Vote-Reminder für TomatenKuchen
• Zufälligen Comic von xkcd.com anzeigen
• Automatische Übersetzung von Nachrichten in einem Kanal, zeigt die Verwendung verschiedener Funktionen zur Aktionseinschränkung

RegEx-Cheatsheet

Zeichen	Beschreibung	Beispiel
.	Alle Zeichen außer neue Zeilen	a.b matcht "axb"
\d	Ziffer (0-9)	\d{2} matcht "42"
\w	Wortzeichen (a-z, A-Z, 0-9, _)	\w+ matcht "Bot_1"
\s	Whitespace-Zeichen	a\sb matcht "a b"
[abc]	Irgendein dieser Zeichen	[aeiou] matcht "i"
[^abc]	Alle Zeichen außer diese	[^aeiou] matcht "b"
a*	0 oder mehr Vorkommnisse von a	a* matcht "aaa"
a+	1 oder mehr Vorkommnisse von a	a+ matcht "aa"
a?	0 oder 1 Vorkommnisse von a	a? matcht "a"
a{3}	Genau 3 Vorkommnisse von a	a{3} matcht "aaa"
a{3,}	3 oder mehr Vorkommnisse von a	a{3,} matcht "aaaa"
a{3,5}	3 bis 5 Vorkommnisse von a	a{3,5} matcht "aaa"
^	Anfang der Zeichenkette	^abc matcht "abcxyz"
$	Ende der Zeichenkette	xyz$ matcht "abcxyz"
\b	Wortbegrenzung	\bword\b matcht "word"
(...)	Match-Gruppe	(abc) matcht "abc"

Match-Gruppen können mithilfe von {argsObj;groups;<Group ID>} ausgelesen werden.