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

# Campañas

> Seguir el avance de una campaña, entender sus métricas y actuar sobre ella

Una **campaña** es un envío: un archivo de casos que el bot va a gestionar dentro de un horario y con una configuración determinada. Esta pantalla es donde se sigue ese envío mientras ocurre.

## Dónde se ven

Hay dos caminos para llegar a una campaña, según lo que necesites:

* **Monitoreo de campañas** muestra en una sola tabla las campañas de todos tus bots. Es la vista que conviene cuando querés saber cómo viene el día.
* **Bots → un bot → Campañas** muestra solo las campañas de ese bot.

Las dos tablas traen la misma información, y desde cualquiera de las dos se abre el detalle de una campaña.

<img src="https://mintcdn.com/inceptia/WM8YFZeRdbbgU7WN/images/operacion/campanas/04-vista-general.png?fit=max&auto=format&n=WM8YFZeRdbbgU7WN&q=85&s=9f95c968a624a1129818f2379d28fb43" alt="Detalle de una campaña: parámetros, casos, métricas, teléfonos y progreso" width="1180" height="844" data-path="images/operacion/campanas/04-vista-general.png" />

El detalle de una campaña reúne, arriba, los parámetros con los que se creó y las cifras de cómo viene; abajo, el listado de sus casos.

<Info>
  La tabla no se actualiza sola en tiempo real: se refresca cada 60 segundos, y también puedes forzarlo con el botón de refrescar.
</Info>

***

## Estados de una campaña

| Estado         | Qué significa                                         |
| -------------- | ----------------------------------------------------- |
| **Programada** | Creada, con fecha de inicio futura. Todavía no discó. |
| **En curso**   | Está gestionando casos dentro de su horario.          |
| **Pausada**    | Dejó de generar llamadas nuevas. Puede retomarse.     |
| **Cerrada**    | Terminó. No se reabre.                                |

### Iniciar, pausar y finalizar

Desde el menú de acciones de cada campaña se cambia su estado sin entrar al detalle:

| Acción        | Disponible cuando está…        | Qué hace                                |
| ------------- | ------------------------------ | --------------------------------------- |
| **Iniciar**   | Pausada o Programada           | La pone en curso.                       |
| **Pausar**    | En curso                       | Corta la generación de llamadas nuevas. |
| **Finalizar** | En curso, Pausada o Programada | Cierra la campaña definitivamente.      |

<Warning>
  **Pausar y finalizar no cancelan las llamadas que ya están en curso o encoladas.** Cortan la generación de llamadas nuevas, así que por unos minutos vas a seguir viendo actividad después de pausar.
</Warning>

<Warning>
  Una campaña cerrada **no se puede reabrir**. Si necesitas retomar el envío, hay que crear una campaña nueva con los casos pendientes.
</Warning>

<Info>
  Una campaña también se cierra sola, sin que nadie la finalice, cuando llega al 100% de completitud. Si ves una campaña Cerrada que nadie cerró, es esto.
</Info>

***

## Las métricas de una campaña

El detalle de una campaña agrupa sus cifras en dos bloques: **Métricas**, con contactabilidad y tasa de éxito, y **Progreso**, con las dos barras de avance.

<img src="https://mintcdn.com/inceptia/WM8YFZeRdbbgU7WN/images/operacion/campanas/02-metricas.png?fit=max&auto=format&n=WM8YFZeRdbbgU7WN&q=85&s=7e081c1f9529887ce5e1a0bea90be4a1" alt="Bloque de métricas con tasas de éxito y contactabilidad" width="387" height="289" data-path="images/operacion/campanas/02-metricas.png" />

### Contactabilidad

El porcentaje de casos de la campaña con los que el bot **logró hablar**. Un caso suma a la contactabilidad cuando hubo conversación; un teléfono que sonó sin que nadie atendiera, no.

<Info>
  En campañas en curso el valor se actualiza continuamente, con hasta un minuto de demora. En campañas cerradas queda fijo el valor final.
</Info>

### Tasa de éxito

El porcentaje de casos de la campaña que terminaron en **promesa de pago**. Es la métrica de resultado de negocio: no mide cuántas llamadas salieron bien, sino cuántos casos se comprometieron a pagar.

<Info>
  Contactabilidad y tasa de éxito responden preguntas distintas y no son comparables entre sí: una mide alcance — con cuántos hablaste — y la otra, resultado. Es normal que una sea alta y la otra baja.
</Info>

### Las dos barras de avance

En **Progreso** hay dos barras que miden dos cosas distintas del mismo envío:

| Barra                              | Qué mide                                                       |
| ---------------------------------- | -------------------------------------------------------------- |
| **Casos con al menos una llamada** | Casos que ya recibieron al menos un intento de contacto.       |
| **Casos completados**              | Casos cuya gestión ya terminó y no se van a volver a intentar. |

<img src="https://mintcdn.com/inceptia/WM8YFZeRdbbgU7WN/images/operacion/campanas/03-progreso.png?fit=max&auto=format&n=WM8YFZeRdbbgU7WN&q=85&s=b1dc81599d621ca411933c6f8abdbc24" alt="Las dos barras de avance de una campaña en curso" width="764" height="450" data-path="images/operacion/campanas/03-progreso.png" />

Un caso entra en la primera barra apenas se lo llama por primera vez. Recién entra en la segunda cuando su gestión terminó: porque dio un resultado final, porque agotó sus reintentos, o porque quedó en descanso.

Por eso **la barra de llamadas va siempre igual o por delante** de la de completados, y la distancia entre ambas es la cantidad de casos que están en gestión en este momento: ya se los intentó, pero todavía pueden recibir otra llamada.

