> For the complete documentation index, see [llms.txt](https://ticketking.xyz/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ticketking.xyz/docs/de/benutzerdefinierte-befehle/creating-a-command.md).
# Einen benutzerdefinierten Befehl erstellen
:crown: **Premium-Funktion.** Öffne im Dashboard **Benutzerdefinierte Befehle**, dann **+ Neuer Befehl** um den Creator zu öffnen.
Der Creator hat zwei Bereiche. Der **linke Bereich** ist der Bereich, in dem du die Antwort erstellst (Nachrichteninhalt, Embeds und Schaltflächen). Der **rechte Bereich** enthält die Einstellungen des Befehls (Name, Auslöser, Optionen und Berechtigungen).
## Linker Bereich, die Antwort
Im linken Bereich erstellst du, was der Befehl sendet. Es gibt drei Tabs.
### Tab „Textinhalt“
Ein mehrzeiliger Editor für die Antwort des Bots.
* Limit: 2000 Zeichen. Ein Zähler wird angezeigt und wird rot, wenn du dich dem Limit näherst.
* Unterstützt Discord-Markdown.
* Hat einen integrierten Emoji-Auswähler.
* Wenn der Befehl **Nur Ticket**, funktionieren hier Ticket-Platzhalter (siehe den Abschnitt Platzhalter unten).
Hilfetext: *„Inhalt ist optional, wenn mindestens ein Embed vorhanden ist.“*
### Tab „Embeds“
Bis zu 10 Embeds. Öffne den **Embed-Designer** um jedes einzelne zu bearbeiten. Es ist derselbe Designer, der auch an anderer Stelle im Dashboard verwendet wird.
* Pro Embed: Titel (256), Beschreibung (4096), Fußzeile (2048), Autor (256), eine Farbe, ein Bild, ein Vorschaubild und bis zu 25 Felder (Feldname 256, Feldwert 1024).
* Über alle Embeds in einem Befehl hinweg: insgesamt bis zu 6000 Zeichen.
Wenn **Nur Ticket** ist aktiviert, unterstützen die Textfelder der Embeds ebenfalls Ticket-Platzhalter.
Eine Schaltfläche „Alle löschen“ entfernt alle Embeds auf einmal, mit einem Bestätigungsschritt.
### Tab „Antwortvorschau“
Eine Live-Vorschau, wie die Antwort in Discord aussehen wird, damit du die Formatierung vor dem Speichern prüfen kannst.
### Link-Schaltflächen
Innerhalb der Embeds kannst du **Link-Schaltflächen**. Das sind nur Link-Schaltflächen.
* Bis zu 5 Reihen mit jeweils bis zu 5 Schaltflächen.
* Jede Schaltfläche benötigt eine Beschriftung (bis zu 80 Zeichen) und eine URL, die mit http\:// oder https\:// beginnt (bis zu 512 Zeichen). Eine Schaltfläche kann auch nur ein Emoji ohne Beschriftung verwenden.
Das ist nützlich für Formulierungen wie „Hier ist unsere Rückerstattungsrichtlinie“ mit einer Schaltfläche, die die Seite öffnet.
## Rechter Bereich, die Einstellungen
### Befehlsname
Ein Textfeld, das den Befehl in deinem Dashboard benennt. **Benutzer sehen das nicht.**
* Platzhalter: `Falsches Ticket`
* Hilfetext: *„Wird nur verwendet, um diesen Befehl in deinem Dashboard zu identifizieren. Benutzer werden ihn nicht sehen.“*
* Erforderlich.
* Wird automatisch in Kleinbuchstaben umgewandelt.
* Muss auf deinem Server eindeutig sein.
### Befehlsauslöser
Der Text, den Benutzer eingeben, um den Befehl auszulösen.
* Platzhalter: `!wrongticket`
* Hilfetext: *„Der Text, den Benutzer eingeben werden, um diesen Befehl auszulösen.“*
* Erforderlich.
* Wird automatisch in Kleinbuchstaben umgewandelt.
* Muss auf deinem Server eindeutig sein.
Du musst kein `!` Präfix verwenden. Jeder Text funktioniert. Wähle einen Stil und verwende ihn in all deinen Befehlen, damit sich dein Team daran erinnern kann.
### Optionen
| Feld | Typ | Standard | Verhalten |
| -------------------------------------- | ---------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Befehl aktiviert** | Umschalter | Ein | Wenn deaktiviert, bewirkt das Eingeben des Auslösers nichts. |
| **Nur Ticket** | Umschalter | Aus | Wenn aktiviert, wird der Befehl nur in Ticket-Kanälen ausgelöst, und Ticket-Platzhalter funktionieren in der Antwort. |
| **Befehlsnachricht löschen** | Umschalter | Aus | Wenn aktiviert, löscht der Bot die Auslösernachricht des Benutzers, nachdem er geantwortet hat. |
| **Auf die Befehlsnachricht antworten** | Umschalter | Ein | Wenn aktiviert, ist die Antwort des Bots eine Antwort auf die Nachricht des Benutzers. Diese Option wird ausgeblendet, wenn „Befehlsnachricht löschen“ aktiviert ist. |
### Berechtigungen
| Feld | Typ | Verhalten |
| ------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------- |
| **Allen Mitarbeitern erlauben** | Umschalter | Wenn aktiviert, kann jeder mit einer serverweiten Support-Rolle den Befehl verwenden. |
| **Rollen** (wird angezeigt, wenn „Allen Mitarbeitern erlauben“ deaktiviert ist) | Rollenauswahl | Die konkreten Rollen, die diesen Befehl verwenden dürfen. |
## Validierung
Die Schaltfläche „Speichern“ bleibt deaktiviert, bis der Befehl gültig ist. Häufige Meldungen:
* *„Befehlsname ist erforderlich“*
* *„Befehlsauslöser ist erforderlich“*
* *„Der Befehl muss Inhalt oder mindestens ein Embed haben“*
* *„Befehlsname existiert bereits“*
* *„Befehlsauslöser existiert bereits“*
## Platzhalter (Nur-Ticket-Modus)
Wenn **Nur Ticket** ist aktiviert, werden diese Platzhalter beim Auslösen des Befehls ausgefüllt:
| Platzhalter | Ausgefüllt mit |
| ----------------- | ------------------------------------- |
| `{USER}` | Einer Erwähnung des Ticket-Autors |
| `{TICKET_NUMBER}` | Die Ticketnummer |
| `{TYPE}` | Die Beschriftung der Panel-Option |
| `{USER_ID}` | Die Discord-ID des Ticket-Erstellers |
| `{USER_NAME}` | Der Anzeigename des Ticket-Erstellers |
| `{GUILD_NAME}` | Der Name deines Servers |
| `{CREATED_AT}` | Der Erstellungszeitpunkt des Tickets |
Ein Platzhalter ohne Wert wird angezeigt als `k. A.`. Befehle, die nicht im Nur-Ticket-Modus sind, unterstützen keine Platzhalter.
## Speichern
Klicken Sie auf **Speichern**. Der Befehl ist sofort aktiv. Das Audit-Log zeichnet auf, dass der Befehl erstellt wurde.
## Verwandt
{% content-ref url="/pages/7d1be292335ccdbae81b863728ae98c2bd3b96de" %}
[Befehle bearbeiten und löschen](/docs/de/benutzerdefinierte-befehle/editing-and-deleting.md)
{% endcontent-ref %}
{% content-ref url="/pages/c942b4d1bf7b71764b41ba42140ef0eddefcf025" %}
[Anwendungsfälle](/docs/de/benutzerdefinierte-befehle/use-cases.md)
{% endcontent-ref %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ticketking.xyz/docs/de/benutzerdefinierte-befehle/creating-a-command.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.