1. Funktionsübersicht

Die „Benutzerliste" ist das Benutzerprofilzentrum auf Ebene eines einzelnen Agents und richtet sich an Betreiber und Entwickler, um Folgendes einzusehen:

• Welche Endbenutzer sinnvolle Interaktionen mit diesem Agent hatten;
• Die Identitätskennzeichen jedes Benutzers (userId / anonyme ID);
• Die Anzahl der bereits erzeugten Schlüsselereignisse pro Benutzer;
• Die Aktivitätszeiten jedes Benutzers (Erstkontakt, letzte Aktivität).
• Weitere Informationen zum Benutzersystem finden Sie unter: Benutzerübersicht.

Einstieg: Entwicklerkonsole → Agent auswählen → Benutzerverwaltung (User Manage) → Benutzer (Users).

2. Regeln für die Benutzerliste

Kernregel: Nur Benutzer, die innerhalb dieses Agents mindestens ein „Schlüsselereignis" erzeugt haben, erscheinen in der Benutzerliste.

2.1 Wie die Benutzerliste entsteht

Im System existiert eine „Benutzerliste". Es gibt zwei Arten von Auslösepunkten für den Eintritt in die Benutzerliste:

Das heißt: Besucher, die lediglich Nachrichten gesendet, aber kein Schlüsselereignis ausgelöst haben, erscheinen nicht in der Benutzerliste. Nur wenn das LLM mindestens ein Schlüsselereignis aus dem Dialog extrahiert oder über API/UI manuell ein Schlüsselereignis erstellt wurde, wird der Benutzer in der Betriebsansicht „sichtbar".

2.2 Warum der Listeneintritt an Schlüsselereignisse gebunden ist

Schlüsselereignisse sind Faktenfragmente, die das System nach semantischer Extraktion aus dem Dialoginhalt als geschäftlich wertvoll einstuft (z. B. „Auszahlung", „Beschwerde", „Streitfall", „Kontoeröffnung erfolgreich" usw.). Mit „mindestens ein Schlüsselereignis erzeugt" als Eintrittskriterium wird sichergestellt:

• Die Liste konzentriert sich auf Benutzer mit echtem Geschäftswert und wird nicht von einmaligen Probebesuchern überschwemmt;
• Spalten wie „Anzahl der Schlüsselereignisse" und „Letzte Aktivität" sind aussagekräftig und vergleichbar;
• Nachgelagerte Betriebsmaßnahmen (Bearbeitung markieren, Outbound-Follow-up) verfügen über klare Ereignisanker.

2.3 Wie Schlüsselereignisse entstehen

Schlüsselereignisse stammen aus drei Auslösern:

• REALTIME (Echtzeit): Wird automatisch nach jeder neuen Nachricht im Gespräch ausgelöst;
• SCHEDULED (Geplant): Periodische Nachextraktion historischer Gespräche nach Plan;
• MANUAL (Manuell): Manuelles Klicken auf „Extrahieren" in der Gesprächsdetailseite.

Der Extraktionsprozess wird vom LLM gemäß dem aktuell für den Agent konfigurierten „Ereignistyp-Wörterbuch" und den Geschäftsregeln klassifiziert und gibt vier Operationstypen aus: CREATE / UPDATE / MERGE / DELETE.

Wenn Sie also möchten, dass die Benutzerliste eines Agents mehr Benutzer anzeigt, sollten Sie zuerst prüfen:
① Ist die Schlüsselereignis-Extraktion für diesen Agent aktiviert?
② Deckt das Ereignistyp-Wörterbuch die für Sie relevanten Geschäftsszenarien ab?

3. Identitätskennzeichen: userId und anonyme ID

3.1 Felddefinition

3.2 Prioritätsregel

Bei der Identifizierung „desselben Benutzers" befolgt das System:

Wenn userId vorhanden ist, gilt userId; wenn keine userId vorhanden ist, fällt das System auf AnonymousId zurück.

Die Darstellung der Spalte „Benutzeridentität" in der UI folgt derselben Regel: Es wird vorrangig userId angezeigt, andernfalls AnonymousId, und displayName (Spitzname) wird als Untertitel verwendet.

