# Conversation insights \[Beta]

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FRTXAXwafkaAFRMiPXQEO%2FScreenshot%202026-01-13%20at%2016.44.54.png?alt=media&#x26;token=43049741-c2a4-423c-acbb-88730fe9127f" alt="" width="563"><figcaption></figcaption></figure>

## What are Conversation insights

**Conversation insights** help you understand how people actually interact with your bot. They show real messages from users, so that you get suggested intents and new intents.&#x20;

Think of **Conversation insights** as clues that help you fine-tune your bot without guessing.

{% hint style="warning" %}
**Conversation insights** are available after 5K of [**Not understood**](https://docs.chatlayer.ai/buildabot/flow-logic/dialog-state#default-blocks) blocks were triggered in conversations between your customers and your bot. Once insights are available for a language, you'll get notified by an email and a banner on the platform.
{% endhint %}

{% hint style="info" %}
For now, **Conversation insights** are only available as closed Beta. If you'd like to test it, please [contact us](#questions-feedback).
{% endhint %}

## How to enable Conversation insights

{% stepper %}
{% step %}

### Go to Bot settings.

Under your **Settings** tab.
{% endstep %}

{% step %}

### Toggle on Conversation insights.

Under the Generative AI settings.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FrFYeIbotPYPOWtCQqire%2FScreenshot%202026-01-13%20at%2016.03.09.png?alt=media&#x26;token=c9cdfffe-f92c-4415-b32a-c14d497a8b6f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click Save.

On the top-right corner of the modal.
{% endstep %}
{% endstepper %}

## How to review your insights

{% hint style="danger" %}
To make sure to keep control of your bot, always use Conversation insights in the [DRAFT](https://docs.chatlayer.ai/publish/publishing-your-bot#understanding-the-draft-version) version of your bot. The changes you made after reviewing insights will be visible to your users once the bot is [published](https://docs.chatlayer.ai/publish/publishing-your-bot).
{% endhint %}

{% stepper %}
{% step %}

### Go to the Conversation insights tab.

Under the **NLP** tab, go to **Conversation insights**. If your insights are ready, you will see a list of what users said for the corresponding language.\
\
If your bot is multilingual, you can check the insights language from the top-right dropdown.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FMUUqaNhpCWJG0kU4hNnU%2FScreenshot%202025-12-26%20at%2009.41.37.png?alt=media&#x26;token=8b914dd5-53cb-4ee7-a29b-0c5a7c98586f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click on an insight.

A panel will open on your right-hand side.&#x20;

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FmNJVRQbwaLixixdMQvVb%2FScreenshot%202025-12-26%20at%2009.45.43.png?alt=media&#x26;token=91db541c-d127-4db3-86e8-a98ead251fc9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Check the intent that is suggested.

There are 2 possibilities here. Either the suggested intent is:

* An intent that is already in your NLP model. In this case, there is no label next to the intent.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F2IiymGk63ldMQDBrPWBI%2FScreenshot%202025-12-26%20at%2009.44.41.png?alt=media&#x26;token=593195b0-5d3e-4e01-bd57-e1119b7beb7d" alt="" width="375"><figcaption></figcaption></figure>

* An new intent that is not part of your NLP yet. In this case, it will be labelled in green as 'new intent'.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FgRTmy5PkjlkOlk6bEuNC%2FScreenshot%202025-12-26%20at%2009.47.41.png?alt=media&#x26;token=f463be92-1d87-4f8a-a2ec-6945f4df390c" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Review the expressions.

Take your time to scroll down and read through every expression that is presented to you.

Make sure to unselect the expressions that do not see fit to your needs.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2Fdd6DJnAPyJgHW3AGGymu%2FScreenshot%202025-12-26%20at%2009.48.37.png?alt=media&#x26;token=42a2288d-db1f-4133-bc5a-d417cf6fa7e7" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Decide in which intent to place the selected expressions.

Your cluster of expressions can now be added to the intent of your choice. There are 2 possibilities here. Either:

* You select an intent that's already part of your NLP.
* You type a new intent name on the field.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FeF6eF0RQzQKs3DZ6NldE%2FScreenshot%202025-12-26%20at%2009.49.34.png?alt=media&#x26;token=8c1d8639-3186-45f8-a620-92e23232df7a" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click + Add to intent

By doing so, you're adding what's above to your NLP model and saving your changes.

Once this is done, the line of the insight that you just reviewed will disappear.
{% endstep %}

{% step %}

### Train your NLP

Once you're done with your insights review, make sure to [train your NLP](https://docs.chatlayer.ai/nlp/natural-language-processing-nlp/train-your-nlp) to make sure that your NLP takes your changes into account.
{% endstep %}

{% step %}

### Publish your bot

Once you'd like your end-users to benefit from your changes, don't forget to [publish your bot](https://docs.chatlayer.ai/publish/publishing-your-bot).&#x20;

A new batch of insights will come your way once 5K Not understood threshold is reached again!
{% endstep %}
{% endstepper %}

## Questions, feedback?

* 💌 [Send feedback](https://docs.chatlayer.ai/send-feedback).
* 📞 [Book a 45min call](https://outlook.office.com/book/ConversationinsightsBeta@clxgroup.onmicrosoft.com/?ismsaljsauthenabled) with us.

Happy bot building!