> 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/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/conversation-insights-beta.md).

# Insights da conversa \[Beta]

Nossos novos recursos para ajudar você a entender o que os usuários realmente querem dizer.

<figure><img src="https://181262846-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&amp;token=43049741-c2a4-423c-acbb-88730fe9127f" alt="" width="563"><figcaption></figcaption></figure>

## O que são Insights de conversa

**Insights de conversa** ajudam você a entender como as pessoas realmente interagem com o seu bot. Elas mostram mensagens reais dos usuários, para que você receba intents sugeridas e novas intents.

Pense em **Insights de conversa** como pistas que ajudam você a ajustar seu bot sem adivinhar.

{% hint style="warning" %}
**Insights de conversa** estão disponíveis após 5 mil de [**Não entendido**](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state.md#default-blocks) blocos terem sido acionados nas conversas entre seus clientes e o seu bot. Assim que os insights estiverem disponíveis para um idioma, você receberá uma notificação por e-mail e um banner na plataforma.
{% endhint %}

{% hint style="info" %}
Por enquanto, **Insights de conversa** estão disponíveis apenas em beta fechado. Se quiser testá-lo, por favor [entre em contato conosco](#questions-feedback).
{% endhint %}

## Como habilitar os Insights de conversa

{% stepper %}
{% step %}

### Acesse as configurações do bot.

Em sua **Configurações** guia.
{% endstep %}

{% step %}

### Ative os Insights de conversa.

Nas configurações de IA generativa.

<figure><img src="https://181262846-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&amp;token=c9cdfffe-f92c-4415-b32a-c14d497a8b6f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Clique em Salvar.

No canto superior direito do modal.
{% endstep %}
{% endstepper %}

## Como revisar seus insights

{% hint style="danger" %}
Para garantir que você mantenha o controle do seu bot, use sempre os Insights de conversa na versão [RASCUNHO](/chatlayer-documentation-pt-br/publicar/publishing-your-bot.md#understanding-the-draft-version) do seu bot. As alterações feitas após revisar os insights ficarão visíveis para os seus usuários assim que o bot estiver [publicou](/chatlayer-documentation-pt-br/publicar/publishing-your-bot.md).
{% endhint %}

{% stepper %}
{% step %}

### Acesse a aba de Insights de conversa.

Na **PLN** aba, vá para **Insights de conversa**. Se seus insights estiverem prontos, você verá uma lista do que os usuários disseram para o idioma correspondente.\
\
Se o seu bot for multilíngue, você pode verificar o idioma dos insights no menu suspenso no canto superior direito.

<figure><img src="https://181262846-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&amp;token=8b914dd5-53cb-4ee7-a29b-0c5a7c98586f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Clique em um insight.

Um painel será aberto à sua direita.

<figure><img src="https://181262846-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&amp;token=91db541c-d127-4db3-86e8-a98ead251fc9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Verifique a intenção sugerida.

Há 2 possibilidades aqui. Ou a intenção sugerida é:

* Uma intenção que já está no seu modelo de NLP. Nesse caso, não há nenhuma etiqueta ao lado da intenção.

<figure><img src="https://181262846-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&amp;token=593195b0-5d3e-4e01-bd57-e1119b7beb7d" alt="" width="375"><figcaption></figcaption></figure>

* Uma nova intenção que ainda não faz parte do seu NLP. Nesse caso, ela será rotulada em verde como 'nova intenção'.

<figure><img src="https://181262846-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&amp;token=f463be92-1d87-4f8a-a2ec-6945f4df390c" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Revise as expressões.

Tome seu tempo para rolar para baixo e ler cada expressão apresentada a você.

Certifique-se de desmarcar as expressões que não atendem às suas necessidades.

<figure><img src="https://181262846-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&amp;token=42a2288d-db1f-4133-bc5a-d417cf6fa7e7" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Decida em qual intenção colocar as expressões selecionadas.

Seu grupo de expressões agora pode ser adicionado à intenção de sua escolha. Há 2 possibilidades aqui. Ou:

* Você seleciona uma intenção que já faz parte do seu NLP.
* Você digita um novo nome de intenção no campo.

<figure><img src="https://181262846-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&amp;token=8c1d8639-3186-45f8-a620-92e23232df7a" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Clique em + Adicionar à intenção

Ao fazer isso, você está adicionando o que está acima ao seu modelo de NLP e salvando suas alterações.

Depois disso, a linha do insight que você acabou de revisar desaparecerá.
{% endstep %}

{% step %}

### Treine seu NLP

Quando terminar de revisar seus insights, não se esqueça de [treinar seu NLP](/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/train-your-nlp.md) para garantir que o seu NLP leve suas alterações em consideração.
{% endstep %}

{% step %}

### Publique seu bot

Quando quiser que seus usuários finais se beneficiem das suas alterações, não se esqueça de [publicar seu bot](/chatlayer-documentation-pt-br/publicar/publishing-your-bot.md).

Um novo lote de insights chegará para você assim que o limite de 5 mil de Não entendido for atingido novamente!
{% endstep %}
{% endstepper %}

## Dúvidas, feedback?

* 💌 [Enviar feedback](/chatlayer-documentation-pt-br/send-feedback.md).
* 📞 [Agendar uma chamada de 45 min](https://outlook.office.com/book/ConversationinsightsBeta@clxgroup.onmicrosoft.com/?ismsaljsauthenabled) conosco.

Boa criação de bots!


---

# 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/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/conversation-insights-beta.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.
