Globale Platzhalter

Funktionen

• Nutze Bot-Identität, Server-Infos und Zeitstempel als Platzhalter in jeder anpassbaren Nachricht - sie werden beim Senden der Nachricht automatisch ersetzt.
• Nutze Live-Ticket-Metriken (Auslastung, geschätzte Wartezeit) in Ticketöffnungsnachrichten, Willkommensnachrichten, Namen von Statistik-Kanälen und mehr.
• Zeige Metriken pro Thema an, um Nutzern konkrete Informationen zu dem von ihnen gewählten Thema zu geben.
• Platzhalter aktualisieren sich automatisch anhand von Echtzeitdaten.

Einrichtung

• Bot-, Server-, Zeitstempel- und Öffnungszeiten-Platzhalter sind immer verfügbar - keine Konfiguration erforderlich.
• Für Ticket-Metrik-Platzhalter: Aktiviere Ticket-Auslastung und/oder Geschätzte Wartezeit in deinem Dashboard.
• Verwende die folgenden Platzhalter in jedem anpassbaren Nachrichtenfeld (Ticketöffnungsnachrichten, Willkommensnachrichten, Namen von Statistik-Kanälen usw.).

Info

Nicht jeder Platzhalter ist in jedem Kontext verfügbar. Bot-, Server-, Zeitstempel- und Öffnungszeiten-Platzhalter funktionieren in jeder anpassbaren Nachricht. Ticket-Metrik-Platzhalter funktionieren in Ticketöffnungsnachrichten, Willkommensnachrichten, Auslastungs-/Wartezeit-Nachrichten und Statistik-Kanälen. Funktionsspezifische Platzhalter (zum Beispiel %staffUser% oder %estimatedWaitTime%) sind nur in den Nachrichten verfügbar, die auf den jeweiligen Funktionsseiten dokumentiert sind.

Verfügbare Platzhalter

Bot

Platzhalter	Beschreibung
%botName%	Anzeigename des Bots.
%botID%	Nutzer-ID des Bots.
%botAvatar%	Avatar-URL des Bots.
%botTag%	Vollständiger Tag des Bots.
%botMention%	Erwähnung des Bots (z.B. <@123...>).

Server

Platzhalter	Beschreibung
%guildName%	Name des Servers.
%guildID%	ID des Servers.
%guildIcon%	Icon-URL des Servers.

Zeitstempel

Zeitstempel-Platzhalter verwenden die native Zeitstempel-Formatierung von Discord und passen sich automatisch an Zeitzone und Sprache jedes Nutzers an. Sie werden im Moment des Sendens der Nachricht ausgewertet.

Platzhalter	Discord-Stil	Beschreibung
%timestamp%	f	Kurzes Datum/Uhrzeit (wie %shortDateTime%).
%shortTime%	t	Kurze Uhrzeit (z.B. 16:20).
%longTime%	T	Lange Uhrzeit (z.B. 16:20:30).
%shortDate%	d	Kurzes Datum (z.B. 05.04.2026).
%longDate%	D	Langes Datum (z.B. 5. April 2026).
%shortDateTime%	f	Kurzes Datum/Uhrzeit.
%longDateTime%	F	Langes Datum/Uhrzeit.
%relativeTime%	R	Relative Zeit (z.B. „gerade eben" oder „vor 2 Minuten").

Öffnungszeiten

Platzhalter	Beschreibung
%openingHours%	Eine formatierte Darstellung deiner konfigurierten Öffnungszeiten. Leer, wenn keine Öffnungszeiten konfiguriert sind.

Globale Metriken

Diese Platzhalter zeigen Metriken über alle Tickets im System.

Platzhalter	Beschreibung
%globalUtilization%	Die aktuelle Ticket-Auslastung als formatierter Prozentwert (z.B. „75 %"). Voraussetzung Erfordert, dass Ticket-Auslastung aktiviert ist.
%globalUtilizationCount%	Die Anzahl der aktuell offenen Tickets. Voraussetzung Erfordert, dass Ticket-Auslastung aktiviert ist.
%globalUtilizationEmoji%	Ein visuelles Indikator-Emoji passend zur aktuellen Auslastung (grüner Kreis, gelber Kreis oder roter Kreis). Voraussetzung Erfordert, dass Ticket-Auslastung aktiviert ist.
%globalEstimatedWaitTime%	Die geschätzte Wartezeit als formatierte Dauer (z.B. „15 Minuten"). Voraussetzung Erfordert, dass Geschätzte Wartezeit aktiviert ist.
%globalEstimatedWaitTimeMinutes%	Die geschätzte Wartezeit als Zahl in Minuten. Voraussetzung Erfordert, dass Geschätzte Wartezeit aktiviert ist.

Metriken pro Thema

Diese Platzhalter zeigen Metriken für ein bestimmtes Ticket-Thema. Ersetze {topicID} durch die eindeutige ID des Themas.

Platzhalter	Beschreibung
%topicUtilization-{topicID}%	Der Auslastungs-Prozentwert für das angegebene Thema. Voraussetzung Erfordert, dass Ticket-Auslastung aktiviert ist und das Thema die Auslastung aktiviert hat.
%topicUtilizationCount-{topicID}%	Die Anzahl der aktuell offenen Tickets für das angegebene Thema. Voraussetzung Erfordert, dass Ticket-Auslastung aktiviert ist und das Thema die Auslastung aktiviert hat.
%topicUtilizationEmoji-{topicID}%	Ein visuelles Indikator-Emoji für die Auslastung des angegebenen Themas. Voraussetzung Erfordert, dass Ticket-Auslastung aktiviert ist und das Thema die Auslastung aktiviert hat.
%topicEstimatedWaitTime-{topicID}%	Die geschätzte Wartezeit für das angegebene Thema als formatierte Dauer. Voraussetzung Erfordert, dass Geschätzte Wartezeit aktiviert ist.
%topicEstimatedWaitTimeMinutes-{topicID}%	Die geschätzte Wartezeit für das angegebene Thema in Minuten. Voraussetzung Erfordert, dass Geschätzte Wartezeit aktiviert ist.

Info

Ist die für einen Platzhalter erforderliche Funktion nicht aktiviert oder sind keine Daten verfügbar, wird der Platzhalter zu „Not available" aufgelöst.

Wo du sie verwenden kannst

Bot-, Server-, Zeitstempel- und Öffnungszeiten-Platzhalter können in jedem anpassbaren Nachrichtenfeld verwendet werden (die Beispiele unten gelten auch für sie).

Ticket-Metrik-Platzhalter können verwendet werden in:

• Ticketöffnungsnachrichten - zeige Nutzern den aktuellen Warteschlangen-Status, bevor sie ein Ticket öffnen.
• Willkommensnachrichten - informiere Nutzer über die erwartete Wartezeit, wenn ihr Ticket erstellt wird.
• Namen von Statistik-Kanälen - zeige Live-Metriken in Sprachkanalnamen an (alle 15 Minuten aktualisiert).
• Auslastungsnachrichten - reichere Auslastungswarnungen mit konkreten Zahlen an.
• Nachrichten zur geschätzten Wartezeit - kombiniere globale und themenspezifische Wartezeiten.

Tipp

Erhält eine Nachrichtenvorlage sowohl globale Platzhalter als auch eigene funktionsspezifische Platzhalter (wie %topic% oder %userID%), haben bei einer Namensüberschneidung die funktionsspezifischen Platzhalter Vorrang.