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

# El motor de campañas

> Cómo QCobro decide a qué cuentas contactar y cuándo: horario, topes de intentos y el registro de cada gestión.

Una [campaña](/guides/campaigns) es un programa de contacto **agendado** sobre tus carteras.
Una vez activa, QCobro contacta a sus cuentas por ti, respetando el horario y los límites que
definiste. Esta página explica **cómo decide** a quién contactar y cuándo.

<Frame caption="De una campaña activa a una gestión registrada, respetando reglas y topes.">
  <img src="https://mintcdn.com/qcobro/kozU_2vIhat4aqL6/images/campaigns-engine/flow.png?fit=max&auto=format&n=kozU_2vIhat4aqL6&q=85&s=d55ce12f7a15b023230281ea71d042ce" alt="Diagrama de flujo: campaña activa → reglas (días, horario, fechas y topes) → contacto → gestión registrada." width="3200" height="1800" data-path="images/campaigns-engine/flow.png" />
</Frame>

## Qué respeta cada intento

Antes de contactar a una cuenta, QCobro comprueba que la campaña esté **activa** y dentro de
sus reglas:

* **Días de operación** — solo los días de la semana que elegiste.
* **Horario** — entre la hora de inicio y la de fin de cada día, en la **zona horaria del
  espacio de trabajo**.
* **Rango de fechas** — desde la fecha de inicio y, si la fijaste, hasta la fecha de fin.
* **Topes de intentos** — nunca más del **máximo por cuenta** ni del **máximo por día**.

Así controlas la presión de contacto y evitas llamar fuera de hora o de más.

## Un intento, una gestión

Cada vez que QCobro contacta a una cuenta dentro de una campaña, registra el intento como una
**gestión** con su resultado y su [análisis con IA](/guides/ai-insights). QCobro está diseñado
para **no contactar de más**: un intento programado se cuenta una sola vez, aunque varias piezas
trabajen a la vez.

## El ciclo de vida de una campaña

Una campaña recién creada arranca **Activa** y empieza a contactar de inmediato. Desde ahí se
mueve entre estados:

| Estado         | Significado                                                                        |
| -------------- | ---------------------------------------------------------------------------------- |
| **Activa**     | Contactando dentro de su horario.                                                  |
| **Pausada**    | Detenida; no contacta hasta que la actives de nuevo.                               |
| **Completada** | Terminada; no vuelve a contactar.                                                  |
| **Archivada**  | Retirada de la vista activa; al restaurarla queda **Pausada**, nunca reanuda sola. |

## Más allá de las campañas

No todo el contacto pasa por una campaña. También puedes **contactar manualmente** a una cuenta
desde su cartera; ese contacto se registra igualmente como una gestión, pero sin campaña
asociada. Y los sistemas externos pueden registrar gestiones por el
[endpoint de gestiones](/api/contact-log).

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Lanzar una campaña" icon="bullhorn" href="/guides/campaigns">
    Configura el horario y los topes de una campaña.
  </Card>

  <Card title="Promesas de pago" icon="hand-holding-dollar" href="/guides/payment-promises">
    Trabaja los compromisos que surgen de las gestiones.
  </Card>
</CardGroup>
