Crear una plantilla

Crea una plantilla de WhatsApp y la envía a aprobación de Meta, igual que en Marketing > Plantillas. Meta la revisa en minutos, a veces hasta en 24 horas; consulta el resultado con templates sync.

bash

01plazbot templates create -n <nombre> -c <categoría> -b <cuerpo> [opciones]

Parámetros

Parámetro	Flag	Requerido	Descripción
Nombre	`-n, --name <name>`	Sí	Minúsculas, números y guion bajo (ej. `order_update`).
Categoría	`-c, --category <category>`	Sí	`MARKETING`, `UTILITY` o `AUTHENTICATION`.
Cuerpo	`-b, --body <text>`	Sí	Texto del mensaje. Variables `{{1}}`, `{{2}}`… en orden.
Ejemplos	`-e, --example <values...>`	Si hay variables	Un valor de ejemplo por variable del cuerpo, en orden. Meta los usa para revisar la plantilla.
Idioma	`-l, --language <code>`	No	Código de idioma de Meta. Por defecto `es`.
Número	`-p, --phone <number>`	No	Número que envía la plantilla. Obligatorio si el workspace tiene más de un número.
Id del número	`--number-id <id>`	No	Id de la integración en Plazbot, en lugar de `--phone`.
Encabezado	`--header <text>`	No	Encabezado de texto, con una variable `{{1}}` opcional.
Ejemplo del encabezado	`--header-example <value>`	No	Valor de ejemplo de la variable `{{1}}` del encabezado.
Archivo de encabezado	`--header-file <path>`	No	Imagen JPG/PNG, video MP4 o documento PDF.
Pie	`--footer <text>`	No	Pie de mensaje.
Botones	`--button <spec...>`	No	`quick:Texto`, `url:Texto\|https://…` o `phone:Texto\|+51912345678`. Hasta 10.
Etiquetas	`--tag <tags...>`	No	Etiquetas internas de Plazbot.
Desde archivo	`--from-file <path>`	No	Lee todo de un JSON. Los flags lo sobrescriben.
Workspace / zona	`-w` / `-z`	No	Por defecto, los activos.
JSON	`--json`	No	Imprime `{ id, name, status }`.

Ejemplos

bash

01# Plantilla de utilidad con dos variables
02plazbot templates create -n order_update -c UTILITY \
03  -b "Hola {{1}}, tu pedido {{2}} ya salió." -e Ana PB-123
04 
05# Con PDF en el encabezado, pie y botones
06plazbot templates create -n factura_lista -c UTILITY \
07  -b "Hola {{1}}, adjuntamos tu factura." -e Ana \
08  --header-file ./factura.pdf --footer "Gracias por tu compra" \
09  --button "quick:Recibido" "url:Pagar|https://pagos.example.com"
10 
11# Desde un archivo JSON
12plazbot templates create --from-file ./plantilla.json --json

El JSON usa los mismos campos que el SDK. El archivo del encabezado se indica como ruta:

json

01{
02  "name": "confirmacion_cita",
03  "category": "UTILITY",
04  "number": "+51912345678",
05  "header": { "file": "./cita.png" },
06  "body": { "text": "Hola {{1}}, tu cita es el {{2}}.", "examples": ["Ana", "jueves"] },
07  "buttons": [{ "type": "QUICK_REPLY", "text": "Confirmar cita" }]
08}

Resultado

text

01✔ Template order_update created (tem_AbcDef123)
02  Status in Meta: pending review
03ℹ Check it later with: plazbot templates sync