> For the complete documentation index, see [llms.txt](https://docs.chatcaptain.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatcaptain.com/bot-verwalten/statistiken/export/datenmodell.md).

# Datenmodell

<table data-header-hidden data-full-width="true"><thead><tr><th width="231.328125"></th><th></th><th width="268.046875"></th><th></th><th></th><th width="144.35546875"></th><th width="106.57421875"></th><th width="104.671875"></th><th width="305.1328125"></th><th width="128"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Event-Tabelle</strong></td><td><strong>event_id</strong></td><td><strong>type</strong></td><td><strong>timestamp</strong></td><td><strong>bot_id</strong></td><td><strong>conversation_id</strong></td><td><strong>contact_id</strong></td><td><strong>version_id</strong></td><td><strong>payload</strong></td><td><strong>environment</strong></td><td><strong>channel_type</strong></td><td><strong>channel_id</strong></td></tr><tr><td>Beschreibung</td><td>ID des Events die festlegt, dass jeder Eintrag einzigartig ist</td><td>Der Typ des Events legt fest, welche Art von Event stattfand</td><td>Zeitpunkt des Events</td><td>ID des Bots</td><td>ID der Konversation</td><td>ID des Kontakts</td><td>ID der Bot-Version</td><td>Der aufgefasste Inhalt des Events</td><td>Umgebung, in der das Event stattfand (Test, Produktion oder Entwicklung)</td><td>Typ des verwendeten Channels</td><td>ID des verwendeten Channels</td></tr><tr><td>Datentyp</td><td>uuid</td><td>CALL_START | CALL_END | CONTACT_CREATE | CONVERSATION_CREATE | ENTITY_DETECT | INTENT_DETECT | MESSAGE_SEND | MESSAGE_RECEIVE | MESSAGE_STATUS_UPDATE | ORGANIZATION_CREATE | CALL_TRANSFER | INTERACTION | STEP_EXECUTE | STEP_CONDITION_EXECUTE | STEP_SPLIT_EXECUTE | STEP_CONTEXT_EXECUTE | STEP_APP_MODULE_EXECUTE | CONVERSATION_TAG_ADDED | CONVERSATION_OPENED | CONVERSATION_CLOSED | REQUESTED_AGENT_HANDOVER</td><td>timestamp</td><td>string</td><td>string</td><td>string</td><td>string</td><td>JSON string</td><td>string</td><td>string</td><td>string</td></tr><tr><td><strong>Beschreibung des Event-Typen und des Payloads</strong></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td><p>Dokumentiert den Start eines Anrufs.</p><p>Beinhaltet:</p><ul><li>die Rufnummer inklusive Ländervorwahl</li><li>ob es sich um eine mobile Nummer handelt</li></ul></td><td></td><td>CALL_START</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "callStart": {
    "countryCode": "number",
    "isMobile": "boolean",
    "calledNumber": "string"
  },
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert das Ende eines Anrufs.<br>Beinhaltet auch den Grund und die Art des Anruf-Endes.<br>Falls es sich um einen Transfer handelte, wird das Transferziel angegeben.</td><td></td><td>CALL_END</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "callEnd": {
    "reason": "string",
    "disconnectedBy": "string",
    "transferTarget": "string"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert das Erstellen eines Kontakts und legt dessen ID fest.</td><td></td><td>CONTACT_CREATE</td><td></td><td></td><td></td><td></td><td></td><td>/</td><td></td><td></td><td></td></tr><tr><td>Dokumentiert die Erstellung einer Konversation und deren Sprache.</td><td></td><td>CONVERSATION_CREATE</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "conversationCreate": {
    "language": "string"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert die Erkennung einer Entität und deren ID. Gibt Auskunft, mit welcher Genauigkeit diese getroffen wurde.</td><td></td><td>ENTITY_DETECT</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "entityDetect": {
    "entityId": "string",
    "score": "number"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert die Erkennung einer Intention und deren ID. Gibt Auskunft, mit welcher Genauigkeit diese getroffen wurde.</td><td></td><td>INTENT_DETECT</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "intentDetect": {
    "intentId": "string",
    "score": "number"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td><p>Dokumentiert den Versand einer Nachricht vom Agenten oder Bot.</p><p>Beinhaltet:</p><ul><li>die ID der Nachricht</li><li>die Länge der Nachricht</li><li>die Größe (falls Datei)</li><li>die ID des Agenten (falls null, dann ist die Nachricht vom Bot)</li><li>den Typ der Nachricht</li></ul></td><td></td><td>MESSAGE_SEND</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "messageSend": {
    "messageId": "string",
    "type": "string",
    "operatorId": "string",
    "length": "number",
    "size": "number"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td><p>Dokumentiert den Empfang einer Nachricht vom User.</p><p>Beinhaltet:</p><ul><li>die ID der Nachricht</li><li>die Länge der Nachricht</li><li>die Größe (falls Datei)</li><li>den Typ der Nachricht</li></ul></td><td></td><td>MESSAGE_RECEIVE</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "messageReceive": {
    "messageId": "string",
    "type": "string",
    "length": "number",
    "size": "number"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert den Status einer Nachricht:<br>0 = SENT<br>1 = READ<br>2 = DELIVERED<br>3 = FAILED<br>-1 = UNRECOGNIZED</td><td></td><td>MESSAGE_STATUS_UPDATE</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "messageStatusUpdate": {
    "messageId": "string",
    "status": "string"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert das Erstellen einer Organisation und deren ID.</td><td></td><td>ORGANIZATION_CREATE</td><td></td><td></td><td></td><td></td><td></td><td><pre><code> {
  "organizationCreate": {
    "organizationId": "string"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert den Transfer eines Anrufs und das Transferziel.</td><td></td><td>CALL_TRANSFER</td><td></td><td></td><td></td><td></td><td></td><td><pre><code> {
  "callTransfer": {
    "target": "string"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>/</td><td></td><td>INTERACTION</td><td></td><td></td><td></td><td></td><td></td><td>/</td><td></td><td></td><td></td></tr><tr><td><p>Dokumentiert die Ausführung von Schritten im Bot.</p><p>Beinhaltet:</p><ul><li>die ID des Flows</li><li>die ID des Schrittes</li><li>den Typ des Schrittes</li></ul></td><td></td><td>STEP_EXECUTE</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "stepExecute": {
    "flowId": "string",
    "stepId": "string",
    "type": "string"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td><p>Dokumentiert die Ausführung eines Bedingungs-Schrittes.</p><p>Beinhaltet:</p><ul><li>die ID des Flows</li><li>die ID des Schrittes</li><li>das Resultat der Bedingung, wobei “t” für wahr und “f” für falsch steht</li></ul></td><td></td><td>STEP_CONDITION_EXECUTE</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "stepConditionExecute": {
    "flowId": "string",
    "stepId": "string",
    "result": "string"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td><p>Dokumentiert die Ausführung eines A/B-Split-Schrittes.</p><p>Beinhaltet:</p><ul><li>die ID des Flows</li><li>die ID des Schrittes</li><li>das Resultat des Splits, welches entweder “a” oder “b” ist</li></ul></td><td></td><td>STEP_SPLIT_EXECUTE</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "stepSplitExecute": {
    "flowId": "string",
    "stepId": "string",
    "result": "string"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td><p>Dokumentiert die Ausführung eines Kontext-Schrittes.</p><p>Beinhaltet:</p><ul><li>die ID des Flows</li><li>die ID des Schrittes</li><li>den verwendeten Ausstieg</li><li>die ID der wahrscheinlichsten Intention</li></ul></td><td></td><td>STEP_CONTEXT_EXECUTE</td><td></td><td></td><td></td><td></td><td></td><td><pre><code> {
  "stepContextExecute": {
    "flowId": "string",
    "stepId": "string",
    "outlet": "string",
    "topIntent": "string"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td><p>Dokumentiert die Ausführung eines App-Modul-Schrittes.</p><p>Beinhaltet:</p><ul><li>die ID des Flows</li><li>die ID des Schritts</li><li>die ID der App</li><li>die ID des App-Moduls</li><li>den Status-Code</li><li>die Dauer bis zur Antwort</li><li>ob die Ausführung erfolgreich war</li></ul></td><td></td><td>STEP_APP_MODULE_EXECUTE</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "stepAppModuleExecute": {
    "flowId": "string",
    "stepId": "string",
    "appId": "string",
    "moduleId": "string",
    "statusCode": "number",
    "responseTime": "number",
    "responseOk": "boolean"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert das Hinzufügen eines “Tags” zur Konversation und die ID des “Tags”.</td><td></td><td>CONVERSATION_TAG_ADDED</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
  "conversationTagAdded": {
    "tagId": "string"
  }
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert das (erneute) Eröffnen einer Konversation.<br>Gibt an, ob diese von einem Bot (null) oder einem Agenten (ID des Agenten)(wieder-)eröffnet wurde.</td><td></td><td>CONVERSATION_OPENED</td><td></td><td></td><td></td><td></td><td></td><td><p></p><pre><code>{
"conversationOpened": {
"openedBy": "string",
"operatorId": "string"
}
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert das Abschließen einer Konversation.<br>Gibt an, ob diese von einem Bot (null) oder einem Agenten (ID des Agenten) abgeschlossen wurde.</td><td></td><td>CONVERSATION_CLOSED</td><td></td><td></td><td></td><td></td><td></td><td><pre><code>{
"conversationClosed": {
"closedBy": "string",
"operatorId": "string"
}
}
</code></pre></td><td></td><td></td><td></td></tr><tr><td>Dokumentiert die Ausführung des »Übergabe an Agenten«-Elements.</td><td></td><td>REQUESTED_AGENT_HANDOVER</td><td></td><td></td><td></td><td></td><td></td><td><p></p><pre><code>{
}
</code></pre></td><td></td><td></td><td></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chatcaptain.com/bot-verwalten/statistiken/export/datenmodell.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.