3.3 Beziehung zwischen beiden: Vom anonymen zum angemeldeten Upgrade

Der typische Lebenszyklus eines Endbenutzers ist:

                      
                      Besucher (nur anonymousId)  ──Login/Registrierung──▶  Registrierter Benutzer (mit userId)

                    

Die Plattform bietet bindUserId(botId, anonymousId, userId) für das Identitäts-Upgrade:

• Wenn die userId unter diesem Agent noch nicht existiert:
  • userId wird direkt in das vorhandene anonyme Profil eingetragen;
  • Die ursprüngliche primaryAnonymousId und die Liste der anonymen IDs bleiben erhalten, historische Schlüsselereignisse bleiben demselben Profil zugeordnet.
• Wenn die userId unter diesem Agent bereits existiert:
  • Alle anonymousIds des aktuellen anonymen Profils werden in das Profil des angemeldeten Benutzers zusammengeführt;
  • Das anonyme Profil wird gelöscht;
  • Damit wird die Erfahrung „erst anonymer Zugriff → dann Anmeldung am alten Konto → historisches Merging" realisiert.

Daher kann eine Benutzerzeile in der Liste folgenden Werdegang haben: ① mehrere anonyme IDs (mehrfaches Cookie-Löschen / geräteübergreifend), ② schließlich an dieselbe userId gebunden. Der Zähler in der Spalte „Anonyme ID" entspricht anonymousIds.length.

3.4 Wie Schlüsselereignisse einem Benutzer zugeordnet werden

Auf der Schlüsselereignis-Entität (c_bot_event) sind ebenfalls die Felder userId und anonymousId gespeichert. Beim Abfragen von Ereignissen im Detail-Drawer eines Benutzers gilt folgende Matching-Regel:

• Wenn der Benutzer bereits eine userId hat: Es werden nur Ereignisse mit event.userId == userId abgefragt;
• Wenn der Benutzer nur eine anonyme ID hat: Es werden Ereignisse abgefragt, bei denen event.userId nicht existiert und event.anonymousId == primaryAnonymousId.

Damit wird sichergestellt: Aufgewertete registrierte Benutzer sehen alle Ereignisse unter ihrer userId; noch nicht aufgewertete anonyme Benutzer sehen nur Ereignisse innerhalb ihrer anonymen Dimension und werden nicht fälschlicherweise zusammengefasst.

4. Zeitfelder: Erstkontakt vs. Letzte Aktivität

4.1 Felddefinition

4.2 Schreibregeln

• Erstkontakt: Wird nur einmal beim ersten Anlegen der Benutzerliste geschrieben und ändert sich danach nie. Verstehen Sie es als „Ausgangspunkt der Beziehung des Benutzers zu diesem Agent".
• Letzte Aktivität: Wird bei jedem der folgenden Ereignisse auf die aktuelle Zeit aktualisiert:
  • Der Benutzer hat innerhalb dieses Agents eine Nachricht gesendet;
  • Der Benutzer hat ein neues Schlüsselereignis erzeugt;
  • Der Status eines Schlüsselereignisses hat sich geändert;
  • Kontaktinformationen (Telefonnummer/Spitzname) wurden nachgetragen.

4.3 Geschäftsbedeutung

4.4 Standardsortierung der Liste

Die Benutzerliste wird standardmäßig absteigend nach letzter Aktivitätszeit angezeigt – die Benutzer mit der jüngsten Aktivität stehen oben.
Beide Zeitspalten unterstützen das Sortieren nach Zahlenwert durch Klick auf den Spaltenkopf.

5. Übersicht der Listenspalten

6. Bedienungsanleitung

6.1 Benutzer suchen

Das Stichwort-Suchfeld am oberen Rand der Seite unterstützt vier Arten der Übereinstimmung (eine Übereinstimmung genügt):

Hinweis: userId / anonyme ID unterstützen keine unscharfe Suche, der vollständige Wert muss eingegeben werden.
Anzeigename und Telefonnummer unterstützen die unscharfe Suche.

6.2 Schlüsselereignisse eines Benutzers anzeigen

