# 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:28.841Z

## Página

- Título: Destino por Valor de Variável no fluxo de voz
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-de-voz/destino-por-valor-de-variavel
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Escolha a próxima rota conforme o conteúdo de uma variável da chamada.

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

# Destino por Valor de Variável no fluxo de voz

O node **Destino por Valor de Variável** compara uma variável com regras configuradas e segue pela primeira saída correspondente. Se nenhuma regra passar, usa **Fluxo Padrão**.

## Quando usar

- separar chamadas por DDD, código, status ou categoria;
- decidir o caminho com base em uma resposta coletada ou integração;
- tratar vários valores sem duplicar condicionais.

## 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 **Destino por Valor de Variável** no grupo **Condições**, arraste o item para o canvas e abra sua configuração.

## Visão da configuração

![Configuração do node Destino por Valor de Variável no fluxo de voz](/docs/screenshots/config-fluxo-voz-node-destino-por-valor-de-variavel.png)

## Campos de configuração

| Campo | Como usar |
| --- | --- |
| Variável | Informe o nome ou caminho da variável. Em branco, usa o número de origem da chamada. |
| Tipo de comparação | Escolha Valor Exato, Contém, Inicia com ou Termina com. |
| Ignorar maiúsculas/minúsculas | Quando ativo, diferenças entre letras maiúsculas e minúsculas não alteram o resultado. |
| Saídas | Adicione os valores esperados na ordem em que devem ser avaliados. |

## Entradas e saídas

| Conexão | Comportamento |
| --- | --- |
| Fluxo Padrão | Usada quando a variável está vazia ou nenhuma regra corresponde. |
| Saídas adicionadas | A primeira regra correspondente define o caminho. |

## Exemplo prático

1. Use **Ajustar Número** para salvar o telefone em `PHONE_NORMALIZED`.
2. Avalie essa variável com **Inicia com** para separar códigos de país ou região.
3. Conecte cada saída à equipe correta e mantenha uma fila geral no fluxo padrão.

## Boas práticas e cuidados

- A ordem importa quando duas regras podem corresponder ao mesmo valor.
- Use comparação exata para identificadores e códigos fechados.
- Sempre conecte **Fluxo Padrão** para tratar valores inesperados.

## Como testar

1. Teste um valor para cada saída configurada.
2. Teste um valor que corresponda a mais de uma regra e confirme a prioridade.
3. Teste variável vazia e valor desconhecido.

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)