Ticket-System: Professioneller Discord-Support

Das KiroCloud Ticket-System verwandelt deinen Discord-Server in eine vollwertige Helpdesk- und Kundensupport-Plattform. Deine Community-Mitglieder können per Knopfdruck oder Dropdown private Support-Kanäle öffnen, die automatisch den zuständigen Teammitgliedern zugewiesen werden.

1. Einrichtung & Support-Panel

Um das Ticket-System für deinen Server bereitzustellen, sendest du ein interaktives Support-Panel in einen beliebigen Textkanal:

Support-Panel erstellen und senden:

1. Navigiere im KiroCloud Bot-Dashboard zum Modul-Tab "Tickets".
2. Passe das Panel-Design im Universal Embed Builder an (Titel, Beschreibung, Embed-Farbe, Thumbnail und Banner).
3. Verwende die Panel-Leiste (SendPanelBar) im Dashboard oder gib als Administrator im Discord-Kanal den Befehl !ticketpanel ein.
4. KiroCloud postet ein ansprechendes Embed inklusive interaktiver Komponenten (Buttons oder Dropdown-Menü).

┌───────────────────────────────────────────────────────────┐
│  📩 Support & Hilfe Center                                │
│                                                           │
│  Wähle unten die passende Kategorie aus, um ein           │
│  privates Ticket mit unserem Team zu eröffnen.            │
│                                                           │
│  [ Dropdown: Kategorie auswählen...              ▼ ]      │
└───────────────────────────────────────────────────────────┘

2. Ticket-Kategorien & Berechtigungs-Routing

Du kannst beliebig viele Support-Kategorien anlegen, um Anfragen gezielt an die richtigen Teammitglieder weiterzuleiten:

• Kategorie-Beispiele:
  • Allgemeiner Support: Für Fragen rund um den Server (@Supporter).
  • Technischer Support: Bei Fehlern, Lags oder Bug-Reports (@Entwickler).
  • Minecraft-Hilfe: Fragen zu In-Game-Accounts, Grundstücken oder Rängen (@Minecraft-Team).
  • Bewerbungen & Management: Vertrauliche Anfragen (@Server-Leitung).
• Discord-Kategorie (Parent Category): Jede Ticket-Art kann in einer eigenen Discord-Kategorie angelegt werden (z. B. TICKETS - SUPPORT oder TICKETS - TEAM).
• Sichere Berechtigungen: Bei der Ticket-Erstellung setzt der Bot automatisch strikte Kanal-Berechtigungen:
  • @everyone: Zugriff verweigert (unsichtbar).
  • Ticket-Ersteller: Lesen, Schreiben, Anhänge hinzufügen.
  • Kategorie-Support-Rollen: Vollständiger Lese- und Schreibzugriff.

3. Ticket-Workflow & Staff-Claiming

Sobald ein Nutzer ein Ticket eröffnet, wird ein neuer Kanal (z. B. #ticket-0042) erstellt und das Begrüßungs-Embed gepostet.

Das Claim-System (Staff-Zuweisung):

• Jedes geöffnete Ticket verfügt über einen "Ticket beanspruchen (Claim)"-Button.
• Klickt ein Teammitglied auf den Button, wird das Ticket diesem Supporter fest zugewiesen.
• Der Kanalname oder das Panel aktualisiert sich (z. B. ticket-0042-claim-luca), und andere Teammitglieder sehen sofort, wer das Ticket aktuell bearbeitet.
• Dies verhindert doppelte Antworten und sorgt für klare Verantwortlichkeiten.

Verfügbare Platzhalter im Begrüßungs-Embed:

• {user} – Erwähnt den Ersteller (@Benutzer).
• {username} – Name des Benutzers im Klartext.
• {server} – Name des Discord-Servers.
• {membercount} – Gesamte Mitgliederzahl des Servers.

4. Transcripts & Dokumentation

Nach Abschluss einer Support-Sitzung dokumentiert KiroCloud den gesamten Chatverlauf lückenlos:

• HTML- & Text-Transcripts: Alle Nachrichten, Zeitstempel, Avatare, Bilder und hochgeladenen Dateien werden in einem formatierten Transcript archiviert.
• Log-Kanal: Das Transcript wird automatisch als Datei in den konfigurierten Log-Kanal (z. B. #ticket-logs) gesendet.
• Direktnachricht (DM): Der Ticket-Ersteller erhält eine Kopie des Transcripts per DM zur eigenen Dokumentation.

5. Schließen & Auto-Close / Auto-Archive

Das Schließen von Tickets erfolgt kontrolliert und transparent:

1. Schließen per Button / Command: Nutzer oder Teammitglieder klicken auf "Ticket schließen" oder nutzen /ticket close.
2. Schließungsgrund (Modal): Wenn die Option require_close_reason aktiv ist, muss der Supporter einen kurzen Grund für die Schließung angeben (wird im Transcript und Log vermerkt).
3. Auto-Close bei Inaktivität: Reagiert der Ticket-Ersteller über einen definierten Zeitraum (z. B. 24 oder 48 Stunden) nicht mehr auf Rückfragen des Support-Teams, sendet KiroCloud eine Vorwarnung und archiviert/schließt das Ticket anschließend automatisch.

6. Feedback & Bewertungssystem

Zur Qualitätssicherung deines Supports bietet KiroCloud ein integriertes Bewertungssystem:

• Nach dem Schließen eines Tickets erhält der Ersteller eine automatisierte Direktnachricht mit einer 1-bis-5-Sterne-Bewertung und einem optionalen Textfeld für Feedback.
• Die abgegebenen Bewertungen werden mit dem Supporter-Namen verknüpft und im internen Team-Feedback-Kanal (feedbackLogMessageConfig) protokolliert.
• Durchschnittliche Bewertungen der Teammitglieder können im Admin-Dashboard ausgewertet werden.