> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inceptia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Telefonia

> Configuração dos números de telefone: colunas do arquivo, normalização e validações.

A aba **Telefonia** de **Entrada de Campanha** concentra tudo relacionado a como o bot lê, limpa e valida os números do seu arquivo antes de discar.

***

## Configuração de telefones

Antes de adicionar colunas, configure os dois seletores globais. Eles definem como o código de área e o tipo de telefone são interpretados para **todas** as colunas que você adicionar.

<img src="https://mintcdn.com/inceptia/s3peX8NLdE8PxYYV/images/parser/tel-config-telefonos/01-opciones-area.png?fit=max&auto=format&n=s3peX8NLdE8PxYYV&q=85&s=88f35d9b86d400e364e0328219cdb5fd" alt="Opções de código de área e tipo de telefone" width="855" height="825" data-path="images/parser/tel-config-telefonos/01-opciones-area.png" />

### Código de área

Define se o código de área já está incluído no número ou vem em uma coluna separada do arquivo.

| Opção                            | Quando usar                                                                                             | Habilita coluna «Código de área» |
| -------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Já incluído no número            | O número completo já vem em uma única coluna. A opção mais comum.                                       | —                                |
| Adicionar 11 no início           | Os números não têm código de área e o bot opera em Buenos Aires. O sistema adiciona 11 automaticamente. | —                                |
| Em uma coluna separada           | O código de área vem em uma coluna diferente do número.                                                 | ✓                                |
| Coluna separada (ou 11 se vazia) | Igual ao anterior, mas quando a célula do código de área está vazia usa 11 como valor padrão.           | ✓                                |

<Warning>
  As opções "Adicionar 11" são um atalho para Buenos Aires (prefixo 11). Para campanhas com contatos de outras províncias, use **Em uma coluna separada** e mapeie a coluna correspondente na tabela.
</Warning>

### Modo para o tipo de telefone

Classifica os números como móveis ou fixos. Na Argentina, os celulares exigem que o sistema insira um `9` entre o código do país e a área.

| Opção                    | Comportamento                                                                                                                         |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| Detectar automaticamente | O sistema infere se cada número é móvel ou fixo analisando seu formato.                                                               |
| Definir um tipo fixo     | Você indica manualmente o tipo de telefone para cada coluna da tabela.                                                                |
| Em uma coluna separada   | Seu arquivo tem uma coluna que indica se cada telefone é móvel ou fixo. Habilita o campo **Tipo** em cada linha da tabela de colunas. |

**Quando você escolhe "Definir um tipo fixo"**, aparece um seletor em cada linha da tabela:

| Valor                                | Descrição                                                                           |
| ------------------------------------ | ----------------------------------------------------------------------------------- |
| Telefone móvel                       | Todos os números dessa coluna são tratados como celulares                           |
| Telefone fixo                        | Todos são tratados como linhas fixas                                                |
| Gerar dois telefones. Móvel primeiro | Para cada número são gerados dois intentos: primeiro como celular, depois como fixo |
| Gerar dois telefones. Fixo primeiro  | Igual, mas fixo primeiro                                                            |
| Deduzir prefixo baseado no 15        | O sistema detecta celulares pela presença do 15 no número                           |

**Quando você escolhe "Em uma coluna separada"**, aparece o campo **Valor que identifica o celular**: informe o texto exato que seu arquivo usa para celulares (ex: `CEL`, `móvil`, `M`). Qualquer valor diferente é tratado como fixo.

<Note>
  O campo **Tipo** que aparece em cada linha da tabela precisa coincidir exatamente com o nome da coluna do seu arquivo que indica se o número é móvel ou fixo (ex: `tipo_tel`, `modalidad`). O mesmo nome é usado para todas as linhas.
</Note>

<Warning>
  **Argentina**: os celulares exigem o dígito 9 entre o código do país e o código de área (ex: 54**9**11...). O sistema adiciona esse 9 automaticamente quando identifica um número como móvel. Se todos os seus contatos têm celular, escolha **Definir um tipo fixo → Telefone móvel** para garantir.
