Benutzerübersicht

Die Benutzerverwaltung von GPTBots bietet ein leistungsstarkes Benutzerverwaltungssystem, mit dem Sie Benutzeridentitäten effizient steuern und Benutzerattribute sowie Chatverläufe zentral verwalten können. Benutzer:innen sind Endnutzer:innen, die Konversationen mit Agent:innen oder Workflows initiieren. Entwickler:innen haben die Möglichkeit, jeder Nutzerin und jedem Nutzer eine eindeutige Benutzer-ID (user_id) zuzuweisen. Über diese Benutzer-ID lassen sich Identitäten kanalübergreifend verknüpfen, konsolidieren und für Geschäftsabfragen sowie die Verwaltung von Benutzerattributen und Chatverläufen nutzen.

Die User-CDP-Informationen (Customer Data Platform) werden für jede Agentin bzw. jeden Agenten und Workflow separat gespeichert. Für denselben Benutzer oder dieselbe Benutzerin sind die Daten zwischen verschiedenen Agent:innen und Workflows isoliert.

Benutzersystem im Überblick

flowchart LR
 subgraph Col1["Quellplattform"]
        LC["LiveChat"]
        IC["Intercom"]
        WG["Widget"]
        TG["Telegram"]
  end
 subgraph Col2_5["Sub-Channel der Quellplattform"]
        tgb01["TGBOT01"]
        tgb02["TGBOT02"]
  end
 subgraph Col2["Anonyme ID"]
        a1["lc0001"]
        a2["ic0001"]
        a3["wg0001"]
        tga1["tb0001"]
        tga2["tg0001"]
  end
 subgraph Col3["Benutzer-ID"]
        U1["ABC123"]
        U2["ABC456"]
  end
 subgraph Col4["Konversations-ID"]
        c1["c001"]
        c2["c002"]
        c3["c003"]
        c4["c004"]
        c5["c005"]
  end
 subgraph Col5["Agent:in/Workflow"]
        Bot["Agent:in
        Workflow"]
  end
    LC -- Generiert anonyme ID --> a1
    IC -- Generiert anonyme ID --> a2
    WG -- Generiert anonyme ID --> a3
    TG -- Nutzer:in aus Sub-Channel --> tgb01 & tgb02
    tgb01 -- Generiert anonyme ID --> tga1
    tgb02 -- Generiert anonyme ID --> tga2
    a1 -- Setze user_id --> U1
    a2 -- Setze user_id --> U1
    a3 -- Setze user_id --> U2
    tga1 -- Setze user_id --> U2
    tga2 -- Setze user_id --> U2
    U1 -- Generiere neue Konversations-ID --> c1
    U1 -- Generiere neue Konversations-ID --> c2
    U2 -- Generiere neue Konversations-ID --> c3
    U2 -- Nutze bestehende Konversations-ID --> c4
    c4 -- Bei Ablauf (>60 Minuten)
    Generiere neue Konversations-ID --> c5
    c1 --> Bot
    c2 --> Bot
    c3 --> Bot
    c4 --> Bot
    c5 --> Bot

     LC:::redStyle
     IC:::blueStyle
     WG:::greenStyle
     TG:::purpleStyle
     tgb01:::purpleStyle
     tgb02:::purpleStyle
     a1:::redStyle
     a2:::blueStyle
     a3:::greenStyle
     tga1:::purpleStyle
     tga2:::purpleStyle
     U1:::userGray
     U2:::userGray
     c1:::redStyle
     c2:::blueStyle
     c3:::greenStyle
     c4:::purpleStyle
     c5:::purpleStyle
    classDef userGray fill:#f5f5f5,stroke:#e6e6e6,color:#222
    classDef redStyle fill:#ffd6d6,stroke:#ffbdbd,color:#222
    classDef blueStyle fill:#dff0ff,stroke:#cfeaff,color:#222
    classDef greenStyle fill:#ecffd9,stroke:#d5ffb3,color:#222
    classDef purpleStyle fill:#f1e0ff,stroke:#e1c7ff,color:#222
    style Col1 stroke:#757575

• Die anonyme ID (anonymous_id) wird vom GPTBots-Systemdienst automatisch basierend auf der Quellplattform der Nutzer:innen generiert.
• Das Setzen einer user_id ist optional. Entwickler:innen können je nach Geschäftsanforderung entscheiden, ob sie eine Benutzer-ID vergeben, um eine kanalübergreifende Identitätsverknüpfung und Attributfreigabe zu ermöglichen.

Definitionen

Benutzer:in

Ein:e Benutzer:in ist ein:e Endnutzer:in, der/die mit einer Agentin oder einem Agenten interagiert.

Benutzer-ID (user_id)

Eine eindeutige Kennung, die Endnutzer:innen von Unternehmensentwickler:innen zugewiesen wird. Über die API können Entwickler:innen einer anonymous_id eine user_id zuweisen. Weitere Anwendungsfälle und Nutzungsmöglichkeiten finden Sie unter User-ID setzen.

• Die user_id hat Vorrang vor der anonymous_id.
• Mehrere anonymous_id-Werte können gleichzeitig einer einzigen user_id zugeordnet werden.

Anonyme ID (anonymous_id)

Wenn Nutzer:innen über Drittanbieter-Plattformen (wie Telegram, WhatsApp, LINE etc.) mit einer Agentin oder einem Agenten interagieren, verwendet GPTBots die plattformspezifische Nutzerkennung als anonymous_id. Details zur Generierungslogik finden Sie im Abschnitt Logik zur Generierung der anonymen ID.

Drittanbieter-Plattformen

Die GPTBots-Plattform unterstützt aktuell die Integration von Agent:innen mit zahlreichen Drittanbieter-Plattformen, darunter Intercom, Webchat, LiveChat, Telegram, WhatsApp und viele mehr.

Konversations-ID (conversation_id)

Die Konversations-ID ist eine eindeutige Kennung, die gemeinsam von Agent:in, Konversationstyp und user_id (oder anonymous_id) generiert wird. Sie dient als kleinste Einheit zur Trennung verschiedener Geschäftsszenarien (in der Regel mit mehreren message_id).

• Die conversation_id verfällt automatisch nach 60 Minuten, außer bei IDs, die über die API generiert werden – diese haben keine Ablaufzeit.
• Für Drittanbieter-Plattformen und Widget-Kanäle wird nach Ablauf der conversation_id automatisch eine neue ID generiert, um eine neue Konversation zu starten.

Nachrichten-ID (message_id)

Die Nachrichten-ID kennzeichnet einen einzelnen Nachrichtenaustausch zwischen Agent:in und Benutzer:in und stellt die kleinste Einheit einer Konversation dar.

• Die message_id wird von der GPTBots-Plattform generiert und kann von Entwickler:innen nicht angepasst werden.
• Die message_id gehört zu einer conversation_id, wobei eine conversation_id in der Regel mehrere message_id enthält.

Konversationstyp (conversation_type)

Der Konversationstyp identifiziert das Szenario, in dem ein:e Benutzer:in eine Konversation startet, z. B. Arbeitsbereich-Workflow, WhatsApp, API, Arbeitsbereich-Suche usw.

Prinzip der Konversations-ID-Generierung

Wenn Nutzer:innen über Drittanbieter-Plattformen eine Konversation mit einer Agentin oder einem Agenten starten, generiert das System eine anonymous_id basierend auf der jeweiligen Plattform und erstellt automatisch eine conversation_id auf Basis dieser anonymous_id, um einen Dialog zwischen Benutzer:in und Agent:in zu kapseln.

• Bei Nutzung der API müssen Entwickler:innen vorab eine conversation_id generieren, bevor sie eine Konversation mit Agent:in oder Workflow starten.
• Für Nicht-API-Kanäle wird die conversation_id von GPTBots automatisch generiert.

Logik zur Generierung der anonymen ID

Anonyme IDs dienen der eindeutigen Identifizierung von Nutzer:innen über verschiedene integrierte Plattformen und Kanäle hinweg. Die folgende Tabelle zeigt die Generierungslogik für anonyme IDs je Plattform:

Logik für anonyme IDs in GPTBots-eigenen Kanälen

Für GPTBots-eigene Kanäle werden anonyme IDs auf Basis des Browser-Fingerprints generiert:

Wenn ein:e Nutzer:in im GPTBots-Portal angemeldet ist, wird die GPTBots-Konto-ID automatisch als user_id gesetzt und mit der anonymous_id (Browser-Fingerprint-ID) verknüpft.

Konversationstypen und Quell-IDs

• Konversationstyp (conversation_type): Kennzeichnet den Integrationskanal, über den eine Konversation gestartet wurde (z. B. Arbeitsbereich, API, Iframe, WhatsApp, LINE usw.). Dieses Feld ermöglicht das Filtern von Logdaten nach Kanaltyp.
• Quell-ID (source_id): Kennzeichnet den Subtyp des Integrationskanals (z. B. verschiedene LINE-Channel-IDs, unterschiedliche Telegram-Bot-IDs). Damit können Logdaten nach Sub-Channel gefiltert werden.

⚠️ Hinweis: Die Feldwerte in den obigen Tabellen können als Filterkriterien bei der Abfrage von Konversationsdaten über die API: Konversationsliste abrufen verwendet werden.
Für Drittanbieter-Plattformen wie LINE und Telegram, die mehrere Sub-Channels unterstützen, ermöglicht das „Agent-Log“ eine zweistufige Filterung nach Konversationstyp.

Mit der Benutzerverwaltung von GPTBots behalten Sie stets die Kontrolle über Benutzeridentität, Benutzerattribute und kanalübergreifende Interaktionen – für maximale Effizienz und Transparenz in Ihrem Unternehmen.