# Crear una campaña

> plazbot campaigns create: envía una plantilla aprobada a muchos contactos, al instante o programada.

Fuente: https://developers.plazbot.com/cli/campaigns/create/

### Crear una campaña

Envía una plantilla aprobada a una lista de números. El envío corre en Plazbot (igual que **Marketing** > **Campañas**), así que el comando termina apenas la campaña queda creada. Pide confirmación porque envía mensajes reales; en scripts usa `-y`.

```bash
plazbot campaigns create -n <nombre> -t <templateId> (-p <número>... | --csv <archivo>) [opciones]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Nombre | `-n, --name <name>` | Sí | Nombre de la campaña |
| Plantilla | `-t, --template <templateId>` | Sí | Id de una plantilla aprobada (`tem_...`) |
| Número | `-p, --phone <number>` | Sí, o `--csv` | Destinatario en formato internacional. Repite el flag |
| Variable | `-e, --var <value>` | No | Valor de una variable del cuerpo para todos los `--phone`, en orden `{{1}}`, `{{2}}`… Repite el flag |
| Variable de encabezado | `--header-var <value>` | No | Valor de `{{1}}` del encabezado para todos los `--phone` |
| CSV | `--csv <path>` | Sí, o `--phone` | Una fila por contacto con columnas `name`, `phone` (o `number`, `telefono`, `celular`), `body_var1`… y `header_var1`. Máximo 2 MB |
| Programar | `--at <date>` | No | Fecha ISO con tu zona, por ejemplo `2026-11-02T09:00:00-05:00`. Por defecto sale de inmediato |
| Sin chat | `--no-show-in-chat` | No | No muestra los mensajes en el chat de cada contacto |
| Sin agente IA | `--no-ai` | No | Las respuestas no las atiende el agente IA |
| Etiqueta | `--tag <tagId>` | No | Etiqueta que se agrega a cada destinatario. Repite el flag |
| Confirmar | `-y, --yes` | No | No pide confirmación |
| JSON | `--json` | No | Imprime `{ "id": "cam_...", "status": "sending" \| "scheduled" }` |

### Ejemplos

```bash
# Dos números, ahora
plazbot campaigns create -n "Black Friday" -t tem_AbcDef123 -p +51912345678 -p +51998765432 -y

# Una fila por contacto con sus variables, programada
plazbot campaigns create -n "Noviembre" -t tem_AbcDef123 --csv destinatarios.csv --at 2026-11-02T09:00:00-05:00 -y
```

Sigue el envío con [`campaigns records`](https://developers.plazbot.com/cli/campaigns/records) y detenlo con [`campaigns cancel`](https://developers.plazbot.com/cli/campaigns/cancel).

> **Importante:** Las plantillas salen aunque el contacto no haya escrito en las últimas 24 horas, y Meta cobra cada mensaje según la categoría de la plantilla.