# Campaigner

El Campaigner te permite crear y gestionar campañas automatizadas de llamadas salientes: programa llamadas masivas a tus listas de contactos y deja que tus agentes de IA configurados las recorran.

> **Requisitos previos:** Tu plan debe incluir las [llamadas salientes](https://docs.voicelogica.ai/es/outbound-calls/), necesitas al menos un [agente de IA](https://docs.voicelogica.ai/es/getting-started/your-first-agent/) y un [teléfono o SIP trunk](https://docs.voicelogica.ai/es/telephony/introduction/) por el que llamar — la página Campaigns te avisa si aún falta un SIP trunk o un agente.
## Crear una campaña

1. **Inicia una campaña nueva**

   Abre la [página Campaigns](https://app.voicelogica.ai/campaigns) y haz clic en **"New Campaign"**.

     ![Página Campaigns](https://docs.voicelogica.ai/assets/outbound-calls/campaign-list.png)

2. **Configura lo básico**

   Dale a la campaña un **nombre** descriptivo (y una descripción opcional), elige el **agente de IA** que hablará — sus prompts y su voz aplican a cada llamada — y el **teléfono** desde el que se llama, que es el identificador de llamante que ven los destinatarios. La mayoría de los campos traen valores predeterminados razonables que puedes ajustar después.

3. **Define las propiedades de análisis**

   Las **Agent Analysis Properties** definen qué datos estructurados se extraen de cada llamada contestada — haz clic en **Manage Properties** para personalizar los puntos de datos. Los resultados aparecen en las analíticas de la campaña.

     ![Propiedades de análisis del agente](https://docs.voicelogica.ai/assets/outbound-calls/agent-analysis-properties.png)

4. **Configura los reintentos y el horario**

   Define los **intentos máximos de reintento** y la **espera entre reintentos** para las llamadas no contestadas. En la pestaña **Schedule**, configura el ritmo (el intervalo **"Run next calls in campaign every"**), la **zona horaria** (por defecto la de tu empresa) y uno o más **días de programación**, cada uno con su horario de funcionamiento (formato 24 horas, p. ej. 09:00–20:00). Las llamadas solo se cursan dentro de esas ventanas — manteniéndote en cumplimiento y llamando a horas locales sensatas.

     ![Horario de la campaña](https://docs.voicelogica.ai/assets/outbound-calls/campaign-schedule.png)

> **Las campañas solo corren estando Active:** Una campaña empieza como **Draft** (borrador). Pon su estado en **Active** para que empiece a llamar — puedes ponerla en **Pause** en cualquier momento, y se completa automáticamente cuando la lista termina.
## Añadir leads

Con la campaña guardada, añade los contactos a los que llamará tu agente. El camino más rápido es la plantilla de Google Sheets:

1. **Abre la plantilla y haz tu copia**

   En la sección **Leads** de la campaña haz clic en **"Open Template"** y luego, en Google Sheets, haz clic en **"USE TEMPLATE"** para copiarla a tu propio Drive.

     ![Añadir leads nuevos](https://docs.voicelogica.ai/assets/outbound-calls/new-leads.png)
     ![Usar plantilla](https://docs.voicelogica.ai/assets/outbound-calls/use-template.png)

2. **Rellena tus columnas**

   Las columnas **`phone`** y **`email`** de la plantilla son obligatorias — no las borres. Todo lo demás es tuyo: quita `client_name`/`client_last_name` si no las usas, o añade columnas personalizadas (`company`, `appointment_date`, `previous_interaction`, …) — cada columna personalizada se convierte en una **variable dinámica** que tu agente puede usar.

     ![Columnas de la plantilla](https://docs.voicelogica.ai/assets/outbound-calls/leads.png)

3. **Copia las filas — incluida la fila de cabecera**

   Selecciona tus leads **junto con la primera fila** (los nombres de las columnas) y copia.

     ![Copiar leads con la cabecera](https://docs.voicelogica.ai/assets/outbound-calls/copy-leads.png)

4. **Pega en Voice Logica y confirma**

   Pega en el área de leads, revisa la tabla de vista previa y haz clic en **"Add Leads"**. Los leads aparecen en la tabla de la campaña, listos para ser llamados según el horario.

     ![Pegar leads](https://docs.voicelogica.ai/assets/outbound-calls/paste-leads.png)
     ![Revisar y añadir leads](https://docs.voicelogica.ai/assets/outbound-calls/add-leads.png)
     ![Tabla de leads de la campaña](https://docs.voicelogica.ai/assets/outbound-calls/campaign-leads.png)

## Personalizar las llamadas con variables dinámicas

Tus columnas personalizadas de leads se convierten en **variables dinámicas** para las instrucciones del agente — en cada llamada se sustituyen automáticamente por los valores de ese lead:

```
You are calling {{client_name}} {{client_last_name}} about their {{appointment_date}} appointment.
```

Las variables disponibles se muestran en la interfaz de la campaña después de importar los leads.

  ![Variables dinámicas en las instrucciones del agente](https://docs.voicelogica.ai/assets/outbound-calls/calling-lead.png)

## Revisar los resultados

Tras una llamada contestada, las propiedades de análisis se rellenan con datos extraídos de la conversación — las llamadas no contestadas siguen en cambio tus ajustes de reintento.

  ![Resultados del análisis tras una llamada](https://docs.voicelogica.ai/assets/outbound-calls/after-call.png)

Para ajustar **qué** se extrae, abre el editor del agente y ve a **After the call → Call results** — las propiedades de análisis configuradas ahí dirigen la extracción.

## Solución de problemas

**Mi campaña no hace ninguna llamada**

- El estado debe ser **Active** — un Draft nunca corre.
- Comprueba que estás dentro de una ventana de día/hora programada (y en la zona horaria correcta).
- Verifica que el plan incluye llamadas salientes y que tu cuenta de telecomunicaciones tiene créditos.

**Las propiedades de análisis vuelven vacías**

Las propiedades solo se extraen de llamadas **contestadas**. Para llamadas contestadas con resultados vacíos, revisa las definiciones de propiedades en la pestaña **After the call → Call results** del agente.