Formatar Telefone

Visão Geral

O Componente de Formatação de Telefone (identificado no sistema pelo identificador técnico format_phone) é um nó utilitário focado em tratamento e higienização de dados (data sanitization). Sua função principal é capturar strings de números telefônicos brutos ou fragmentados coletados ao longo do fluxo e unificá-los sob as diretrizes de sintaxe e padronização internacional. Ele assegura que o registro do contato seja gravado corretamente no banco de dados, evitando falhas de comunicação em disparos ativos futuros.

Parâmetros de Configuração

A parametrização do bloco gerencia as strings de entrada e o mapeamento da variável de saída no sistema:

• DDI: Campo de entrada de texto destinado a receber o código de Discagem Direta Internacional do país do contato (ex: 55 para o Brasil). Aceita valores estáticos ou tags dinâmicas de variáveis do fluxo.

• Telefone: Campo de entrada que recebe o corpo do número telefônico (incluindo ou não o DDD regional). É o dado bruto que passará pelo processo de limpeza e concatenação.

• Nova Chave: Campo de texto utilizado para definir o nome do contêiner ou variável local (o padrão visual exibido é formatedPhone) que será gerada pela plataforma para armazenar e expor o número completamente tratado e unificado para o restante do fluxo.

Construtor Visual

A interface do construtor adota um modelo enxuto e linear focado na coleta estruturada de inputs:

• Formulário de Inputs Separados: O construtor divide visualmente as propriedades de país (DDI) e linha (Telefone), permitindo ao administrador estruturar regras flexíveis em fluxos que atendem diferentes nacionalidades de leads.

• Indexação Automatizada de Saída: O campo Nova Chave vem pré-preenchido de forma nativa para agilizar o design do fluxo. No editor de automações, o bloco conta com conectores tradicionais de entrada e saída, processando a string e liberando o contato para a próxima etapa em micromilissegundos.

Operadores Especiais

As propriedades lógicas deste componente gerenciam rotinas de concatenação, remoção de caracteres especiais e injeção de payloads:

• Higienização Avançada de Strings (Data Cleaning): O motor interno do componente aplica expressões regulares nativas para remover de forma automática quaisquer caracteres não numéricos informados nos campos de entrada, eliminando espaços vazios, parênteses, pontos, hifens ou símbolos de adição (+).

• Concatenação de Escopo e Interpolação: Os campos DDI e Telefone aceitam a inserção de dados dinâmicos em formato de chaves duplas {{...}}. No momento da execução, o motor resolve as variáveis (ex: buscando {{ddi_capturado}} e {{resposta_telefone}}), une os blocos numéricos de forma linear e injeta a string final limpa na variável informada em Nova Chave.

Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de aplicação deste componente para padronizar dados telefônicos na plataforma:

DDI Informado	Telefone Informado (Bruto)	Nova Chave Configurada	String Retornada na Variável	Caso de Uso Prático
55	(61) 99999-9999	formatedPhone	5561999999999	O usuário digitou o telefone com parênteses e hifens no Webchat. O componente limpa os símbolos e gera o número pronto para canais oficiais.
{{contato.ddi}}	61992222222	telefoneValido	5561992222222	Reaproveitar o DDI do perfil do contato e concatenar com o número bruto digitado em uma etapa de triagem do Facebook Messenger.
55	{{$data.input_fixo}}	whatsappDestino	5511988887777	Capturar um número vindo de um formulário externo via API, reformatá-lo integralmente e utilizá-lo como parâmetro no bloco de envio de HSM.