> ## Documentation Index
> Fetch the complete documentation index at: https://docs.armin.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Aktuelle Produktupdates und neue Funktionen

<Update label="13. Mai" description="v2.2" tags={["Posteingang", "Planung", "Produktivität"]}>
  ## Geplanter Versand, Senden & Snooze und Tastenkürzel

  ### Geplanter Versand

  Plan Nachrichten für später. Wähl Schnellvorlagen oder ein eigenes Datum und eine Uhrzeit — die Nachricht wird gehalten und zum geplanten Moment automatisch zugestellt.

  * **Schnellvorlagen**: Häufige Optionen wie „Später heute“, „Morgen früh“ oder „Nächsten Montag“
  * **Eigenes Datum & Uhrzeit**: Jeder zukünftige Zeitpunkt für präzise Planung
  * **Jederzeit abbrechen**: Geplante Nachrichten zeigen einen klaren Hinweis mit Abbrechen-Button, bevor sie gesendet werden

  ### Senden & Snooze

  Sende eine Nachricht und setz das Ticket sofort auf Wartestellung — in einem Schritt. Kombiniere Antwort und Snooze, damit das Ticket zur richtigen Zeit wieder erscheint.

  * **Snooze-Schnellvorlagen**: Snooze für 1 Stunde, 4 Stunden, morgen, nächste Woche und mehr
  * **Natürliche Sprache**: Tippe Daten in Alltagssprache (z. B. „nächsten Freitag um 14 Uhr“) — u. a. Deutsch, Englisch, Französisch, Niederländisch, Spanisch, Italienisch, Portugiesisch und Russisch
  * **Ein-Klick-Ablauf**: Antworten und Snoozen gemeinsam über das Dropdown am Senden-Button

  ### Tastenkürzel

  Arbeite schneller im Posteingang mit Tastenkürzeln für häufige Sendeaktionen:

  * **⌘/Ctrl + Enter** — Nachricht senden
  * **⌘/Ctrl + Shift + Enter** — Senden & Ticket lösen
  * **⌘/Ctrl + Alt + Enter** — Senden & auf Kundenantwort warten
  * **⌘/Ctrl + Alt + S** — Dialog für geplanten Versand öffnen
  * **⌘/Ctrl + Alt + H** — Dialog für Senden & Snooze öffnen
</Update>

<Update label="2. Januar" description="v2.1" tags={["Export", "CSAT", "Workflows", "Verbesserungen"]}>
  ## Leistungsverbesserungen & Fehlerbehebungen

  ### Produkt-Feldtyp für Tickets

  Konfiguriere Produktfelder so, dass Produkte aus verbundenen Shop-Integrationen geladen werden. Wähl die Integrationen (Shopify, WooCommerce, Billbee, PlentyOne und mehr) und sieh verfügbare Produkte direkt in der Feldkonfiguration.

  * **Integrationsauswahl**: Wähl konkrete Shop-Integrationen als Produktquelle
  * **Echtzeit-Vorschau**: Sieh verfügbare Produkte während der Konfiguration
  * **Intelligente Filterung**: Nicht-öffentliche Shopify-Produkte werden automatisch ausgeschlossen

  ### Flow-Tester: Echte Ticketdaten importieren

  Der Workflow-Flow-Tester kann jetzt echte Ticket-Nachrichten und Anhänge importieren — für realistischere Tests.

  #### Wichtige Funktionen

  * **Ticket-Nachrichten importieren**: Lade den Gesprächsverlauf über die Ticketnummer
  * **Anhänge**: Importierte Bilder als Thumbnails, Dateien mit passenden Icons
  * **Formatierung bleibt erhalten**: HTML, Links und Textstile aus den Originalnachrichten
  * **Klare Avatare**: Kundeninitialen, Agenten-Avatare und KI-Agenten-Hinweise
  * **Klare Testtrennung**: Ein „Test gestartet“-Trenner trennt importierte Historie von neuen Testnachrichten

  <Tip>
    Aktivier „Echte Daten verwenden“ im Ticketdaten-Popover, gib eine Ticketnummer ein und klick auf Abrufen — so lädst du den Gesprächsverlauf in deinen Flow-Test.
  </Tip>

  ### CSAT-Exportfelder

  CSAT-bezogene Spalten sind im erweiterten Ticket-Export verfügbar — für Kundenzufriedenheitsdaten in CSV- und Excel-Exporten.

  #### Neue Exportspalten

  * **csat\_score**: Kundenzufriedenheitsbewertung (1–5)
  * **csat\_comment**: Freitext-Feedback aus der Umfrage
  * **csat\_survey\_sent**: Ob eine CSAT-Umfrage für das Ticket gesendet wurde
  * **csat\_submitted\_at**: Zeitpunkt der Kundenantwort

  <Tip>
    Wähl diese Spalten im Exportmodus, wenn du Tickets als CSV oder Excel exportierst — so kommen CSAT-Daten in deine Berichte.
  </Tip>
