# Campañas

Deja que el agente llame a una lista de números según un horario, con reintentos, y registre cada llamada

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Una **campaña** es un lote de llamadas salientes con IA: el agente marca tu lista de clientes con su propio prompt, voz y número de teléfono. Las llamadas salen dentro de las ventanas que configures, se reintentan si no contestan o comunican, y cada llamada queda en **Historial** con su transcripción y grabación.

Ábrela desde la barra lateral del agente: **Configurar** > **Campañas**.

<CampaignsPageDemo />

## Antes de empezar [#before-you-start]

* El agente tiene un **número de teléfono** habilitado asignado: consulta [Números de teléfono](/docs/agents/phones). Sin él, la campaña se pausa con un error de configuración.
* El espacio de trabajo tiene **saldo**. Las llamadas se cobran como uso de voz normal; cuando se agota el saldo, la campaña se pausa y se reanuda tras una recarga.
* Necesitas permiso de escritura en **Llamadas** para crear y ejecutar campañas.

## Crear una campaña [#create-a-campaign]

**Nueva campaña** abre un asistente de tres pasos.

**1. Datos básicos**

| Campo                | Qué hace                                                                                                                                                                 |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Nombre de la campaña | Al menos 2 caracteres, p. ej. "Reactivación de primavera"                                                                                                                |
| Agente               | Fijado a este agente: su prompt, voz e idioma hacen las llamadas                                                                                                         |
| Líneas               | Cuántas llamadas se hacen a la vez, 1–100 (por defecto 1: los números se marcan uno tras otro). Limitado por tu plan; se puede cambiar mientras la campaña está en curso |

**2. Horario**

| Campo                          | Qué hace                                                                                                                                                                |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Zona horaria                   | El reloj de la campaña para ventanas y fechas                                                                                                                           |
| Fecha de inicio / Fecha de fin | Opcional. Cuando pasa la fecha de fin, la campaña termina y todos los que aún no se contactaron se marcan como **No contactado**                                        |
| Ventanas de llamada            | Horas desde–hasta (las nuevas ventanas son 09:00–18:00 por defecto). Las llamadas solo salen dentro de ellas. Sin ventanas, las llamadas salen a cualquier hora del día |

**3. Reintentos y lanzamiento**

| Campo              | Qué hace                                                                      |
| ------------------ | ----------------------------------------------------------------------------- |
| Máximo de intentos | 1–10 (por defecto 3). Después, el número se marca como no contactado          |
| Modo de reintento  | **Inmediatamente**, **Tras N minutos** (1–1440) o **En la siguiente ventana** |
| Reintentar cuando  | **Sin respuesta**, **Ocupado**, **Fallida**: todos activados por defecto      |

**Crear campaña** la guarda como **Borrador** y abre **Fuentes**, de donde salen los números.

## Añadir números [#add-numbers]

Una campaña obtiene sus números de una o varias fuentes:

| Fuente            | Cómo funciona                                                                                                                                                                                                                                                                                                                   |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Lista pegada      | Un número por línea, o CSV con `,` o `;`. La primera columna es el teléfono; las demás columnas se convierten en variables de llamada (con el nombre de la fila de encabezado, o si no `var1…varN`) que el agente puede usar en su prompt. Hasta 10 000 números por carga; los números no válidos y los duplicados se descartan |
| Selección del CRM | Condiciones sobre KeyCRM, NetHunt o SalesDrive con vista previa en vivo. Se ejecuta enseguida y luego a intervalos o según un horario, omitiendo los números llamados en los últimos N días                                                                                                                                     |
| Evento del CRM    | Copia la URL del webhook en tu CRM; cada evento añade un número. Filtro de etapa opcional: llamar solo en una etapa concreta del trato. Una campaña así nunca termina por sí sola                                                                                                                                               |
| Hoja de Google    | Comparte la hoja con el email de la cuenta de servicio que muestra Happ, pega el enlace, elige la pestaña y la columna del teléfono, y asigna las demás columnas a variables del prompt                                                                                                                                         |

```
+380991234567
phone,name,city
+380991234568,Anna,Kyiv
```

## Ejecutarla [#run-it]

No se marca nada mientras la campaña es un **Borrador**: pulsa **Iniciar campaña**.

| Estado                 | Acciones                   |
| ---------------------- | -------------------------- |
| Borrador               | Iniciar campaña, Eliminar  |
| En curso               | Pausar, Cancelar campaña   |
| Pausada                | Reanudar, Cancelar campaña |
| Finalizada / Cancelada | Eliminar                   |

* **Pausar** detiene las llamadas nuevas; las llamadas ya entregadas al proveedor pueden completarse.
* **Cancelar** cancela todos los números en espera y no se puede deshacer.
* La configuración solo se puede editar en **Borrador** o **Pausada**; **Líneas** también se puede cambiar en curso (se aplica en unos 20 segundos).
* Happ pausa por sí mismo una campaña en curso por **Saldo insuficiente** o un **Error de configuración** (sin teléfono, teléfono deshabilitado). Corrige la causa y pulsa **Reanudar**.

## Resultados [#results]

* **Resumen**: progreso y contadores: total, en cola, marcando, contactados, inalcanzables, cancelados.
* **Contactos**: cada número con su estado (**En espera**, **Marcando**, **Contactado**, **No contactado**, **Cancelada**), intentos usados, último resultado y próximo intento.
* **Historial de intentos**: haz clic en un número para ver el resultado de cada intento (**Conectado**, **Sin respuesta**, **Ocupado**, **Fallida**, **Sin marcar**) y **Abrir llamada** para la transcripción y la grabación.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Siguiente [#next]

* [Números de teléfono](/docs/agents/phones): asigna el número desde el que llama el agente
* [Voz](/docs/agents/voice): cómo suena y habla el agente
* [Análisis](/docs/workspace/analysis): evalúa las llamadas de la campaña con un monitor
