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

# Campañas de panel

> Plantilla, canales, audiencia, programación, ejecución y estadísticas: la misma cola y créditos que la API.

<Tip>
  **Campaña** = **qué** (plantilla) + **dónde** (canales) + **quién** (segmento o ID). **Ejecutar** colas de envíos, no un motor independiente de la API de envío.
</Tip>

## ¿Qué es una campaña?

**Envío por lotes** a una audiencia mediante una **plantilla** multicanal. El panel y la API comparten la misma cola, créditos y estado.

Analogía: **plantilla** es la letra. **Segmento** es la lista de direcciones. **Campaña** se sella y se deposita en el buzón.

## Campaña × segmento × envío directo

|                       | **Campaign**                          | **Segment**           | **Direct API send**                        |
| --------------------- | ------------------------------------- | --------------------- | ------------------------------------------ |
| Purpose               | **Batch** immediate or scheduled send | Reusable **audience** | One-off or few recipients                  |
| Needs                 | Template + channels + audience        | JSON rules only       | Channel route or `POST /v1/templates/send` |
| Continuous automation | No (use **Automations**)              | No                    | Can be a script                            |

## ¿Cuándo usarlo?

Excelente para **boletines**, **promociones para audiencias filtradas** y **pruebas con pocas identificaciones** antes de la base completa. Para una **alerta única** mediante script, utilice el canal directo o el envío de plantilla.

## Canales de campaña

`channels` acepta: **`whatsapp`**, **`sms`**, **`email`**, **`telegram`**.

Cada canal listado debe estar **habilitado en la plantilla**.

| Channel  | Contact needs    | Extra config                   |
| -------- | ---------------- | ------------------------------ |
| WhatsApp | **Phone**        | `instanceId` or Sending Pool   |
| SMS      | **Phone**        | ,                              |
| Email    | **Email**        | `fromEmail` or verified domain |
| Telegram | Peer on instance | `telegramInstanceId`           |

Falta teléfono, correo electrónico o contacto → contacto **omitido para ese canal** (sin error por persona).

<Info>
  **Marketing:** el contacto necesita `receiveMarketing` **y** **tema** suscripción cuando la plantilla está vinculada. Otros no entran en la cola.
</Info>

## Cómo funciona en la práctica

1. **Plantilla** con canales y contenido activos
2. **Nueva campaña**, nombre, plantilla, canales, audiencia (segmento o ID)
3. Tabla de enrutamiento por canal anterior
4. Opcional: **horario** (`scheduledFor`) → **PROGRAMADO**
5. **Vista previa** del segmento si se utiliza
6. **Ejecutar** → **EN EJECUCIÓN** → **COMPLETADO** o **FALLADO**

### Estado

| Status      | Meaning                          |
| ----------- | -------------------------------- |
| `DRAFT`     | Draft                            |
| `SCHEDULED` | Scheduled                        |
| `RUNNING`   | Queuing / running                |
| `COMPLETED` | Last run succeeded               |
| `FAILED`    | Last run failed                  |
| `CANCELLED` | Cancelled (DRAFT/SCHEDULED only) |

## En la API

| Action               | Typical scope      |
| -------------------- | ------------------ |
| Create / schedule    | `campaigns:create` |
| Dispatch now         | `campaigns:run`    |
| Cancel               | `campaigns:update` |
| Stats and recipients | `campaigns:read`   |

**Ejecutar** devuelve `sent` y `runId`. Los enlaces cortos obtienen `utm_campaign` y `utm_content` automáticamente.

## Lista de verificación antes de ejecutar

1. ¿Canales de campaña **habilitados en la plantilla**?
2. ¿El segmento **Vista previa** tiene sentido?
3. ¿Telegram peers en la instancia correcta?
4. ¿Probado con **pocas identificaciones**?
5. **Créditos**, instancias y remitente del correo electrónico, ¿está bien?

## Próximos pasos

* [Inicio Rápido](/es/contacts-api/como-funciona/quick-start)
* [Segmentos](/es/contacts-api/como-funciona/segmentos-na-audiencia)
* [Plantillas](/es/template-api/como-funciona/quick-start)