🎫 Zammad KI-Integration

Intelligente Ticketerstellung und Beantwortung

Lädt... · Lädt...

📝 Anfrage analysieren

Kopieren Sie den Text der Kundenanfrage (z.B. E-Mail oder Kontaktformular) in das Feld unten. Die KI extrahiert automatisch alle relevanten Informationen.

🎫 Tickets verwalten

Suchen Sie Tickets über intelligente KI-Suche, klassische Suche oder direkte Ticket-Nummer. Bearbeiten, beantworten und schließen Sie Tickets direkt hier.

🤖 Intelligente KI-Suche

Beschreiben Sie in eigenen Worten, wonach Sie suchen

🤖 KI-Chat

Bereit

⚙️ Einstellungen

Konfigurieren Sie hier alle API-Schlüssel und KI-Modelle. Diese werden sicher in Ihrem Browser gespeichert.

💡 Hinweis: Alle Einstellungen werden lokal in Ihrem Browser gespeichert und nie an Dritte weitergegeben.

🤖 KI-Zugangsdaten

💡 Wichtig: Die Auswahl des KI-Providers (Eden AI ↔ Lokale KI) erfolgt zentral oben im Header.
Hier konfigurieren Sie nur die API-Zugangsdaten für beide Anbieter. Sie können dann oben jederzeit zwischen ihnen wechseln.

☁️ Eden AI Konfiguration

Erhalten Sie Ihren API-Schlüssel unter: edenai.co
💡 OpenAI: Beste Qualität, höhere Kosten
💰 Mistral: 80% günstiger, sehr gute Qualität
⚡ Claude: Sehr schnell, moderate Kosten

🎫 Zammad Konfiguration

Format: https://ihre-domain.com (ohne trailing slash)
Erstellen Sie einen Token in Zammad unter: Admin → API-Tokens

✍️ Benutzer-Signaturen

💡 Hinweis: Hier können Sie Signaturen für verschiedene Benutzer verwalten. Diese werden automatisch in Ihre JSON-Exporte eingebunden.
Verwenden Sie Zeilenumbrüche für mehrzeilige Signaturen

💡 Hilfe

Demo-Einstellungen laden: Lädt die Server-Demo-Konfiguration in die Eingabefelder.

Einstellungen übernehmen: Speichert alle Einstellungen in Ihrem Browser für die aktuelle Sitzung.

Backup erstellen: Exportiert die aktuellen Einstellungen aus den Feldern als JSON-Datei.

Einstellungen laden: Lädt Einstellungen aus einer JSON-Datei in die Felder.

Alle Einstellungen löschen: Löscht alle gespeicherten Einstellungen und lädt die Seite neu.

👥 Kunden & Einrichtungen verwalten

🔍 Duplikat-Erkennung: Finde ähnliche Organisationen oder Kunden in Zammad und führe sie zusammen.
⚡ Microservice: Diese Funktion läuft auf einem separaten Server (Port 3002) und beeinträchtigt die Haupt-App nicht.

🏢 Organisationen zusammenführen

Durchsucht alle Organisationen und findet ähnliche Namen (ab 75% Übereinstimmung, z.B. "Musterfirma GmbH" vs "Musterfirma").

👤 Kunden zusammenführen

Durchsucht alle Kunden und findet ähnliche Namen oder E-Mail-Adressen (ab 70% Übereinstimmung).

🎫 Hilfe & Dokumentation

Vollständige Anleitung für das KI-gestützte Ticket-System

📋 Inhaltsverzeichnis

🚀 Startseite & Navigation

Willkommen im KI-gestützten Ticket-System!
Dieses System bietet eine vollständige Lösung für die Verwaltung von Support-Tickets mit integrierter KI-Unterstützung.

📱 Hauptnavigation

Das System verwendet eine Tab-basierte Navigation mit folgenden Hauptbereichen:

  • Ticket erstellen - Intelligente Ticket-Erstellung mit KI-Analyse
  • Tickets verwalten - Ticket-Suche, -Bearbeitung und -Beantwortung
  • KI-Chat - Freier Chat mit der KI
  • Einstellungen - System-Konfiguration
  • Kunden & Einrichtungen - Duplikat-Erkennung und -Zusammenführung
  • Hilfe - Diese Dokumentation

