Producto
CLI

Crear una campaña

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

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
01plazbot campaigns create -n <nombre> -t <templateId> (-p <número>... | --csv <archivo>) [opciones]

Parámetros

ParámetroFlagRequeridoDescripció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 --csvDestinatario en formato internacional. Repite el flag
Variable-e, --var <value>NoValor de una variable del cuerpo para todos los --phone, en orden {{1}}, {{2}}… Repite el flag
Variable de encabezado--header-var <value>NoValor de {{1}} del encabezado para todos los --phone
CSV--csv <path>Sí, o --phoneUna fila por contacto con columnas name, phone (o number, telefono, celular), body_var1… y header_var1. Máximo 2 MB
Programar--at <date>NoFecha ISO con tu zona, por ejemplo 2026-11-02T09:00:00-05:00. Por defecto sale de inmediato
Sin chat--no-show-in-chatNoNo muestra los mensajes en el chat de cada contacto
Sin agente IA--no-aiNoLas respuestas no las atiende el agente IA
Etiqueta--tag <tagId>NoEtiqueta que se agrega a cada destinatario. Repite el flag
Confirmar-y, --yesNoNo pide confirmación
JSON--jsonNoImprime { "id": "cam_...", "status": "sending" | "scheduled" }

Ejemplos

bash
01# Dos números, ahora
02plazbot campaigns create -n "Black Friday" -t tem_AbcDef123 -p +51912345678 -p +51998765432 -y
03 
04# Una fila por contacto con sus variables, programada
05plazbot 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 y detenlo con campaigns cancel.

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.

¿Quieres probar la API en vivo? Abre el Playground.