> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/navigation/analytics/conversations.md).

# Conversations

The Conversations tab provides insights into the interactions between your bot and the users, allowing you to assess the effectiveness and quality of those conversations.

{% hint style="info" %}
Not familiar with analytics? We recommend that you have a look at our [Analytics concepts](/bot-answers/definitions.md).
{% endhint %}

## Overview

The **Overview** tab is where the overall info on the conversations lies. It consists in:

* The total number of conversations.
* The number of conversations with human handover. A conversation is marked as a human handover when it includes a triggered [Offloading](/navigation/settings/offloading.md) action.
* An average of the number of messages per conversation.
* An average of the [conversation](https://docs.chatlayer.ai/bot-answers/definitions#definition-of-a-conversation) duration. This category represents the most occurring length of a conversation in number of minutes for interactions between your bot and its users

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2Fi2cVDYuRt8vv9K6SIY2f%2FScreenshot%202024-06-04%20at%2011.50.31.png?alt=media&amp;token=03f1b7bb-0215-4d52-bb85-0d2cdf923d35" alt=""><figcaption><p>Conversations Overview tab.</p></figcaption></figure>

{% hint style="success" %}
Monitor the efficiency of your conversations by looking at the average messages and duration per conversation to ensure quick user resolutions. An increase in these metrics indicates users are struggling. Compare with past effective performance, identify changes, and adjust the bot to enhance user experience.
{% endhint %}

## Customer messages

The **Customer messages** tab shows an overview of how many messages are:

* Understood: the user expression is recognized correctly and the corresponding intent was triggered.
* [Button clicks](https://docs.chatlayer.ai/bot-answers/analytics/intents): this shows how often users clicked on a button, carousel, quick reply etc.
* [Not understood](https://docs.chatlayer.ai/bot-answers/analytics/intents): the user expression is not understood, meaning it is below the NLP threshold, so the user saw the Not understood message.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FScxNcgP0Jopb5O9ZmnWH%2FScreenshot%202024-06-04%20at%2011.55.55.png?alt=media&amp;token=c7a3d278-13e9-4814-9ba5-db272de3a562" alt=""><figcaption><p>Customer messages tab.</p></figcaption></figure>

{% hint style="info" %}
Seeing a 'not understood' percentage of > 15%? You should look into which intents are not understood correctly and improve your NLP by using the [Train tab](https://docs.chatlayer.ai/understanding-users/natural-language-processing-nlp/tutorial-train-your-bot-based-on-actual-user-messages). Creating better[ Not understood messages](https://docs.chatlayer.ai/tips-and-best-practices/not-understood-bot-dialog) will also create a better user experience.
{% endhint %}

## Knowledge base AI

The **Knowledge base AI** tab displays analytics on the usage of your [Knowledge base AI flow](/navigation/knowledge-base-ai.md) if you've implemented one in your chatbot.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FUHV67lg2lxR7lbULUIxv%2FScreenshot%202024-03-13%20at%2011.04.36.png?alt=media&amp;token=ee8e2eea-42f7-44c9-a4c2-86f85d7400af" alt=""><figcaption><p>The Knowledge base AI tab in Conversations.</p></figcaption></figure>

{% hint style="info" %}
Chatlayer's AI knowledge base tool allows your bot to generate concise answers after scraping your content. Learn how to set it up [here](https://docs.chatlayer.ai/bot-answers/knowledge-base-ai).
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.chatlayer.ai/navigation/analytics/conversations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