</Update>

<Update label="2. Januar" description="v2.1" tags={["CSAT", "WhatsApp", "Widget", "Workflows", "Major"]}>
  ## CSAT-Umfragen für WhatsApp & Web-Widget

  <Frame>
    <img src="https://placehold.co/1200x675/4361ee/white?text=CSAT+Surveys%0AWhatsApp+%26+Widget" alt="CSAT-Umfragen für WhatsApp und Web-Widget" />
  </Frame>

  Kundenzufriedenheitsumfragen funktionieren jetzt auf mehr Kanälen. Sammle Feedback direkt über WhatsApp und dein Web-Widget — zusätzlich zu E-Mail.

  ### Neue Kanalunterstützung

  #### WhatsApp

  * **CTA-Button**: Umfragen werden mit einem nativen „Bewerten“-Button gesendet
  * **Browser-basierte Umfrage**: Öffnet das vollständige Formular im Browser des Kunden
  * **Nahtloser Ablauf**: Kein App-Wechsel nötig

  #### Web-Widget (v1 & v2)

  * **Interaktive Emoji-Buttons**: Kunden sehen klickbare Emoji-Bewertungen direkt im Chat (😡 😟 😐 😊 😍)
  * **Bewertung mit einem Klick**: Zufriedenheit bewerten, ohne das Gespräch zu verlassen
  * **Sofortiges Feedback**: Antworten werden direkt erfasst

  ### So funktioniert es

  1. Füg einen **CSAT-Umfrage**-Knoten zu deinem Workflow hinzu
  2. Konfiguriere die Nachrichtenvorlage pro Kanal
  3. Beim Auslösen:
     * **WhatsApp**: Nachricht mit „Bewerten“-CTA → Umfrage im Browser
     * **Web-Widget**: Emoji-Bewertung inline → Bewertung sofort erfasst
     * **E-Mail**: Klickbare Emoji-Skala (wie bisher)

  ### Kanalspezifische Variablen

  | Variable           | E-Mail | WhatsApp | Web-Widget |
  | ------------------ | ------ | -------- | ---------- |
  | `{{survey_link}}`  | ✅      | ✅        | ✅          |
  | `{{likert_scale}}` | ✅      | ❌        | ✅          |

  <Tip>
    Für WhatsApp nutze `{{survey_link}}` in deiner Nachricht. Der CTA-Button zum Öffnen der Umfrage wird automatisch ergänzt.
  </Tip>

  <Info>
    Social-Kanäle (Instagram, Facebook, TikTok, YouTube) folgen in Kürze!
  </Info>
</Update>