Mientras la campaña avanza, esa distancia se abre y después se cierra: primero se disca a todos, y recién después van cerrando. **Cuando la campaña termina de gestionar todo, las dos barras marcan 100% y quedan iguales** — es la señal de que no queda nada pendiente.

<Info>
  Si la de llamadas llega al 100% y la de completados se queda atrás un rato, es normal: ya no hay casos sin intentar, pero algunos todavía admiten otro reintento antes de cerrar.
</Info>

***

## Los parámetros de la campaña

<img src="https://mintcdn.com/inceptia/WM8YFZeRdbbgU7WN/images/operacion/campanas/01-parametros.png?fit=max&auto=format&n=WM8YFZeRdbbgU7WN&q=85&s=848c632c85d4ac07ed9096f88ac4ebfb" alt="Bloque de parámetros de una campaña" width="387" height="295" data-path="images/operacion/campanas/01-parametros.png" />

### Reintentos

**Qué es:** cuántas veces se llama a cada teléfono antes de darlo por agotado.

<Warning>
  El límite es **por teléfono, no por caso**. Con reintentos en `4`, cada número del caso puede recibir hasta cuatro llamadas — no el caso entero. Cuántos números entran lo define [Prioridad](#modo-de-discado-y-prioridad).
</Warning>

### Modo de discado y Prioridad

Estos dos van juntos: el modo define **cómo** la campaña recorre los teléfonos de cada caso, y la prioridad **cuáles**.

Cada caso puede traer varios teléfonos. El orden no es casual: son las columnas que definiste en el [archivo de entrada de campaña](/construccion/archivo-entrada-campana), y ese orden es el de prioridad — el primero es el principal.

<CardGroup cols={2}>
  <Card title="Horizontal" icon="arrows-left-right">
    La campaña recorre **varios teléfonos por caso**. Prioridad indica hasta cuál: con `3`, usa los tres primeros y deja afuera el resto.
  </Card>

  <Card title="Vertical" icon="arrow-down">
    La campaña trabaja sobre **un solo teléfono**. Prioridad indica cuál: con `2`, llama únicamente al segundo teléfono de cada caso.
  </Card>
</CardGroup>

En horizontal, el bot no llama a los teléfonos en simultáneo ni va alternando: insiste con el primero hasta agotar sus reintentos, recién ahí pasa al segundo, y así. El caso se da por agotado cuando todos los teléfonos habilitados llegaron a su límite.

<Warning>
  En horizontal, prioridad y reintentos se multiplican. Con **prioridad 3** y **reintentos 4**, un caso puede recibir hasta **12 llamadas**: cuatro por cada uno de los tres teléfonos. Antes de subir cualquiera de los dos valores, conviene mirar el otro.
</Warning>

<Info>
  Prioridad no es una prioridad de la campaña frente a otras: no define cuál se atiende primero si tenés varias corriendo, sino qué teléfonos de cada caso entran en juego.
</Info>

<Tip>
  Vertical sirve para envíos quirúrgicos sobre un número puntual — por ejemplo, una segunda vuelta que llame solo al teléfono laboral. Horizontal es lo habitual cuando querés agotar las vías de contacto de cada caso.
</Tip>

### Inicio y horario

La fecha de **inicio** define cuándo arranca, y el **horario** entre qué horas del día puede llamar, en la zona horaria del bot.

***

## Los casos de la campaña

El bloque **Casos** informa qué pasó con los casos del archivo:

|                             |                                                                                                                                          |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Totales**                 | Casos que entraron desde el archivo.                                                                                                     |
| **Filtrados**               | Casos descartados al procesar el archivo, por no cumplir las validaciones que configuraste.                                              |
| **Descartado por descanso** | Casos que no se gestionaron por tener un descanso vigente de una campaña anterior. Ver [Reglas de descanso](/operacion/reglas-descanso). |
| **A gestionar**             | Los que quedaron efectivamente en juego: totales menos filtrados y menos descartados por descanso.                                       |

<Tip>
  Si una campaña llamó a muchos menos casos de los que cargaste, la explicación está acá: entre filtrados y descartados por descanso se va la diferencia.
</Tip>

El ícono de descarga junto a **Descartado por descanso** te baja el listado de esos casos, con una fila por caso: el identificador, sus teléfonos, los códigos de deuda, el **motivo del descanso** —la etiqueta que lo originó— y la **fecha de activación**, es decir a partir de cuándo vuelve a estar disponible para gestionar.

<Tip>
  Ese archivo responde la pregunta caso por caso: por qué este contacto no se llamó, y cuándo se lo va a poder llamar.
</Tip>

## Los teléfonos de la campaña

El bloque **Teléfonos** hace lo mismo un nivel más abajo, porque un caso puede traer varios números:

|                       |                                                                                                                                                                                                                        |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Filtrado (Enacom)** | Teléfonos descartados por el filtro del ente regulador. Se comparan contra el padrón oficial de asignaciones de numeración, así que caen los números que no existen o cuyo rango no está asignado a ninguna operadora. |
| **A gestionar**       | Los teléfonos que quedaron disponibles para llamar.                                                                                                                                                                    |

<Tip>
  El ícono de descarga junto a los filtrados te deja bajar el listado de los teléfonos descartados, para revisarlos contra tu base de origen.
</Tip>

<Info>
  Este filtro solo aplica donde hay un ente regulador con padrón público — en Argentina, Enacom. Evita gastar intentos en números que nunca iban a atender.
</Info>

***

## Desde la API

Todas estas cifras están disponibles sin entrar a la plataforma, en [Detalle de una campaña](/api-reference/campaigns/detail). También puedes [cambiar el estado](/api-reference/campaigns/status) de una campaña — iniciarla, pausarla o finalizarla — desde tu sistema.
