> For the complete documentation index, see [llms.txt](https://docs.alphacloud.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alphacloud.pro/module-support/tickets.md).

# Tickets

Das komplette Ticketsystem mit Kategorien, Fragen, Panels, Bewertungen, KI Support und Transkripten.

**Im Panel unter:** Support, Tickets

Das größte Modul von AlphaCloud. Mitglieder öffnen über ein Panel ein Ticket, beantworten dabei optional Fragen, und bekommen einen privaten Kanal mit deinem Support Team. Beim Schließen entsteht ein dauerhaftes Transkript.

## Der Aufbau

```
Panel          eine Nachricht im Kanal mit einem Kategorie Menü
  └─ Kategorie  Support Rollen, Limits, KI Einstellungen
       └─ Frage  Formularfelder, die beim Öffnen abgefragt werden
            └─ Ticket  der eigentliche Kanal
                 └─ Transkript  das dauerhafte Archiv
```

## Schnellstart

{% stepper %}
{% step %}

### Modul aktivieren

{% endstep %}

{% step %}

### Kategorie anlegen

Unter **Kategorien** einen Namen eintragen und hinzufügen. Danach Support Rollen und die Discord Kategorie setzen, in der die Ticketkanäle entstehen sollen.
{% endstep %}

{% step %}

### Optional: Fragen hinzufügen

Was das Mitglied beim Öffnen ausfüllen soll.
{% endstep %}

{% step %}

### Panel anlegen

Unter **Panels** ein Panel hinzufügen, Kanal, Titel und Beschreibung setzen.
{% endstep %}

{% step %}

### Panel senden

Auf **Senden** klicken. Erst dann steht es in Discord.
{% endstep %}

{% step %}

### Protokollkanal setzen und speichern

{% endstep %}
{% endstepper %}

## Allgemeine Einstellungen

| Einstellung                                  | Bedeutung                                                       |
| -------------------------------------------- | --------------------------------------------------------------- |
| **Hauptfarbe**                               | Farbe der Ticket Embeds                                         |
| **Protokollkanal**                           | Dort landen Ticket Protokolle                                   |
| **Bewertungskanal**                          | Wo abgegebene Bewertungen gepostet werden                       |
| **Bewertungs Voice Kanal**                   | Ein Sprachkanal, dessen Name den Bewertungsdurchschnitt anzeigt |
| **Bewertungsanzahl Voice Kanal**             | Dasselbe für die Anzahl der Bewertungen                         |
| **Geschlossene Kategorie**                   | Wohin ein geschlossener Ticketkanal verschoben wird             |
| **Geschlossene Tickets automatisch löschen** | Löscht den Kanal statt ihn zu verschieben                       |
| **Ticket Bewertungen aktivieren**            | Fragt nach dem Schließen nach einer Bewertung                   |
| **Auslastung im Ticket Panel anzeigen**      | Zeigt im Panel, wie stark der Support gerade ausgelastet ist    |
| **DM bei neuer Team Antwort**                | Der Ersteller bekommt eine DM, wenn das Team antwortet          |
| **Footer Text**                              | Eigener Footer für Ticket Embeds                                |
| **Embed Thumbnail**                          | Vorschaubild                                                    |
| **Panel Bild**                               | Bild im Auswahl Panel                                           |

{% hint style="info" %}
Die DM bei neuer Team Antwort geht **nur an den Ticket Ersteller**, nicht an andere Teilnehmer im Ticket.
{% endhint %}

## Panels

Ein Panel ist die Nachricht, über die ein Ticket geöffnet wird.

| Feld                           | Bedeutung                                                                                                       |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------- |
| **Panel Kanal**                | Wo es steht                                                                                                     |
| **Titel** und **Beschreibung** | Der Inhalt des Standard Embeds                                                                                  |
| **Zugewiesene Kategorien**     | Welche Kategorien im Menü auftauchen. Leer heißt alle                                                           |
| **Design des Panels**          | Eigene Gestaltung im [Message Builder](/grundlagen/message-builder.md). Das Kategorie Menü wird immer angehängt |

Mit **Senden** postest du das Panel, mit **Erneut senden / Bearbeiten** aktualisierst du es.

{% hint style="warning" %}
**Free Server können 2 Panels anlegen.** Mit Premium sind es unbegrenzt viele.
{% endhint %}

## Kategorien

| Feld                         | Bedeutung                                                     |
| ---------------------------- | ------------------------------------------------------------- |
| **Kategoriename**            | Der Name im Auswahlmenü                                       |
| **Emoji**                    | Optional, vor dem Namen                                       |
| **Beschreibung**             | Kurze Erklärung im Menü                                       |
| **Support Rollen**           | Wer Tickets dieser Kategorie sehen und bearbeiten darf        |
| **Discord Ticket Kategorie** | Die Discord Kategorie, in der neue Kanäle entstehen           |
| **Max. Tickets pro Nutzer**  | Wie viele offene Tickets ein Mitglied gleichzeitig haben darf |
| **Mittlere Auslastung ab**   | Ab wie vielen offenen Tickets die Auslastung als mittel gilt  |
| **Hohe Auslastung ab**       | Dasselbe für hoch                                             |

{% hint style="info" %}
Discord erlaubt maximal **25 Kategorien**, weil ein Auswahlmenü nicht mehr Einträge haben kann. Der Schwellwert für hohe Auslastung muss größer sein als der für mittlere.
{% endhint %}

Die Reihenfolge der Kategorien im Menü änderst du mit den Pfeilen.

## Fragen

Pro Kategorie kannst du ein kleines Formular definieren, das beim Öffnen eines Tickets erscheint.

| Feld            | Bedeutung                                          |
| --------------- | -------------------------------------------------- |
| **Bezeichnung** | Die Frage selbst                                   |
| **Platzhalter** | Beispieltext im Eingabefeld                        |
| **Pflicht**     | Ob die Frage beantwortet werden muss               |
| **Typ**         | Text (Kurz) für eine Zeile, Text (Absatz) für mehr |

{% hint style="info" %}
Discord erlaubt höchstens fünf Felder pro Formular. Frag nur das ab, was dein Team wirklich zum Anfangen braucht, der Rest klärt sich im Ticket.
{% endhint %}

## KI Ticket System

{% hint style="warning" %}
**Nur mit Premium oder aktiver AlphaCloud Partnerschaft.** Maximal 3 Kategorien können KI Support aktiviert haben.
{% endhint %}

| Einstellung                            | Bedeutung                                                 |
| -------------------------------------- | --------------------------------------------------------- |
| **KI Begrüßung**                       | Die Nachricht, mit der sich die KI beim Öffnen meldet     |
| **System Prompt**                      | Deine Anweisungen an die KI. Leer lassen für den Standard |
| **KI deaktivieren wenn Team schreibt** | Sobald ein Teammitglied schreibt, schaltet sich die KI ab |

{% hint style="success" %}
Die KI gibt sich in ihrer Begrüßung selbst als KI zu erkennen und bietet einen Knopf zum Abschalten an. Das ist Absicht: Nutzer müssen erkennen können, dass sie mit einem KI System sprechen. Mehr dazu unter [alphacloud.pro/ki-transparenz](https://alphacloud.pro/ki-transparenz).
{% endhint %}

Welches KI Backend genutzt wird, stellst du unter [Setup](/das-panel/setup.md) ein.

## Die 22 anpassbaren Nachrichten

Tickets hat mehr gestaltbare Nachrichten als jedes andere Modul. Alle liegen in einem gemeinsamen Editor, gruppiert nach Phase und durchsuchbar.

### Hauptnachrichten

| Nachricht                              | Wann sie erscheint                             |
| -------------------------------------- | ---------------------------------------------- |
| Design des Panels                      | Die Nachricht mit dem Kategorie Menü           |
| Design der Willkommensnachricht        | Beim Öffnen eines Tickets, pro Kategorie eigen |
| Design der Schließen Nachricht (Kanal) | Im Ticketkanal beim Schließen                  |
| Design der Schließen Nachricht (DM)    | Als DM an den Ersteller beim Schließen         |
| Design der Wiedereröffnungsnachricht   | Im Kanal beim Wiedereröffnen                   |

### Die 19 Lebenszyklus Hinweise

| Gruppe                      | Nachrichten                                                                                                   |
| --------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Schließen**               | Schließen Bestätigung, Schließanfrage (DM an den Ersteller), Schließanfrage (im Ticket)                       |
| **Automatisches Schließen** | Aktiviert, Warnung (DM), Abgebrochen, Timer zurückgesetzt, Automatisch geschlossen                            |
| **Bewertung**               | Bewertungsanfrage (DM), Bewertung im Bewertungskanal                                                          |
| **Team Aktionen**           | Ticket übernommen, Ticket freigegeben, Ticket umbenannt, Ticket übergeben, Neue Antwort (DM an den Ersteller) |
| **KI Support**              | KI Support abgeschaltet, KI an das Team übergeben                                                             |
| **Blacklist**               | Ticketsperre (DM), Ticketsperre aufgehoben (DM)                                                               |

{% hint style="info" %}
Knöpfe wie Schließen, Beanspruchen, Bewerten oder der Sprung zum Ticket sind **Pflichtbausteine**. Du kannst sie innerhalb der Nachricht verschieben, aber nicht entfernen.
{% endhint %}

### Variablen

`{user}`, `{actor}`, `{closedBy}`, `{reopenedBy}`, `{category}`, `{channel}`, `{reason}`, `{messageUrl}`, `{closeAt}`, `{newName}`, `{rating}`, `{feedback}`, `{answers}`, `{guild}`, `{memberCount}`.

Welche davon in welcher Nachricht zur Verfügung stehen, zeigt dir der Editor selbst an.

## Befehle

| Befehl                     | Wirkung                                              |
| -------------------------- | ---------------------------------------------------- |
| `/ticket close`            | Aktuelles Ticket schließen                           |
| `/ticket add`              | Nutzer oder Rolle zum Ticket hinzufügen              |
| `/ticket remove`           | Nutzer oder Rolle entfernen                          |
| `/ticket rename`           | Ticketkanal umbenennen                               |
| `/ticket claim`            | Ticket übernehmen                                    |
| `/ticket transfer`         | An eine andere Kategorie übergeben                   |
| `/ticket-blacklist add`    | Nutzer für Tickets sperren                           |
| `/ticket-blacklist remove` | Sperre aufheben                                      |
| `/closerequest`            | Den Ersteller um Bestätigung zum Schließen bitten    |
| `/autoclose`               | Automatisches Schließen für dieses Ticket aktivieren |
| `/cancel-autoclose`        | Automatisches Schließen wieder abbrechen             |
| `/summarize`               | Das Ticket von der KI zusammenfassen lassen          |

## Transkripte

Beim Schließen entsteht ein dauerhaftes Transkript auf [transcript.alphacloud.pro](https://transcript.alphacloud.pro). In der Schließen DM und im Log steht ein Knopf dorthin.

{% content-ref url="/pages/6K6UzgykfawGsTkUiSRq" %}
[Ticket Transkripte](/grundlagen/ticket-transkripte.md)
{% endcontent-ref %}

## Danger Zone

**Geschlossene Ticket Kanäle löschen** entfernt die Discord Kanäle aller geschlossenen Tickets auf einmal. Die Ticket Einträge und Transkripte bleiben erhalten.

{% hint style="danger" %}
Das lässt sich nicht rückgängig machen. Das Panel verlangt deshalb einen zweiten Klick zur Bestätigung.
{% endhint %}

## Free und Premium

| Funktion                             | Free                         | Premium    |
| ------------------------------------ | ---------------------------- | ---------- |
| Panels                               | 2                            | unbegrenzt |
| KI Ticket Support                    | nur mit eigenem KI Schlüssel | enthalten  |
| Werbebanner auf der Transkript Seite | ja                           | nein       |

## Benötigte Rechte

Kanäle verwalten, Nachrichten senden, Links einbetten, Nachrichten verwalten, Nachrichtenverlauf lesen, Rollen verwalten (für die Kanalrechte der Support Rollen).

## Verwandt

{% content-ref url="/pages/qcnvtDLEZkceCKWvQD0D" %}
[Support Benachrichtigung](/module-support/support-benachrichtigung.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://docs.alphacloud.pro/module-support/tickets.md?ask=<question>&goal=<endgoal>
```

`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.
