> 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.

***

## 🧭 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FIWk4lGlCoNSSvVXJAqpd%2Fimage.png?alt=media&amp;token=8703ab36-f778-4278-926b-803915a1c469" alt=""><figcaption><p>Imagem 1 - Painel de módulos com a categoria Gatilho expandida e o módulo Intenção visível no Hyperflow Integrações.</p></figcaption></figure>

{% 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F07880GsjL01EWsESCiLb%2Fimage.png?alt=media&amp;token=ad0df71d-3122-4813-b0c5-be71533d0cce" alt=""><figcaption><p>Imagem 2 - Painel de configuração do módulo Intenção aberto.</p></figcaption></figure>

***

### 🎯 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 %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FLhj3bMS9ATRX2MKCSR5t%2Fimage.png?alt=media&amp;token=51f0372c-ae8f-4d04-bb4e-bff5a8a5fb04" alt=""><figcaption><p>Imagem 3 - Campo Intenção selecionado, com a lista de frases de exemplo exibida abaixo</p></figcaption></figure>

***

### 🔀 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FG6rmaxXUtmc9BwohDNC2%2Fimage.png?alt=media&amp;token=37bcd24c-f642-43dc-b3c7-4c4c5d66f6db" alt=""><figcaption><p>Imagem 4 - Módulo na área de trabalho do fluxo com a saída conectada ao próximo módulo</p></figcaption></figure>

***

## 💡 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.