# Einen benutzerdefinierten Befehl erstellen

<i class="fa-crown">:crown:</i> **Premium-Funktion.** Öffne auf dem Dashboard **Benutzerdefinierte Befehle**, dann **+ Neuer Befehl** um den Ersteller zu öffnen.

Der Ersteller hat zwei Bereiche. Der **linke Bereich** ist der Ort, an dem du die Antwort erstellst (den Nachrichteninhalt, Embeds und Buttons). Der **rechte Bereich** enthält die Einstellungen des Befehls (Name, Auslöser, Optionen und Berechtigungen).

<figure><img src="/files/31c2493b73e29d7af5bf03bd766f5c9a84b7fc44" alt="The custom-command creator open showing both panes"><figcaption></figcaption></figure>

## 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. Es wird ein Zähler angezeigt, der rot wird, wenn du dich dem Limit näherst.
* Unterstützt Discord-Markdown.
* Hat einen Emoji-Picker direkt im Text.
* Wenn der Befehl **Ticket Only**, funktionieren hier Ticket-Platzhalter (siehe den Abschnitt unten zu Platzhaltern).

Hilfetext: *„Inhalt ist optional, wenn mindestens ein Embed vorhanden ist.“*

### Tab „Embeds“

Bis zu 10 Embeds. Öffne den **Embed-Designer** um jeden einzelnen 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 **Ticket Only** ist aktiviert, unterstützen die Embed-Textfelder ebenfalls Ticket-Platzhalter.

Ein „Alle löschen“-Button 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-Buttons

In den Embeds kannst du **Link-Buttons**hinzufügen. Das sind nur Link-Buttons.

* Bis zu 5 Reihen mit jeweils bis zu 5 Buttons.
* Jeder Button benötigt eine Beschriftung (bis zu 80 Zeichen) und eine URL, die mit http\:// oder https\:// beginnt (bis zu 512 Zeichen). Ein Button kann nur ein Emoji ohne Beschriftung verwenden.

Diese sind nützlich für Muster wie „Hier ist unsere Rückerstattungsrichtlinie“ mit einem Button, der 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 es nicht sehen.“*
* Erforderlich.
* Wird automatisch kleingeschrieben.
* 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 kleingeschrieben.
* Muss auf deinem Server eindeutig sein.

Du musst kein `!` Präfix verwenden. Jeder Text funktioniert. Wähle einen Stil und verwende ihn durchgängig in deinen Befehlen, damit sich dein Team daran erinnern kann.

### Optionen

| Feld                               | Typ        | Standard | Verhalten                                                                                                                                                   |
| ---------------------------------- | ---------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Befehl aktiviert**               | Umschalter | Ein      | Wenn aus, bewirkt das Eingeben des Auslösers nichts.                                                                                                        |
| **Ticket Only**                    | Umschalter | Aus      | Wenn an, wird der Befehl nur in Ticket-Kanälen ausgelöst, und Ticket-Platzhalter funktionieren in der Antwort.                                              |
| **Befehlsnachricht löschen**       | Umschalter | Aus      | Wenn an, löscht der Bot die Auslöser-Nachricht des Benutzers, nachdem er geantwortet hat.                                                                   |
| **Auf Befehlsnachricht antworten** | Umschalter | Ein      | Wenn an, ist die Antwort des Bots eine Antwort auf die Nachricht des Benutzers. Diese Option ist ausgeblendet, wenn Befehl-Nachricht löschen aktiviert ist. |

### Berechtigungen

| Feld                                                                          | Typ            | Verhalten                                                                      |
| ----------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------ |
| **Allen Mitarbeitern erlauben**                                               | Umschalter     | Wenn an, kann jeder mit einer serverweiten Support-Rolle den Befehl verwenden. |
| **Rollen** (wird angezeigt, wenn Allen Mitarbeitern erlauben deaktiviert ist) | Rollen-Auswahl | Die spezifischen Rollen, die diesen Befehl verwenden dürfen.                   |

## Validierung

Der Speichern-Button 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 **Ticket Only** ist aktiviert, werden diese Platzhalter ausgefüllt, wenn der Befehl ausgelöst wird:

| Platzhalter       | Gefüllt mit                          |
| ----------------- | ------------------------------------ |
| `{USER}`          | Eine Erwähnung des Ticket-Erstellers |
| `{TICKET_NUMBER}` | Die Ticketnummer                     |
| `{TYPE}`          | Die Beschriftung der Panel-Option    |
| `{USER_ID}`       | Die Discord-ID des Ticket-Erstellers |
| `{USER_NAME}`     | Anzeigename des Ticket-Erstellers    |
| `{GUILD_NAME}`    | Ihr Servername                       |
| `{CREATED_AT}`    | Die Ticket-Erstellungszeit           |

Ein Platzhalter ohne Wert wird angezeigt als `k. A.`. Befehle, die nicht auf Nur-Ticket eingestellt sind, unterstützen keine Platzhalter.

## Speichern

Klicke auf **Speichern**. Der Befehl ist sofort aktiv. Das Prüfprotokoll verzeichnet, 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: 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:

```
GET https://ticketking.xyz/docs/de/benutzerdefinierte-befehle/creating-a-command.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
