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

# Telefonía

> Configuración de los números de teléfono: columnas del archivo, normalización y validaciones.

El tab **Telefonía** de **Entrada de Campaña** concentra todo lo relacionado con cómo el bot lee, limpia y valida los números de tu archivo antes de discar.

***

## Configuración de teléfonos

Antes de agregar columnas, configurá los dos selectores globales. Definen cómo se interpreta el código de área y el tipo de teléfono para **todas** las columnas que agregues.

<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="Opciones de código de área y tipo de teléfono" width="855" height="825" data-path="images/parser/tel-config-telefonos/01-opciones-area.png" />

### Código de área

Define si el código de área ya está incluido en el número o viene en una columna separada del archivo.

| Opción                                | Cuándo usarla                                                                                              | Habilita col. «Código de área» |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------ |
| Ya incluido en el número              | El número completo ya viene en una sola columna. La opción más común.                                      | —                              |
| Agregar 11 al inicio                  | Los números no tienen código de área y el bot opera en Buenos Aires. El sistema agrega 11 automáticamente. | —                              |
| En una columna separada               | El código de área viene en una columna distinta del número.                                                | ✓                              |
| Columna separada (o 11 si está vacía) | Igual que el anterior, pero cuando la celda del código de área está vacía usa 11 como valor por defecto.   | ✓                              |

<Warning>
  Las opciones "Agregar 11" son un atajo para Buenos Aires (prefijo 11). Para campañas con contactos de otras provincias, usá **En una columna separada** y mapeá la columna correspondiente en la tabla.
</Warning>

### Modo para el tipo de teléfono

Clasifica los números como móviles o fijos. En Argentina, los celulares requieren que el sistema inserte un `9` entre el código de país y el área.

| Opción                   | Comportamiento                                                                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Detectar automáticamente | El sistema infiere si cada número es móvil o fijo analizando su formato.                                                                   |
| Definir un tipo fijo     | Vos indicás manualmente el tipo de teléfono para cada columna de la tabla.                                                                 |
| En una columna separada  | Tu archivo tiene una columna que indica si cada teléfono es móvil o fijo. Habilita el campo **Tipo** en cada fila de la tabla de columnas. |

**Cuando elegís "Definir un tipo fijo"**, aparece un selector en cada fila de la tabla:

| Valor                                | Descripción                                                                    |
| ------------------------------------ | ------------------------------------------------------------------------------ |
| Teléfono móvil                       | Todos los números de esa columna se tratan como celulares                      |
| Teléfono fijo                        | Todos se tratan como líneas fijas                                              |
| Generar dos teléfonos. Móvil primero | Por cada número se generan dos intentos: primero como celular, luego como fijo |
| Generar dos teléfonos. Fijo primero  | Igual, pero fijo primero                                                       |
| Deducir prefijo basado en 15         | El sistema detecta celulares por la presencia del 15 en el número              |

**Cuando elegís "En una columna separada"**, aparece el campo **Valor que identifica al móvil**: ingresá el texto exacto que tu archivo usa para celulares (ej: `CEL`, `móvil`, `M`). Todo valor diferente se trata como fijo.

<Note>
  El campo **Tipo** que aparece en cada fila de la tabla tiene que coincidir exactamente con el nombre de la columna de tu archivo que indica si el número es móvil o fijo (ej: `tipo_tel`, `modalidad`). Se usa el mismo nombre para todas las filas.
</Note>

<Warning>
  **Argentina**: los celulares requieren el dígito 9 entre el código de país y el código de área (ej: 54**9**11...). El sistema agrega ese 9 automáticamente cuando identifica un número como móvil. Si todos tus contactos tienen celular, elegí **Definir un tipo fijo → Teléfono móvil** para asegurarte.
</Warning>

### Columnas con números de teléfono

Agregá una fila por cada columna del archivo que contenga teléfonos. El bot las procesa en el orden de la tabla.

<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="Tabla de columnas de teléfono" width="855" height="825" data-path="images/parser/tel-config-telefonos/02-columnas-telefonos.png" />

<Note>
  El campo **Nombre de la columna de teléfono** tiene que coincidir exactamente con el encabezado de tu archivo. Si tu archivo tiene 5 columnas de teléfono (ej: Tel\_1, Tel\_2... Tel\_5), agregá 5 filas.
</Note>

***

## Normalización del número

Las tres reglas limpian el número antes de discarlo. **Se aplican en orden**: cada una actúa sobre el resultado de la 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="Reglas de normalización de números" width="855" height="825" data-path="images/parser/tel-normalizacion/01-normalizacion.png" />

| Regla                         | Qué hace                                                         | Ejemplo                   |
| ----------------------------- | ---------------------------------------------------------------- | ------------------------- |
| **Quitar el 0 inicial**       | Elimina el 0 al inicio del código de área                        | `099123456` → `99123456`  |
| **Quitar el 15 de celulares** | Elimina el 15 después del código de área en celulares argentinos | `1599123456` → `99123456` |
| **Agregar código de país**    | Antepone el código internacional al número                       | `99123456` → `5499123456` |

<Note>
  Para Argentina, activá las tres reglas y configurá `54` como código de país. Para bots fuera de Argentina: desactivá "Quitar el 0" y "Quitar el 15", y usá el código correspondiente (ej: `55` para Brasil).
</Note>

***

## Validaciones del teléfono

Reglas para filtrar números inválidos o no deseados antes de enviarlos al 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="Validaciones del teléfono" width="855" height="825" data-path="images/parser/tel-validaciones/01-validaciones.png" />

### Cantidad de dígitos

Define el rango de longitud válida del número **una vez construido** (con normalización ya aplicada). Los números fuera del rango se descartan silenciosamente.

<Note>
  **Argentina**: un celular completo con código de país tiene entre 12 y 13 dígitos (ej: `5491112345678`). Los fijos tienen entre 10 y 11.
</Note>

### Validación de encabezados *(opcional)*

Verificá que el número comience con los prefijos esperados. Cuando un número no cumple, elegís qué hacer:

| Acción                              | Cuándo usarla                                                                                     |
| ----------------------------------- | ------------------------------------------------------------------------------------------------- |
| **Agregar número**                  | El prefijo falta pero el número es recuperable. El sistema lo antepone automáticamente.           |
| **Ignorar número**                  | Descartarlo silenciosamente. El caso sigue existiendo con los otros teléfonos que tenga.          |
| **Interrumpir creación de campaña** | Números inválidos indican un error en el archivo. Bloqueá la creación hasta resolver el problema. |

### Filtrar teléfonos *(opcional)*

Lista de números específicos que se excluyen del procesamiento. Útil para teléfonos de prueba, internos o sensibles que pueden aparecer en el archivo del cliente.
