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 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
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
- Escolha o telefone da chamada, país Brasil e o DDD da operação.
- Mantenha
PHONE_NORMALIZEDcomo variável do resultado. - 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
- Teste números com e sem código do país.
- Teste um número local que dependa do DDD padrão.
- 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.