> ## 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.

# Inicio rápido — Campañas

> Arma audiencia, plantilla y canal; dispara o programa una campaña.

<Tip>
  Una **campaña** = envío masivo a un **segmento** (o lista) con una **plantilla** y **canal** definidos.
</Tip>

## En resumen

* **Prepara** segmento, plantilla e instancia del canal.
* **Crea** la campaña en el panel o con `POST /v1/campaigns`.
* **Dispara** inmediato o programado; monitorea estado y métricas.

Contexto: [Campañas en el panel](/es/contacts-api/como-funciona/campanhas-no-painel). Alcances: [Alcances de campañas](/es/contacts-api/como-funciona/campanhas-escopos-da-api-key).

## Antes de empezar

| Ítem                          | Obligatorio                 |
| ----------------------------- | --------------------------- |
| Segmento o lista de contactos | Audiencia                   |
| Plantilla aprobada            | Contenido                   |
| Instancia conectada           | Canal (correo, WhatsApp, …) |
| **`campaigns:create`**        | Para crear vía API          |

Auth: `Authorization: Bearer sk_live_...`. URL base: `https://api.notifique.dev`.

***

## 1. Por el panel

1. **Campañas → Nueva**
2. Nombre interno
3. **Audiencia**: segmento (recomendado) o selección manual
4. **Canal** + instancia
5. **Plantilla** (categoría MARKETING necesita tema)
6. **Disparo**: ahora o fecha/hora
7. Revisa la vista previa y confirma

El panel muestra progreso, entregas y errores por contacto.

***

## 2. Crear campaña (API)

```http theme={null}
POST /v1/campaigns
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "name": "Newsletter marzo",
  "segmentId": "clxxSegmentId",
  "channel": "email",
  "instanceId": "clxxInstanceEmail",
  "templateId": "clxxTemplateId",
  "sendAt": null
}
```

`sendAt` en ISO 8601 para programar; `null` u omitido para disparo inmediato (según API).

***

## 3. Consultar campaña

```http theme={null}
GET /v1/campaigns/{campaignId}
Authorization: Bearer sk_live_xxxxx
```

***

## 4. Listar campañas

```http theme={null}
GET /v1/campaigns?page=1&limit=20
Authorization: Bearer sk_live_xxxxx
```

***

## Buenas prácticas

* Usa **segmentos** en lugar de listas estáticas cuando la audiencia cambia con el tiempo.
* Plantillas **MARKETING**: asocia **tema** y respeta `receiveMarketing`.
* Prueba con segmento pequeño o sandbox antes del disparo total.
* Verifica **supresiones** — los contactos suprimidos no reciben.

***

## Próximos pasos

* [Segmentos — Inicio rápido](/es/contacts-api/como-funciona/segmentos-quick-start)
* [Supresiones — introducción](/es/suppressions-api/como-funciona/introducao)
* [Introducción — Contactos](/es/contacts-api/como-funciona/introducao)