Principal Notas de atualização Como configurar um contador no Fluxo Controlado para evitar loops infinitos

Como configurar um contador no Fluxo Controlado para evitar loops infinitos

Última atualização em Jun 24, 2026

Quando usar

  • Você criou um Fluxo Controlado em que o usuário precisa fornecer um dado específico (e-mail, número, CPF) e o fluxo pode ficar pedindo de novo sem fim
  • Você quer limitar tentativas antes de escalar para humano
  • Você precisa quebrar bucles infinitos em validações

Pré-requisitos


Sobre este artigo

Um contador é um mecanismo de controle que evita que o Fluxo Controlado fique preso em um ciclo infinito ao solicitar a mesma informação ao usuário várias vezes seguidas. Este artigo mostra por que um contador é necessário, como configurá-lo e a lógica por trás dele.


Por que um contador é necessário?

Vamos analisar um exemplo:

Imagine que o Fluxo Controlado precisa do e-mail do usuário para verificar se ele é cliente na sua base interna.

  1. O Fluxo Controlado pede o e-mail

  2. O usuário fornece um e-mail inválido

  3. O Fluxo Controlado pergunta de novo

  4. Usuário fornece outro e-mail inválido

  5. Isso continua indefinidamente

Sem um contador, o Fluxo Controlado continua perguntando para sempre — criando um loop infinito.

Um contador previne essa situação.


Como configurar um contador no fluxo

Descrição do fluxo de exemplo

A IA solicita ao usuário que insira um número entre 1 e 10:

  • Se o usuário fornece um número válido → o fluxo continua normalmente

  • Se o usuário fornece um número fora desse intervalo → a mesma pergunta é repetida

Sem um limite, essa situação também pode gerar um ciclo infinito.

Vamos corrigir isso.

Estrutura correta com contador


Lógica por trás dos contadores

Um contador é simplesmente uma variável que começa com o valor 0.

A cada vez que o usuário envia uma resposta que:

  • Não cumpre os requisitos

  • Não pode ser encontrada na base de dados

  • Ou por qualquer outro motivo que você considere inválido

Você soma +1 ao contador e refaz a pergunta.

Na seção "Número inválido" do fluxo, há um filtro que verifica o valor do contador (que representa quantas vezes a pergunta foi feita).

Se o contador ultrapassa o limite definido (por exemplo, 3 tentativas), o bot para de repetir a pergunta e direciona a conversa para uma resposta humana ou outra ação de fallback.

Isso evita ciclos infinitos e garante uma melhor experiência para o usuário.


Observações