Export & Datenmodell

Der Export ermöglicht es dir, die Rohdaten der Statistiken eines AI Agents als CSV-Datei herunterzuladen. So kannst du die Daten extern weiterverarbeiten, analysieren oder archivieren.

Export

Wo finde ich das?

Navigiere zu Stats → Export.

Erklärung – Was genau ist der Export?

Der Export liefert die Rohdaten der Statistiken eines AI Agents für einen ausgewählten Zeitraum. Die Daten werden als CSV-Datei bereitgestellt.

Eine CSV-Datei ist ein einfaches Tabellenformat, das sich mit gängigen Tools wie Microsoft Excel, Google Sheets oder Datenanalyse-Software öffnen und weiterverarbeiten lässt.

Verwendung – Export durchführen

Zeitraum auswählen und exportieren

Navigiere zu Stats → Export.
Klicke auf das Datumsfeld, um den Kalender zu öffnen.
Wähle einen Starttag und einen Endtag aus.
- Zur schnellen Auswahl stehen links vordefinierte Zeiträume bereit: z. B. „Gestern", „Letzte 7 Tage", „Letzter Monat" oder „Letzte 3 Monate".
- Der gewählte Zeitraum wird im Kalender farblich hervorgehoben.
Bestätige die Auswahl mit „Übernehmen".
Klicke auf „Exportieren".

Der Export wird nun verarbeitet. Während der Verarbeitung erscheint ein Ladeindikator mit dem Hinweis, die Seite nicht zu schließen.

Schließe das Fenster nicht, solange der Export noch läuft. Der Prozess kann einige Minuten in Anspruch nehmen.

Download-Link aufrufen

Sobald der Export abgeschlossen ist, wird ein Download-Link angezeigt. Dieser ist für 15 Minuten gültig. Lade die Datei daher unmittelbar nach Erscheinen des Links herunter. Der Exportzeitraum ist auf maximal drei Monate begrenzt.

Best Practices