🔐 Anmeldung

Erste Anmeldung:
  1. Öffnen Sie das System in Ihrem Browser
  2. Konfigurieren Sie die Einstellungen (siehe Einstellungen-Tab)
  3. Testen Sie die Verbindung

🎯 Schnellstart

Erste Schritte:
  1. Konfigurieren Sie Ihre KI-Integration in den Einstellungen
  2. Erstellen Sie Ihr erstes Ticket über den "Ticket erstellen" Tab
  3. Konfigurieren Sie Ihre Signatur in den Einstellungen
  4. Testen Sie die KI-Integration für automatische Antworten

🎫 Ticket-Management

Vollständige Ticket-Verwaltung
Erstellen, bearbeiten, suchen und verwalten Sie Tickets mit erweiterten Funktionen.

➕ Neues Ticket erstellen

Ticket-Erstellung:
  1. Klicken Sie auf den "Ticket erstellen" Tab
  2. Kopieren Sie die Kundenanfrage in das Textfeld
  3. Klicken Sie auf "Anfrage analysieren"
  4. Überprüfen Sie die extrahierten Daten
  5. Klicken Sie auf "Kunde und Ticket in Zammad erstellen"

🔍 Ticket-Suche

Das System bietet erweiterte Suchfunktionen:

  • Intelligente KI-Suche - Beschreiben Sie in eigenen Worten, wonach Sie suchen
  • Direktsuche - Ticket-ID eingeben
  • Schnellzugriff - Letzte 20 offene Tickets laden

✏️ Ticket bearbeiten

Ticket-Bearbeitung:
  1. Wählen Sie ein Ticket aus der Liste
  2. Sehen Sie die Ticket-Details und Historie
  3. Generieren Sie KI-Antworten
  4. Schließen Sie das Ticket bei Bedarf

📊 Ticket-Status

Verfügbare Status:

  • Offen - Neues Ticket, wartet auf Bearbeitung
  • In Bearbeitung - Ticket wird aktiv bearbeitet
  • Geschlossen - Ticket wurde abgeschlossen

🤖 KI-Integration

Intelligente Ticket-Verarbeitung
Das System unterstützt sowohl Eden AI als auch lokale Ollama-Modelle für automatische Ticket-Verarbeitung.

🌐 Eden AI Integration

Eden AI bietet cloud-basierte KI-Services:

  • Automatische Ticket-Kategorisierung
  • Intelligente Antwortvorschläge
  • Sentiment-Analyse
  • Sprachverarbeitung
Eden AI konfigurieren:
  1. Gehen Sie zu den Einstellungen
  2. Wählen Sie "Eden AI" als KI-Provider
  3. Geben Sie Ihren Eden AI API-Schlüssel ein
  4. Wählen Sie das gewünschte Modell
  5. Speichern Sie die Einstellungen

🏠 Lokale Ollama-Integration

Ollama ermöglicht lokale KI-Verarbeitung:

  • Datenschutz durch lokale Verarbeitung
  • Keine Internetverbindung erforderlich
  • Anpassbare Modelle
  • Kostenlose Nutzung
Ollama konfigurieren:
  1. Installieren Sie Ollama auf Ihrem System
  2. Laden Sie ein Modell herunter (z.B. llama2)
  3. Gehen Sie zu den Einstellungen
  4. Wählen Sie "Lokale KI" als Provider
  5. Geben Sie die Ollama-URL ein
  6. Wählen Sie das Modell aus
  7. Speichern Sie die Einstellungen

🔄 KI-Modus wechseln

Sie können jederzeit zwischen Eden AI und Ollama wechseln:

  • Eden AI für maximale Leistung und Features
  • Ollama für Datenschutz und lokale Verarbeitung
  • Automatischer Fallback bei Verbindungsproblemen

🎯 KI-Features

Verfügbare KI-Funktionen:

  • Automatische Kategorisierung - Tickets werden automatisch kategorisiert
  • Prioritäts-Bewertung - KI schlägt Prioritäten vor
  • Antwortvorschläge - Intelligente Antworten für Support-Agenten
  • Duplikat-Erkennung - Automatische Erkennung ähnlicher Tickets
  • Sentiment-Analyse - Analyse der Stimmung in Tickets
