# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-09-04T17:56:22.138Z

## Página

- Título: Limitador de Tentativas no fluxo de voz
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-de-voz/limitador-de-tentativas
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Controle repetições no fluxo e encaminhe a chamada ao atingir o limite definido.

## Seções

- Quando usar
- Onde configurar
- Visão da configuração
- Campos de configuração
- Entradas e saídas
- Exemplo prático
- Boas práticas e cuidados
- Como testar

## Conteúdo da página

# Limitador de Tentativas no fluxo de voz

O node **Limitador de Tentativas** conta quantas vezes a chamada passa por ele. Enquanto o limite não é ultrapassado, a jornada segue pela saída padrão; na passagem seguinte ao número permitido, segue pela saída de máximo de tentativas.

## Quando usar

- limitar repetições depois de uma resposta inválida;
- evitar ciclos sem fim em menus e coletas de dados;
- direcionar o cliente para ajuda humana após várias tentativas.

## Onde configurar

Acesse :ScreenEntry{href="https://my.agilize.app/voice/flow" label="Fluxos Avançados na plataforma"}. Pela interface, abra o módulo **Voz**, selecione **Configurações** e, na árvore **Telefonia e Voz**, escolha **Fluxos Avançados**.

Abra ou crie um fluxo. No editor, localize **Limitador de Tentativas** no grupo **Controle do fluxo**, arraste o item para o canvas e abra sua configuração.

## Visão da configuração

![Configuração do node Limitador de Tentativas no fluxo de voz](/docs/screenshots/config-fluxo-voz-node-limitador-de-tentativas.png)

## Campos de configuração

| Campo | Como usar |
| --- | --- |
| Máx. Tentativas de retry | Defina de 1 a 50 passagens permitidas antes da rota de limite. |

## Entradas e saídas

| Conexão | Comportamento |
| --- | --- |
| Fluxo padrão | Usada enquanto a quantidade de passagens estiver dentro do limite. |
| Máx. tentativas | Usada na passagem que ultrapassa o limite configurado. |

## Exemplo prático

1. Conecte a saída inválida de uma coleta ao **Limitador de Tentativas**.
2. Defina `2` tentativas.
3. Conecte **Fluxo padrão** de volta à pergunta e **Máx. tentativas** a uma fila ou mensagem alternativa.

## Boas práticas e cuidados

- Com limite `2`, as duas primeiras passagens seguem pelo fluxo padrão; a terceira segue por máximo de tentativas.
- Use o node no ponto de retorno do ciclo para que cada repetição seja contada.
- Sempre conecte a saída de limite a um caminho que não retorne ao mesmo ciclo.

## Como testar

1. Repita o caminho até o limite e confirme a saída usada em cada passagem.
2. Faça uma resposta válida antes do limite e confirme que o fluxo continua normalmente.
3. Valide que a rota final não cria um novo ciclo.

Faça os testes em uma chamada controlada antes de vincular ou publicar o fluxo em um número de produção.

## Guias relacionados

- [Nodes de fluxos de voz](/docs/configuracao/referencias/nodes-fluxos-de-voz)
- [Telefonia](/docs/configuracao/telefonia)
- [Vínculo do fluxo de telefonia no número de entrada](/docs/configuracao/telefonia/vinculo-fluxo-telefonia-numero-entrada)