> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/gatilho/intencao.md).

# Intenção

O módulo **Intenção** direciona a conversa para este ponto do fluxo sempre que a mensagem do cliente for reconhecida, pela inteligência artificial de compreensão de linguagem, como correspondente a uma intenção já cadastrada — por exemplo, identificar que o cliente quer "cancelar um pedido", mesmo que ele escreva isso de formas diferentes.

**📷 Inserir print:** visão geral do módulo Intenção na área de trabalho do fluxo

***

## 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Gatilho** (identificada pela cor roxa).
5. Arraste o módulo **Intenção** para a área de trabalho do fluxo.

**📷 Inserir print:** painel de módulos com a categoria Gatilho expandida e o módulo Intenção visível

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter a Inteligência Artificial de compreensão de linguagem conectada ao seu aplicativo, e já existir uma **Intenção** cadastrada na tela de **NLP**, com frases de exemplo que representem como o cliente costuma se expressar.
{% endhint %}

***

## 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

**📷 Inserir print:** painel de configuração do módulo Intenção aberto

***

### 🎯 Intenção

No campo **Intenção**, selecione, entre as já cadastradas na tela de NLP, qual intenção deve disparar este ponto do fluxo. Ao selecionar, o painel mostra as frases de exemplo cadastradas para essa intenção, como referência.

{% hint style="warning" %}
Evite usar a mesma intenção em módulos **Intenção** de fluxos diferentes. Quando isso acontece, apenas o fluxo publicado mais recentemente com aquela intenção fica ativo — o outro deixa de funcionar para essa intenção, sem nenhum aviso.
{% endhint %}

**📷 Inserir print:** campo Intenção selecionado, com a lista de frases de exemplo exibida abaixo

***

### 🔀 Saída do módulo

O módulo tem uma única saída, ativada quando a intenção é reconhecida na mensagem do cliente. Os dados extraídos da mensagem (quando a intenção tiver informações associadas) ficam disponíveis como variáveis para os próximos módulos.

**📷 Inserir print:** módulo na área de trabalho do fluxo com a saída conectada ao próximo módulo

***

## 💡 Caso de uso

**Cenário:** uma empresa quer que, em qualquer ponto da conversa, se o cliente demonstrar intenção de cancelar um pedido, o fluxo seja direcionado automaticamente para o atendimento de cancelamento.

**Configuração:**

1. Na tela de **NLP**, cadastre a intenção "Cancelar Pedido", com frases de exemplo como "quero cancelar meu pedido", "como cancelo a compra", "não quero mais o produto".
2. No fluxo principal, adicione o módulo **Intenção** e selecione "Cancelar Pedido".
3. Conecte a saída do módulo ao fluxo de atendimento de cancelamento.
4. Publique o fluxo.

**Resultado:** sempre que um cliente escrever algo reconhecido como intenção de cancelamento, mesmo com palavras diferentes das cadastradas, o fluxo é direcionado automaticamente para o atendimento correto.

***

## 📌 Dicas úteis

* Cadastre várias frases de exemplo diferentes para cada intenção, representando as várias formas como um cliente pode expressar a mesma ideia — isso melhora o reconhecimento.
* É necessário **publicar o fluxo** pelo menos uma vez com o módulo Intenção configurado para que a intenção seja efetivamente treinada. Depois disso, edições nas frases de exemplo (feitas na tela de NLP) são aplicadas automaticamente, sem precisar publicar de novo.
* Use uma intenção específica por módulo, evitando reaproveitar a mesma intenção em mais de um fluxo.
* A mensagem do cliente só aciona o módulo se a confiança do reconhecimento estiver acima do limite configurado nas configurações de NLP do aplicativo.

***

## 📝 Resumo

* O módulo **Intenção** direciona o fluxo automaticamente quando a mensagem do cliente corresponde a uma intenção cadastrada na Inteligência Artificial.
* É necessário ter a IA de compreensão de linguagem conectada e a intenção já cadastrada na tela de NLP.
* O único campo de configuração é a **Intenção** selecionada.
* Evite reaproveitar a mesma intenção em módulos de fluxos diferentes — apenas o publicado mais recentemente permanece ativo.