# 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:55:36.457Z

## Página

- Título: Ajustar Número no fluxo de voz
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-de-voz/ajustar-numero
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Padronize um telefone e disponibilize número, DDD e código do país para os próximos nodes.

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

# Ajustar Número no fluxo de voz

O node **Ajustar Número** limpa e padroniza um telefone usando o país e, quando necessário, um DDD padrão. O resultado fica disponível em variáveis para comparações, integrações e cadastros.

## Quando usar

- padronizar o número de origem antes de consultar uma integração;
- completar telefones locais com DDD e código do país;
- separar DDD e país para decisões posteriores.

## 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 **Ajustar Número** no grupo **Dados e integrações**, arraste o item para o canvas e abra sua configuração.

## Visão da configuração

![Configuração do node Ajustar Número no fluxo de voz](/docs/screenshots/config-fluxo-voz-node-ajustar-numero.png)

## Campos de configuração

| Campo | Como usar |
| --- | --- |
| Origem do número | Use o telefone da chamada ou uma variável do fluxo. |
| Variável de origem | Quando a origem for variável, informe seu nome ou caminho. |
| País | Selecione o país usado como referência para a normalização. |
| DDD padrão | Opcional. Completa números locais quando a informação estiver ausente. |
| Variável do número | Nome usado para salvar o telefone normalizado. O padrão é `PHONE_NORMALIZED`. |
| Variável do DDD | Opcional. Guarda o código de área identificado. |
| Variável do país | Opcional. Guarda o código do país identificado. |

## Entradas e saídas

| Conexão | Comportamento |
| --- | --- |
| Número ajustado | Usada quando o telefone pôde ser normalizado. |
| Não foi possível ajustar | Usada quando o valor está vazio ou não forma um telefone válido para a configuração. |

## Exemplo prático

1. Escolha o telefone da chamada, país Brasil e o DDD da operação.
2. Mantenha `PHONE_NORMALIZED` como variável do resultado.
3. Use a saída de sucesso em uma consulta de cliente e a saída de falha em uma coleta manual.

## Boas práticas e cuidados

- Escolha o país correto para não completar o telefone com códigos indevidos.
- Use DDD padrão somente quando a operação realmente recebe números locais incompletos.
- O valor salvo é composto por dígitos, adequado para APIs e comparações.

## Como testar

1. Teste números com e sem código do país.
2. Teste um número local que dependa do DDD padrão.
3. Informe um valor inválido e confirme a saída de falha.

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)