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

# Campañas salientes

> Carga una lista de contactos y deja que un agente la gestione, con ventanas de llamada, reintentos y progreso en tiempo real.

Las campañas marcan una lista de contactos en tu nombre: elige un agente, carga un
CSV, define cuándo se permiten las llamadas y ThunderPhone trabaja en la lista
— reintentando las llamadas sin respuesta y los buzones de voz según el horario que elijas. Encuéntralas
en **Interacción → Campañas** (`/dashboard/campaigns`).

Para llamadas programáticas puntuales, usa la
[API de llamadas salientes](/es/guides/place-outbound-calls).

## Requisitos previos

* Un agente de voz implementado.
* Un **número de teléfono VoIP** conectado a tu organización desde el cual llamar —
  los números de demostración son solo para llamadas entrantes y no pueden realizar llamadas de campaña. Consulta
  [Conectar un proveedor de VoIP](/es/guides/voip-providers).
* Contactos en un archivo CSV (o JSON pegado) con una columna `phone` o
  `phone_number`. **Hasta 5,000 filas por carga**, codificado en UTF-8.
  Cualquier columna adicional se conserva como variables por contacto en los
  registros de contactos de la campaña.

## Crear una campaña

<Steps>
  <Step title="Haz clic en Nueva campaña">
    Asígnale un nombre, elige el **agente de voz** y selecciona el **número de origen**
    (uno de tus números VoIP).
  </Step>

  <Step title="Carga el CSV de contactos">
    Las filas con un número de teléfono no válido se rechazan individualmente y
    se informan con sus números de fila — el resto se importa sin problemas.
  </Step>

  <Step title="Configura la ventana de llamadas">
    Elige una **zona horaria** y una ventana de **inicio/fin diario**; la campaña
    solo marca dentro de ella. Las ventanas pueden abarcar la medianoche (p. ej., 22:00 → 02:00).
    Opcionalmente, configura un **inicio programado** para programar el lanzamiento y una
    **finalización programada** después de la cual la campaña se completa automáticamente.
  </Step>

  <Step title="Ajusta el ritmo y los reintentos">
    * **Llamadas simultáneas** — cuántas llamadas ejecuta esta campaña a la vez
      (1–10, 3 de forma predeterminada). Tu organización también tiene un límite de **10
      llamadas salientes simultáneas** en total, por lo que las campañas
      paralelas comparten ese límite.
    * **Máximo de intentos** — cuántas veces se puede marcar a cada contacto
      (2 de forma predeterminada).
    * **Espera para reintento (minutos)** — la espera antes de un reintento (60 de forma predeterminada).
    * **Reintentar en** — qué resultados activan un reintento: **sin respuesta**,
      **buzón de voz**, **fallida** (todos activados de forma predeterminada).
  </Step>

  <Step title="Crea el borrador y luego inícialo">
    Las campañas se crean como borradores — los contactos solo se pueden agregar mientras una
    campaña sea un borrador. Iniciar una campaña requiere consentimiento explícito
    para los cargos de llamadas. Con un **inicio programado** futuro pasa a estar
    *programada*; de lo contrario, comienza a *ejecutarse* inmediatamente.
  </Step>
</Steps>

## Cómo funcionan los resultados y los reintentos

Después de cada llamada, el contacto recibe un resultado — las llamadas exitosas se
marcan como completadas; una llamada clasificada como sin respuesta, detectada como buzón de voz o
fallida se reintenta si ese resultado está en tu lista de **reintentar en** y al
contacto le quedan intentos. Los contactos que agotan sus intentos se marcan como
*agotados*; las fallas que no se pueden reintentar se marcan como *fallidas*.

<Note>
  Las marcaciones se pausan automáticamente mientras el saldo de tu cuenta no esté
  al día y se reanudan cuando lo esté. Mantén activada la
  [recarga automática](/es/guides/billing-and-topups) para campañas largas.
</Note>

## Supervisar y controlar

Cada tarjeta de campaña muestra su estado y progreso (p. ej., "173 de 248
finalizadas"). Abre una campaña para ver el desglose de estados, los resultados por contacto
y las llamadas recientes — cada una enlaza con la transcripción completa y la
grabación en el historial de llamadas.

* **Pausar / reanudar** — al pausar se detienen las nuevas marcaciones; las llamadas que ya están
  en curso terminan naturalmente. Las campañas pausadas se pueden editar y reanudar.
* **Cancelar** — detiene la campaña permanentemente.
* Una campaña se completa por sí sola cuando cada contacto alcanza un estado
  final o pasa la hora de **finalización programada**.

Estados de campaña: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`. Estados de contacto: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`.

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Ver llamadas en vivo" icon="tower-broadcast" href="/es/guides/monitor-live-calls">
    Escucha las llamadas de la campaña mientras ocurren.
  </Card>

  <Card title="API de llamadas salientes" icon="phone-arrow-up-right" href="/es/guides/place-outbound-calls">
    Realiza llamadas individuales mediante programación.
  </Card>
</CardGroup>