<Update label="25. Oktober" description="v2.0" tags={["Ticketfelder", "KI", "Analytics", "Major"]}>
  ## Benutzerdefinierte Ticketfelder mit KI-Auto-Befüllung

  <Frame>
    <img src="https://placehold.co/1200x675/4361ee/white?text=Custom+Ticket+Fields%0AAI+Auto-Population" alt="Benutzerdefinierte Ticketfelder mit KI-Auto-Befüllung" />
  </Frame>

  Erstell und verwalte benutzerdefinierte Ticketfelder mit KI-gestützter Auto-Befüllung, Analytics und intelligenter Validierung.

  ### Wichtige Funktionen

  * **🎯 5 Feldtypen**: Text, Zahl, Dropdown, Boolean und Produkt — vollständig anpassbar
  * **🤖 KI-Befüllung**: Felder automatisch aus Gesprächskontext, Bestellhistorie und ähnlichen Tickets füllen
  * **📊 Analytics**: Nutzung, Trends und Drilldown auf konkrete Werte
  * **🛍️ Intelligente Produktauswahl**: Suche in Kundenbestellungen und im Produktkatalog inkl. Varianten
  * **✅ Intelligente Validierung**: Kontextbezogene Pflichtfeldprüfung mit Review-Workflows
  * **🔍 Starke Filter**: Posteingang nach jedem Feldwert filtern

  ### Feldtypen

  #### Textfeld

  * Einzeilig oder mehrzeilig
  * Auto-Save bei Verlassen des Felds oder Enter
  * KI kann Informationen aus Gesprächen extrahieren

  #### Zahlenfeld

  * Ganzzahlen oder Dezimalwerte
  * Auto-Save bei Verlassen des Felds oder Enter
  * Ideal für Mengen, Beträge oder Bewertungen

  #### Dropdown-Feld

  * Einzelauswahl mit eigenen Optionen
  * Unterstützt Hierarchien (z. B. Kategorie > Unterkategorie)
  * KI wählt die passendste Option anhand des Kontexts

  #### Boolean-Feld

  * Ja/Nein-Umschalter
  * Sofortiges Speichern bei Änderung
  * Einfache binäre Entscheidungen

  #### Produktfeld

  * Suche in aktuellen Kundenbestellungen (priorisiert)
  * Zugriff auf den Produktkatalog aller Shop-Integrationen
  * Varianten mit verschachtelter Auswahl
  * Zeigt Bestellkontext (z. B. „iPhone 15 – 256GB Schwarz (Bestellung #12345)“)
  * Für schnelles Laden gecacht
  * Funktioniert mit Shopify, WooCommerce und mehr

  ### KI-Analyse

  #### Automatische Befüllung

  * **Bei Erstellung**: Analysiert die erste Kundennachricht und befüllt KI-fähige Felder
  * **Bei Lösung**: Versucht fehlende Pflichtfelder erneut mit dem gesamten Gesprächskontext
  * **Confidence Scoring**: Speichert nur Werte mit hoher Konfidenz (>0,7)
  * **Ähnliche Tickets**: Lernt aus Mustern bereits gelöster Tickets
  * **Produktkontext**: Extrahiert Produkte aus der Bestellhistorie

  #### Smart-Review-Workflow

  Wenn die KI Pflichtfelder nach 3 Versuchen nicht befüllen kann:

  * Ticket wird automatisch auf Status `On Hold` gesetzt
  * Substatus `Needs Review` wird gesetzt
  * Erscheint in der Systemansicht „Needs Review“
  * Agenten können fehlende Felder manuell ergänzen und lösen

  ### Analytics-Dashboard

  #### Meistgenutzte Werte

  * Horizontales Balkendiagramm der häufigsten Feldwerte
  * Klick auf einen Wert öffnet die passenden Tickets
  * Filter nach Zeitraum und Datenumfang

  #### Trends über die Zeit

  * Liniendiagramm für Nutzungstrends
  * Glatte Kurven zur Mustererkennung
  * Automatische Erkennung der meistgenutzten Werte

  #### Alle-Werte-Tabelle

  * Paginierte Tabelle aller Feldwerte
  * Sortierbare Spalten mit Suche
  * Klick-zum-Filtern im Posteingang

  ### Filter & Suche

  * **Feldbasierte Filter**: Posteingang nach jedem Feldwert filtern
  * **Gruppierte Oberfläche**: Felder mit durchsuchbaren Optionen
  * **Mehrere Felder**: Mehrere Feldfilter gleichzeitig
  * **Label-Erhalt**: Filterkontext bleibt bei Navigation erhalten
  * **Backend-Optimierung**: Effiziente Abfragen für komplexe Filter

  ### Validierung

  #### Kontextbezogene Validierung

  * **Allgemeiner Kontext**: Prüft nur nicht-KI-Pflichtfelder
  * **Lösungskontext**: Prüft alle Pflichtfelder (KI + nicht-KI)
  * **Massenaktionen**: Verhindert Massenlösen, wenn nicht-KI-Pflichtfelder fehlen
  * **Vorschau-Modal**: Zeigt betroffene Tickets vor dem Blockieren

  #### Feldschlüssel-Validierung

  * Automatisch aus dem Anzeigenamen erzeugt
  * Echtzeit-Prüfung auf Eindeutigkeit
  * Validierung beim Verlassen des Felds, nicht bei jedem Tastendruck
  * Klare Fehlermeldungen mit Inline-Feedback

  ### Performance

  * **Caching**: Produktkataloge für 10 Minuten (Limit 500 Produkte)
  * **Bedingtes Prefetching**: Produktdaten nur laden, wenn ein Pflicht-Produktfeld existiert
  * **Queue-Optimierung**: Früher Abbruch, wenn die Organisation keine KI-fähigen Felder hat
  * **Inkrementelle Ansichtszähler**: Echtzeit-Zähler ohne vollständige Neuberechnung

  ### Anwendungsfälle

  * **Produkt-Support**: Tickets automatisch mit gekauften Produkten verknüpfen
  * **Fallklassifikation**: Tickets nach Typ, Abteilung oder Priorität kategorisieren
  * **SLA-Tracking**: Eigene Felder für Antwortzeiten
  * **Workflow-Routing**: Tickets anhand von Feldwerten steuern
  * **Reporting**: Trends nach eigenen Dimensionen auswerten
  * **Compliance**: Pflichtinformationen für regulatorische Anforderungen erfassen

  ### Kanalkonfiguration

  * **Kanalspezifische Felder**: Unterschiedliche Felder je Kanal (E-Mail, WhatsApp usw.)
  * **Pflichtfeld-Steuerung**: Felder pro Kanal als Pflicht oder optional
  * **Smarte Defaults**: KI lernt kanalspezifische Muster

  ### Einstellungen & Verwaltung

  * **Feldkonfiguration**: Einfache Einrichtung mit Vorschau
  * **Aktiv / Archiviert**: Lebenszyklus der Felder verwalten
  * **Per Drag-and-Drop sortieren**: Anzeigereihenfolge anpassen
  * **Massenaktionen**: Mehrere Felder archivieren oder aktivieren

  <Check>
    Alle Felddaten synchronisieren sich in Echtzeit über Supabase Realtime — kein manuelles Aktualisieren nötig.
  </Check>

  <Warning>
    Für Produktfeld-Funktionen braucht die KI-Analyse aktive Shop-Integrationen (Shopify, WooCommerce usw.).
  </Warning>
</Update>

<Update label="10. Oktober" description="v1.0" tags={["Workflows", "Automatisierung", "Major"]}>
  ## CSAT-Umfrage als Workflow-Trigger

  <Frame>
    <img src="https://placehold.co/1200x675/4361ee/white?text=CSAT+Workflow+Triggers%0AAutomate+Follow-ups" alt="CSAT-Umfrage als Workflow-Trigger" />
  </Frame>

  Starte Workflows automatisch anhand von CSAT-Antworten — für passende Follow-ups.

  ### Wichtige Funktionen

  * **📊 Score-basierte Trigger**: Workflows ausführen, wenn Kunden bestimmte CSAT-Scores abgeben
  * **🎯 Intelligente Filter**: Trigger auf Score-Bereiche (z. B. niedrig ≤ 3, hoch ≥ 4)
  * **⚡ Sofortige Reaktion**: Workflows starten direkt nach dem Absenden der Umfrage
  * **🔄 Multi-Kanal**: Funktioniert mit E-Mail; weitere Kanäle folgen.

  ### Anwendungsfälle

  * **Low-Score-Recovery**: Bei Score ≤ 2 automatisch an Senior Support eskalieren
  * **Danke-Nachrichten**: Wertschätzung bei hohen Bewertungen (Score ≥ 4)
  * **Feedback einholen**: Bei neutralen Scores um detailliertes Feedback bitten
  * **Interne Alerts**: Team Leads über negative Erfahrungen informieren

  ### So funktioniert es

  1. Der Kunde sendet die CSAT-Umfrage nach Ticketlösung
  2. Das System prüft konfigurierte Workflow-Trigger
  3. Passende Workflows starten automatisch anhand des Scores
  4. Follow-ups laufen sofort (E-Mails, Benachrichtigungen, Eskalationen)

  <Tip>
    Konfiguriere CSAT-Trigger unter Workflows → Flow erstellen → Trigger „CSAT-Umfrage abgesendet“
  </Tip>

  ### Sicherheitsfunktionen

  * Doppelauslösung vermeiden: Nicht mehrfach für dasselbe Ticket
  * Ausführungslimits: Rate Limiting gegen Spam
  * Kanalspezifische Konfigs: Unterschiedliche Ablaufzeiten pro Kanal

  <Check>
    Funktioniert mit bestehenden CSAT-Umfragen — keine Migration nötig.
  </Check>
</Update>

<Update label="10. Oktober" description="v1.0" tags={["Posteingang", "Produktivität", "Major"]}>
  ## Tickets auf Wartestellung mit smarter Planung

  <Frame>
    <img src="https://placehold.co/1200x675/4361ee/white?text=On-Hold+Tickets%0ASmart+Scheduling" alt="Tickets auf Wartestellung mit smarter Planung" />
  </Frame>

  Setz Tickets mit klarem Grund und automatischer Wiedereröffnung auf Wartestellung — ideal für Abhängigkeiten und Follow-ups.

  ### Wichtige Funktionen

  * **⏰ Geplante Auto-Wiedereröffnung**: Genaues Datum/Uhrzeit festlegen
  * **📝 Haltegründe**: Unterscheidung zwischen „Wartet auf Kunde“ und „Wartet intern“
  * **🎨 Visuelle Hinweise**: Farbige Badges (Grün = Kunde, Lila = Intern)
  * **⚙️ Organisations-Defaults**: Standarddauern für interne (3 Tage) und externe (7 Tage) Holds

  ### So funktioniert es

  1. Ticketstatus auf „On Hold“ setzen
  2. Grund wählen: Wartet auf Kunde oder Wartet intern
  3. Dauer wählen oder eigenes Datum/Uhrzeit setzen
  4. Ticket öffnet sich automatisch zum geplanten Zeitpunkt wieder

  ### Anwendungsfälle

  * **Kundenantwort**: Warten auf angeforderte Informationen
  * **Interne Abhängigkeiten**: Warten auf ein anderes Team oder System
  * **Geplante Follow-ups**: Nach bestimmter Zeit erneut nachfassen
  * **Produktverfügbarkeit**: Wieder öffnen, wenn das Produkt wieder verfügbar ist

  ### Visuelle Darstellung

  * **Badge**: Zeigt „Wieder öffnen am: \[Datum]“ mit Grund-Punkt
  * **Überfällig-Hinweise**: Überfällige On-Hold-Tickets klar markiert
  * **Schnellaktionen**: Hold-Zeit bearbeiten oder Hold mit einem Klick beenden
  * **Tooltip**: Hover für vollständigen Grund und Zeitstempel

  <Check>
    Tickets kehren zum geplanten Zeitpunkt automatisch in den Status „Open“ zurück — ohne manuelles Eingreifen.
  </Check>
</Update>

<Update label="10. Oktober" description="v1.0" tags={["Performance", "Fehlerbehebungen"]}>
  ## Leistungsverbesserungen & Fehlerbehebungen

  Schnellere Ticketladung und wichtige Fehlerbehebungen.

  ### Behoben

  * Verzögerungen beim Laden von Tickets in Organisationen mit hohem Volumen
  * Zuverlässigkeit der Sync-Engine verbessert
  * Caching-Probleme mit veralteten Daten behoben
  * Stabilität des Offline-Modus verbessert

  ### Performance-Gewinne

  * 50 % schnellerer initialer Ticketlisten-Load
  * Weniger Speicherverbrauch in langen Sessions
  * Besserer Umgang mit großen Anhängen
</Update>