Wenn Sie in der Benutzerzeile auf die Zahl in der Spalte „Schlüsselereignisse" (oder am Zeilenende auf „Anzeigen") klicken, lädt der rechte Drawer die Ereignisse seitenweise nach folgenden Bedingungen:

• Benutzerbereich: Filterung nach userId oder anonymer ID gemäß Regel aus Abschnitt 3.4;
• Sekundäre Filterung wird unterstützt: Ereigniskategorie, Status, Stichwort (Regex auf Basis der Ereigniszusammenfassung);
• Standardmäßige Sortierung absteigend nach Ereigniszeit;

Spalten im Ereignis-Drawer: Ereigniskategorie, Ereigniszusammenfassung, Status, Priorität, Konfidenz, Aktualisierungszeit.

6.3 Werte für Status, Priorität und Konfidenz

6.4 Häufige Betriebsmaßnahmen

• Neukundennachverfolgung: Filtern Sie Benutzer mit Erstkontakt in den letzten N Tagen;
• Aktivierung schlafender Benutzer: In Kombination mit der Schlüsselereignis-Kategorie können Benutzer herausgefiltert werden, die hochwertige Aktionen ausgeführt haben, aber inzwischen inaktiv sind;
• Liste unbearbeiteter Ereignisse: Wechseln Sie in den Benutzerdetail-Drawer, filtern Sie nach „Status = Ausstehend / In Bearbeitung" und führen Sie dann eine Massen-Nachverfolgung durch.

7. Häufige Fragen (FAQ)

Q1: Ich sehe, dass ein Benutzer im Frontend viele Nachrichten gesendet hat, aber er ist nicht in der Benutzerliste auffindbar?
A: Die Benutzerliste zeigt nur „Benutzer, die Schlüsselereignisse erzeugt haben" an. Wenn der Agent die Schlüsselereignis-Extraktion nicht aktiviert hat oder das Extraktionsergebnis leer ist (Nachrichteninhalte treffen keinen der konfigurierten Ereignistypen), wird der Benutzer nicht in die Liste aufgenommen. Bitte überprüfen Sie den Schalter „Schlüsselereignis-Extraktion" und das Ereignistyp-Wörterbuch des Agenten. Auch Gespräche im Debug-Bereich des Entwicklungsbereichs werden nicht zur Schlüsselereignis-Extraktion verwendet und nicht in der Benutzerliste angezeigt.

Q2: Warum erscheint derselbe reale Benutzer manchmal als anonyme ID und manchmal als userId?
A: Vor der Anmeldung erzeugt das SDK eine anonyme ID für den Endbenutzer für Sitzungen; nach der Anmeldung muss der Integrator die userId aus dem Geschäftssystem übergeben. Das System führt das anonyme Profil über bindUserId mit dem userId-Profil zusammen; in der Liste sehen Sie danach die userId-Zeile; die ursprüngliche anonyme ID bleibt in der anonymousIds-Liste zur Nachverfolgung erhalten.

Q3: „Letzte Aktivität" stimmt nicht mit der jüngsten Zeit in der Sitzungs-/Nachrichtentabelle überein?
A: Maßgeblich ist das Profil. Die letzte Aktivitätszeit wird zu vier Zeitpunkten aktualisiert: Nachrichteneingang, Ereigniserstellung, Statusänderung eines Ereignisses, Aktualisierung der Kontaktdaten. Treten Abweichungen auf, liegt es meist daran, dass eine Operation einen nicht standardmäßigen Pfad genommen hat (z. B. Offline-Import).

Q4: Kann „Erstkontakt" geändert werden?
A: Nein. Dieses Feld wird nur beim ersten Anlegen geschrieben, danach überschreibt es keine Aktualisierung mehr.

Q5: In welchem Verhältnis stehen Benutzerliste und Sitzungsliste?
A: Die Sitzungsliste (Dimension conversationId) erfasst jeden einzelnen Dialog; die Benutzerliste (Dimension userId / anonymousId) ist eine Aggregation auf Personenebene über den Sitzungen. Ein Benutzer kann mehreren Sitzungen entsprechen; ein Schlüsselereignis gehört zwingend zu einer Sitzung und ebenso zwingend zu einem Benutzerprofil.