✅ Tipp: Testen Sie beide KI-Systeme, um herauszufinden, welches für Ihre Anforderungen am besten geeignet ist.

✍️ Signatur-System

Professionelle Benutzer-Signaturen
Erstellen und verwalten Sie mehrzeilige Signaturen mit JSON-Export/Import-Funktionalität.

📝 Signatur erstellen

Neue Signatur erstellen:
  1. Gehen Sie zu den Einstellungen
  2. Wählen Sie "Benutzer-Signaturen"
  3. Geben Sie einen Benutzer-Namen ein
  4. Erstellen Sie Ihre Signatur mit mehreren Zeilen
  5. Klicken Sie auf "Signatur speichern"

✏️ Signatur bearbeiten

Signatur bearbeiten:
  1. Wählen Sie den Benutzer aus der Dropdown-Liste
  2. Ändern Sie den Inhalt
  3. Klicken Sie auf "Signatur speichern"

📤 JSON-Export

Exportieren Sie Ihre Signaturen für Backup oder Weitergabe:

Export durchführen:
  1. Klicken Sie auf "Backup der Einstellungen"
  2. Die JSON-Datei wird automatisch heruntergeladen
  3. Speichern Sie die Datei sicher

📥 JSON-Import

Importieren Sie Signaturen aus einer JSON-Datei:

Import durchführen:
  1. Klicken Sie auf "Einstellungen laden"
  2. Wählen Sie die JSON-Datei aus
  3. Die Einstellungen werden automatisch geladen

🔄 Signatur verwenden

Signaturen werden automatisch verwendet in:

  • KI-Antworten - Automatische Einfügung
  • Ticket-Kommentare - Manuelle Auswahl
  • E-Mail-Antworten - Professionelle Signatur
⚠️ Wichtiger Hinweis: Stellen Sie sicher, dass Ihre Signaturen den Unternehmensrichtlinien entsprechen und keine vertraulichen Informationen enthalten.

🔍 Duplikat-Erkennung

Intelligente Duplikat-Erkennung
Automatische Erkennung von Duplikaten mit Levenshtein-Algorithmus für Organisationen.

🔍 Wie funktioniert die Duplikat-Erkennung?

Das System verwendet den Levenshtein-Algorithmus zur Erkennung ähnlicher Organisationen:

  • Textvergleich - Vergleicht Organisationsnamen
  • Ähnlichkeits-Score - Berechnet Ähnlichkeit zwischen 0 und 1
  • Schwellenwert - Konfigurierbare Mindestähnlichkeit
  • Automatische Erkennung - Bei der Eingabe neuer Organisationen

⚙️ Konfiguration

Duplikat-Erkennung konfigurieren:
  1. Gehen Sie zu "Kunden & Einrichtungen"
  2. Geben Sie einen Suchbegriff ein (optional)
  3. Klicken Sie auf "Duplikate suchen"
  4. Überprüfen Sie die vorgeschlagenen Duplikate
  5. Führen Sie die gewünschten Aktionen durch

📊 Ähnlichkeits-Scores

Verständnis der Scores:

  • 1.0 - Exakte Übereinstimmung
  • 0.8-0.9 - Sehr ähnlich (wahrscheinlich Duplikat)
  • 0.6-0.7 - Ähnlich (möglicherweise Duplikat)
  • 0.0-0.5 - Verschieden (kein Duplikat)

🎯 Duplikat-Management

Wenn ein Duplikat erkannt wird:

  • Warnung anzeigen - Benutzer wird informiert
  • Vorschlag - Ähnliche Organisationen werden vorgeschlagen
  • Auswahl - Benutzer kann bestehende Organisation wählen
  • Überschreiben - Neue Organisation trotzdem erstellen
✅ Tipp: Regelmäßige Duplikat-Überprüfungen helfen dabei, die Datenqualität zu verbessern und Inkonsistenzen zu vermeiden.

👥 Benutzer-Management

Vollständige Benutzerverwaltung
Das System integriert sich nahtlos mit Zammad für die Benutzerverwaltung.