</Warning>

### Colunas com números de telefone

Adicione uma linha para cada coluna do arquivo que contenha telefones. O bot as processa na ordem da tabela.

<img src="https://mintcdn.com/inceptia/s3peX8NLdE8PxYYV/images/parser/tel-config-telefonos/02-columnas-telefonos.png?fit=max&auto=format&n=s3peX8NLdE8PxYYV&q=85&s=d3584025b2c8eb96c9ee28fbcef671e0" alt="Tabela de colunas de telefone" width="855" height="825" data-path="images/parser/tel-config-telefonos/02-columnas-telefonos.png" />

<Note>
  O campo **Nome da coluna de telefone** precisa coincidir exatamente com o cabeçalho do seu arquivo. Se o seu arquivo tem 5 colunas de telefone (ex: Tel\_1, Tel\_2... Tel\_5), adicione 5 linhas.
</Note>

***

## Normalização do número

As três regras limpam o número antes de discá-lo. **São aplicadas em ordem**: cada uma age sobre o resultado da anterior.

<img src="https://mintcdn.com/inceptia/s3peX8NLdE8PxYYV/images/parser/tel-normalizacion/01-normalizacion.png?fit=max&auto=format&n=s3peX8NLdE8PxYYV&q=85&s=bca44977e318097554b6c45c96573037" alt="Regras de normalização de números" width="855" height="825" data-path="images/parser/tel-normalizacion/01-normalizacion.png" />

| Regra                         | O que faz                                                    | Exemplo                   |
| ----------------------------- | ------------------------------------------------------------ | ------------------------- |
| **Remover o 0 inicial**       | Remove o 0 no início do código de área                       | `099123456` → `99123456`  |
| **Remover o 15 de celulares** | Remove o 15 depois do código de área em celulares argentinos | `1599123456` → `99123456` |
| **Adicionar código do país**  | Antepõe o código internacional ao número                     | `99123456` → `5499123456` |

<Note>
  Para a Argentina, ative as três regras e configure `54` como código do país. Para bots fora da Argentina: desative "Remover o 0" e "Remover o 15", e use o código correspondente (ex: `55` para o Brasil).
</Note>

***

## Validações do telefone

Regras para filtrar números inválidos ou indesejados antes de enviá-los ao bot.

<img src="https://mintcdn.com/inceptia/s3peX8NLdE8PxYYV/images/parser/tel-validaciones/01-validaciones.png?fit=max&auto=format&n=s3peX8NLdE8PxYYV&q=85&s=369693a88b53209a69f25163bd591617" alt="Validações do telefone" width="855" height="825" data-path="images/parser/tel-validaciones/01-validaciones.png" />

### Quantidade de dígitos

Define o intervalo de comprimento válido do número **depois de construído** (com a normalização já aplicada). Números fora do intervalo são descartados silenciosamente.

<Note>
  **Argentina**: um celular completo com código do país tem entre 12 e 13 dígitos (ex: `5491112345678`). Os fixos têm entre 10 e 11.
</Note>

### Validação de cabeçalhos *(opcional)*

Verifica se o número começa com os prefixos esperados. Quando um número não cumpre, você escolhe o que fazer:

| Ação                                | Quando usar                                                                               |
| ----------------------------------- | ----------------------------------------------------------------------------------------- |
| **Adicionar número**                | O prefixo está faltando, mas o número é recuperável. O sistema o antepõe automaticamente. |
| **Ignorar número**                  | Descartá-lo silenciosamente. O caso continua existindo com os outros telefones que tiver. |
| **Interromper criação de campanha** | Números inválidos indicam um erro no arquivo. Bloqueie a criação até resolver o problema. |

### Filtrar telefones *(opcional)*

Lista de números específicos que são excluídos do processamento. Útil para telefones de teste, internos ou sensíveis que possam aparecer no arquivo do cliente.