Nutze die vordefinierten Zeiträume (z. B. „Letzter Monat") für regelmäßige, vergleichbare Auswertungen.
Lade die CSV-Datei unmittelbar nach Erscheinen des Download-Links herunter, da der Link nach 15 Minuten abläuft.

Datenmodell

Event-Tabelle

event_id

type

timestamp

bot_id

conversation_id

contact_id

version_id

payload

environment

channel_type

channel_id

label

flow_label

Beschreibung

ID des Events die festlegt, dass jeder Eintrag einzigartig ist

Der Typ des Events legt fest, welche Art von Event stattfand

Zeitpunkt des Events

ID des AI Agents

ID der Konversation

ID des Kontakts

ID der AI Agent-Version

Der aufgefasste Inhalt des Events

Umgebung, in der das Event stattfand (Test, Produktion oder Entwicklung)

Typ des verwendeten Channels

ID des verwendeten Channels

Name des ausgeführten Schritts

Name des Flows, in dem der Schritt sich befindet

Datentyp

uuid

timestamp

string

JSON string

string

Beschreibung des Event-Typen und des Payloads

Dokumentiert den Start eines Anrufs.

Beinhaltet:

die Rufnummer inklusive Ländervorwahl
ob es sich um eine mobile Nummer handelt

CALL_START

{
  "callStart": {
    "countryCode": "number",
    "isMobile": "boolean",
    "calledNumber": "string"
  },
}

Dokumentiert das Ende eines Anrufs. Beinhaltet auch den Grund und die Art des Anruf-Endes. Falls es sich um einen Transfer handelte, wird das Transferziel angegeben.

CALL_END

{
  "callEnd": {
    "reason": "string",
    "disconnectedBy": "string",
    "transferTarget": "string"
  }
}

Dokumentiert das Erstellen eines Kontakts und legt dessen ID fest.

CONTACT_CREATE

Dokumentiert die Erstellung einer Konversation und deren Sprache.

CONVERSATION_CREATE

{
  "conversationCreate": {
    "language": "string"
  }
}

Dokumentiert die Erkennung einer Entität und deren ID. Gibt Auskunft, mit welcher Genauigkeit diese getroffen wurde.

ENTITY_DETECT

{
  "entityDetect": {
    "entityId": "string",
    "score": "number"
  }
}

Dokumentiert die Erkennung einer Intention und deren ID. Gibt Auskunft, mit welcher Genauigkeit diese getroffen wurde.

INTENT_DETECT

{
  "intentDetect": {
    "intentId": "string",
    "score": "number"
  }
}

Dokumentiert den Versand einer Nachricht vom Agenten oder AI Agent.

Beinhaltet:

die ID der Nachricht
die Länge der Nachricht
die Größe (falls Datei)
die ID des Agenten (falls null, dann ist die Nachricht vom AI Agent)
den Typ der Nachricht

MESSAGE_SEND

{
  "messageSend": {
    "messageId": "string",
    "type": "string",
    "operatorId": "string",
    "length": "number",
    "size": "number"
  }
}

Dokumentiert den Empfang einer Nachricht vom User.

Beinhaltet:

die ID der Nachricht
die Länge der Nachricht
die Größe (falls Datei)
den Typ der Nachricht

MESSAGE_RECEIVE

{
  "messageReceive": {
    "messageId": "string",
    "type": "string",
    "length": "number",
    "size": "number"
  }
}

Dokumentiert den Status einer Nachricht: 0 = SENT 1 = READ 2 = DELIVERED 3 = FAILED -1 = UNRECOGNIZED

MESSAGE_STATUS_UPDATE

{
  "messageStatusUpdate": {
    "messageId": "string",
    "status": "string"
  }
}

Dokumentiert das Erstellen einer Organisation und deren ID.

ORGANIZATION_CREATE

 {
  "organizationCreate": {
    "organizationId": "string"
  }
}

Dokumentiert den Transfer eines Anrufs und das Transferziel.

CALL_TRANSFER

 {
  "callTransfer": {
    "target": "string"
  }
}

Dokumentiert die Antworten der KI-Einstellung "Generative KI" (mit RAG).

GENERATIVE_AI_DETECT

{"generativeAiDetect"     {"sourceIds": [] ,"trigger":"question_answering"}
}

INTERACTION

Dokumentiert die Ausführung von Schritten im AI Agent.

Beinhaltet:

die ID des Flows
die ID des Schrittes
den Typ des Schrittes

STEP_EXECUTE

{
  "stepExecute": {
    "flowId": "string",
    "stepId": "string",
    "type": "string"
  }
}

Dokumentiert die Ausführung eines Bedingungs-Schrittes.

Beinhaltet:

die ID des Flows
die ID des Schrittes
das Resultat der Bedingung, wobei “t” für wahr und “f” für falsch steht

STEP_CONDITION_EXECUTE

{
  "stepConditionExecute": {
    "flowId": "string",
    "stepId": "string",
    "result": "string"
  }
}

Dokumentiert die Ausführung eines A/B-Split-Schrittes.

Beinhaltet:

die ID des Flows
die ID des Schrittes
das Resultat des Splits, welches entweder “a” oder “b” ist

STEP_SPLIT_EXECUTE

{
  "stepSplitExecute": {
    "flowId": "string",
    "stepId": "string",
    "result": "string"
  }
}

Dokumentiert die Ausführung eines Kontext-Schrittes.

Beinhaltet:

die ID des Flows
die ID des Schrittes
den verwendeten Ausstieg
die ID der wahrscheinlichsten Intention

STEP_CONTEXT_EXECUTE

 {
  "stepContextExecute": {
    "flowId": "string",
    "stepId": "string",
    "outlet": "string",
    "topIntent": "string"
  }
}

Dokumentiert die Ausführung eines App-Modul-Schrittes.

Beinhaltet:

die ID des Flows
die ID des Schritts
die ID der App
die ID des App-Moduls
den Status-Code
die Dauer bis zur Antwort
ob die Ausführung erfolgreich war

STEP_APP_MODULE_EXECUTE

{
  "stepAppModuleExecute": {
    "flowId": "string",
    "stepId": "string",
    "appId": "string",
    "moduleId": "string",
    "statusCode": "number",
    "responseTime": "number",
    "responseOk": "boolean"
  }
}

Dokumentiert das Hinzufügen eines “Tags” zur Konversation und die ID des “Tags”.

CONVERSATION_TAG_ADDED

{
  "conversationTagAdded": {
    "tagId": "string"
  }
}

Dokumentiert das (erneute) Eröffnen einer Konversation. Gibt an, ob diese von einem AI Agent (null) oder einem Agenten (ID des Agenten)(wieder-)eröffnet wurde.

CONVERSATION_OPENED

{
"conversationOpened": {
"openedBy": "string",
"operatorId": "string"
}
}

Dokumentiert das Abschließen einer Konversation. Gibt an, ob diese von einem AI Agent (null) oder einem Agenten (ID des Agenten) abgeschlossen wurde.

CONVERSATION_CLOSED

{
"conversationClosed": {
"closedBy": "string",
"operatorId": "string"
}
}

Dokumentiert die Ausführung des »Übergabe an Agenten«-Elements.

REQUESTED_AGENT_HANDOVER

{
}

PreviousStatistiken NextEinstellungen

Last updated 1 month ago