👤 Benutzerrollen

Das System unterstützt verschiedene Benutzerrollen über Zammad:

🔑 Admin
  • Vollzugriff auf alle Funktionen
  • Benutzerverwaltung
  • System-Einstellungen
  • Alle Tickets verwalten
  • KI-Integration konfigurieren
👨‍💼 Agent
  • Tickets bearbeiten und verwalten
  • KI-Features nutzen
  • Signatur-System nutzen
  • Duplikat-Erkennung verwenden
👤 Benutzer
  • Eigene Tickets erstellen und einsehen
  • Profil bearbeiten
  • Signatur-System nutzen
  • Eingeschränkte KI-Features

🔍 Benutzer suchen

Suchfunktionen für Benutzer:

  • Intelligente KI-Suche - Beschreiben Sie in eigenen Worten
  • Klassische Suche - Nach Name oder E-Mail
  • Organisations-Suche - Nach Organisation filtern

📊 Benutzer-Statistiken

Verfügbare Statistiken:

  • Gesamtanzahl - Alle Benutzer
  • Nach Rollen - Aufschlüsselung nach Rollen
  • Aktive Benutzer - Benutzer mit aktuellen Aktivitäten
  • Ticket-Statistiken - Tickets pro Benutzer

⚙️ Einstellungen & Konfiguration

Flexible System-Konfiguration
Das System ist vollständig konfigurierbar und kann mit beliebigen Zammad-Instanzen, KI-Providern und Modellen verwendet werden.

🎬 Demo-Einstellungen laden

Schnellstart mit Demo-Konfiguration:
  1. Gehen Sie zu "⚙️ Einstellungen"
  2. Klicken Sie auf "🎬 Demo-Einstellungen laden"
  3. Die Server-Demo-Konfiguration wird automatisch geladen und gespeichert
  4. Die Seite lädt neu und das System ist sofort einsatzbereit

Hinweis: Die Demo-Einstellungen enthalten vorkonfigurierte Zugangsdaten für Eden AI, Zammad und Ollama.

📦 Eigene Konfiguration exportieren

Backup erstellen:
  1. Füllen Sie die Einstellungsfelder mit Ihren Zugangsdaten aus
  2. Klicken Sie auf "📦 Backup erstellen"
  3. Eine JSON-Datei wird heruntergeladen
  4. Speichern Sie diese Datei sicher für spätere Verwendung

Hinweis: Das Backup enthält alle Einstellungen inkl. API-Keys und Signaturen.

📥 Konfiguration importieren

Einstellungen laden:
  1. Klicken Sie auf "📥 Einstellungen laden"
  2. Wählen Sie Ihre JSON-Datei aus
  3. Die Einstellungen werden automatisch in die Felder geladen
  4. Das System ist sofort einsatzbereit

Hinweis: Unterstützt sowohl neue als auch alte Backup-Formate.

🗑️ Einstellungen zurücksetzen

Alle Einstellungen löschen:
  1. Klicken Sie auf "🗑️ Alle Einstellungen löschen"
  2. Bestätigen Sie die Aktion
  3. Die Seite lädt neu
  4. Das System verwendet wieder die Server-Demo-Konfiguration

Hinweis: Ihre persönlichen Einstellungen werden gelöscht, aber die Server-Demo-Config bleibt verfügbar.

🤖 KI-Provider Konfiguration

Das System unterstützt zwei KI-Provider, die Sie frei kombinieren können:

🌐 Eden AI (Cloud-basiert)
Eden AI einrichten:
  1. Erstellen Sie einen Account bei Eden AI
  2. Generieren Sie einen API-Schlüssel
  3. Geben Sie den API-Schlüssel in den Einstellungen ein
  4. Wählen Sie ein Modell (OpenAI, Anthropic, Google, etc.)
  5. Das System ist sofort einsatzbereit

Vorteile:

  • ✅ Keine lokale Installation erforderlich
  • ✅ Zugriff auf viele verschiedene KI-Modelle
  • ✅ Hohe Leistung und Geschwindigkeit
  • ✅ Automatische Updates der Modelle
