> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/transformacao-de-dados/formatar-telefone.md).

# 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.<br>
* **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.<br>
* **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.<br>

### 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.<br>
* **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.<br>

### 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 (`+`).<br>
* **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*.<br>

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/transformacao-de-dados/formatar-telefone.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.