🏠 Ollama (Lokale KI)
Ollama einrichten:
  1. Installieren Sie Ollama auf Ihrem System
  2. Laden Sie ein Modell herunter: ollama pull llama3
  3. Geben Sie die Ollama-URL ein (Standard: http://127.0.0.1:11434)
  4. Das System erkennt automatisch verfügbare Modelle
  5. Wählen Sie ein Modell aus dem Dropdown

Vorteile:

  • ✅ Vollständiger Datenschutz (alles läuft lokal)
  • ✅ Keine Internetverbindung erforderlich
  • ✅ Kostenlose Nutzung
  • ✅ Anpassbare Modelle

Unterstützte Modelle (Auswahl):

  • llama3, llama3.1, llama3.2 - Meta's Llama-Modelle
  • mistral, mixtral - Mistral AI Modelle
  • qwen2.5 - Alibaba's Qwen-Modelle
  • phi3, phi4 - Microsoft's Phi-Modelle
  • gemma, gemma2 - Google's Gemma-Modelle
  • codellama - Spezialisiert auf Code
  • Und viele mehr auf ollama.com/library

Hinweis: Jedes installierte Ollama-Modell funktioniert automatisch mit dem System!

🎫 Zammad-Integration

Beliebige Zammad-Instanz verwenden:

Das System funktioniert mit jeder Zammad-Installation:

  • ✅ Zammad Cloud (https://ihre-firma.zammad.com)
  • ✅ Self-Hosted Zammad (eigener Server)
  • ✅ Lokale Entwicklungs-Instanz

Benötigt:

  1. Zammad-URL (z.B. https://ihre-firma.zammad.com)
  2. API-Token mit folgenden Berechtigungen:
    • Admin (für Benutzer/Organisationen)
    • Ticket Agent (für Tickets)

Hinweis: Jede Organisation kann ihre eigene Zammad-Instanz verwenden!

🏢 Multi-Tenant-Fähigkeit

✅ Das System unterstützt mehrere Organisationen gleichzeitig!

Jede Organisation/Firma kann das System mit eigener Konfiguration nutzen:

  • Firma A: Eigene Zammad-Instanz + eigener Eden AI Key + eigene Ollama-Installation
  • Firma B: Andere Zammad-Instanz + anderer Eden AI Key + andere Modelle
  • Firma C: Wieder andere Konfiguration

Datentrennung:

  • ✅ Jeder Benutzer hat eigene Einstellungen im Browser (LocalStorage)
  • ✅ Keine Vermischung von Daten zwischen Organisationen
  • ✅ Jeder kann eigene API-Keys verwenden
  • ✅ Kosten und Rate-Limits sind pro Organisation getrennt

Verwendung:

  1. Jede Organisation erstellt eine eigene JSON-Konfiguration
  2. Agenten laden ihre Organisations-Konfiguration beim ersten Start
  3. System funktioniert sofort mit der richtigen Konfiguration
  4. Wechsel zwischen Organisationen durch Laden einer anderen JSON

✍️ Signatur-System

Konfigurieren Sie das Signatur-System:

  • Standard-Signatur - Standardmäßig verwendete Signatur
  • Auto-Einfügung - Automatische Einfügung in E-Mails
  • Formatierung - Signatur-Format und -Stil
  • Backup - Automatische Backup-Einstellungen

🔍 Duplikat-Erkennung

Konfigurieren Sie die Duplikat-Erkennung:

  • Ähnlichkeits-Schwellenwert - Mindestähnlichkeit für Duplikate
  • Automatische Erkennung - Aktivierung der automatischen Erkennung
  • Benachrichtigungen - Benachrichtigungen bei Duplikaten
  • Performance - Optimierungseinstellungen

🎫 Ticket-Einstellungen

Konfigurieren Sie das Ticket-System:

  • Standard-Priorität - Standardmäßige Ticket-Priorität
  • Auto-Zuweisung - Automatische Zuweisung von Tickets
  • Benachrichtigungen - E-Mail-Benachrichtigungen
  • Workflow - Ticket-Workflow-Einstellungen

🔧 System-Einstellungen

Allgemeine System-Konfiguration:

  • Sprache - System-Sprache
  • Zeitzone - System-Zeitzone
  • Backup - Automatische Backup-Einstellungen
  • Logging - Log-Level und -Verwaltung
✅ Tipp: Testen Sie alle Einstellungen nach Änderungen, um sicherzustellen, dass das System ordnungsgemäß funktioniert.

🔧 Troubleshooting

Häufige Probleme und Lösungen
Hier finden Sie Lösungen für häufige Probleme und Tipps zur Fehlerbehebung.

🚫 Anmelde-Probleme

Problem: Kann mich nicht anmelden
Lösungsschritte:
  1. Überprüfen Sie Ihre E-Mail-Adresse und Passwort
  2. Stellen Sie sicher, dass Caps Lock deaktiviert ist
  3. Löschen Sie Browser-Cache und Cookies
  4. Versuchen Sie es mit einem anderen Browser
  5. Kontaktieren Sie den Administrator

🤖 KI-Integration Probleme

Problem: Eden AI funktioniert nicht
Lösungsschritte:
  1. Überprüfen Sie Ihren API-Schlüssel
  2. Stellen Sie sicher, dass Sie Internetverbindung haben
  3. Überprüfen Sie Ihr Eden AI-Konto
  4. Testen Sie die Verbindung in den Einstellungen
  5. Kontaktieren Sie den Eden AI-Support
Problem: Ollama funktioniert nicht
Lösungsschritte:
  1. Überprüfen Sie, ob Ollama läuft
  2. Stellen Sie sicher, dass das Modell geladen ist
  3. Überprüfen Sie die Ollama-URL
  4. Testen Sie die Verbindung in den Einstellungen
  5. Starten Sie Ollama neu

🎫 Ticket-Probleme

Problem: Kann kein Ticket erstellen
Lösungsschritte:
  1. Überprüfen Sie, ob alle Pflichtfelder ausgefüllt sind
  2. Stellen Sie sicher, dass Sie die richtige Berechtigung haben
  3. Überprüfen Sie Ihre Internetverbindung
  4. Laden Sie die Seite neu
  5. Kontaktieren Sie den Administrator
Problem: Ticket wird nicht gespeichert
Lösungsschritte:
  1. Überprüfen Sie Ihre Internetverbindung
  2. Stellen Sie sicher, dass Sie angemeldet sind
  3. Überprüfen Sie die Browser-Konsole auf Fehler
  4. Versuchen Sie es mit einem anderen Browser
  5. Kontaktieren Sie den Administrator

✍️ Signatur-Probleme

Problem: Signatur wird nicht angezeigt
Lösungsschritte:
  1. Überprüfen Sie, ob eine Signatur erstellt wurde
  2. Stellen Sie sicher, dass die Signatur aktiviert ist
  3. Überprüfen Sie die Signatur-Einstellungen
  4. Testen Sie mit einer anderen Signatur
  5. Kontaktieren Sie den Administrator
Problem: JSON-Import funktioniert nicht
Lösungsschritte:
  1. Überprüfen Sie das JSON-Format
  2. Stellen Sie sicher, dass die Datei gültig ist
  3. Überprüfen Sie die Dateigröße
  4. Versuchen Sie es mit einer anderen Datei
  5. Kontaktieren Sie den Administrator

🔍 Duplikat-Erkennung Probleme

Problem: Duplikate werden nicht erkannt
Lösungsschritte:
  1. Überprüfen Sie den Ähnlichkeits-Schwellenwert
  2. Stellen Sie sicher, dass die Erkennung aktiviert ist
  3. Überprüfen Sie die Eingabedaten
  4. Testen Sie mit bekannten Duplikaten
  5. Kontaktieren Sie den Administrator

🌐 Netzwerk-Probleme

Problem: Langsame Verbindung
Lösungsschritte:
  1. Überprüfen Sie Ihre Internetverbindung
  2. Schließen Sie andere Browser-Tabs
  3. Löschen Sie Browser-Cache
  4. Versuchen Sie es mit einem anderen Browser
  5. Kontaktieren Sie Ihren Internetanbieter

📞 Support kontaktieren

Wenn Sie weitere Hilfe benötigen:

⚠️ Wichtiger Hinweis: Bei kritischen Problemen kontaktieren Sie bitte sofort den Administrator oder den technischen Support.