Plantillas WhatsApp | Plazbot Docs

Introduccion

El modulo de Template te permite consultar y gestionar las plantillas de WhatsApp aprobadas por Meta desde tu codigo. Las plantillas son necesarias para iniciar conversaciones fuera de la ventana de 24 horas.

Las plantillas se crean y aprueban desde Marketing > Plantillas en la plataforma Plazbot. Este modulo te permite consultarlas programaticamente.

Inicializacion

Plazbot (recomendado)·ts

01import { Plazbot } from 'plazbot';
02 
03const plazbot = new Plazbot({
04  workspaceId: "YOUR_WORKSPACE_ID",
05  apiKey: "YOUR_API_KEY",
06  zone: "LA"
07});
08 
09// Usar: plazbot.template.getTemplates()

Listar Todas las Plantillas

Obtiene todas las plantillas del workspace, incluyendo las pendientes de aprobacion.

01const templates = await plazbot.template.getTemplates();
02 
03for (const t of templates) {
04  console.log(`${t.name} - ${t.status}`);
05}

Listar Plantillas Activas

Obtiene solo las plantillas que estan aprobadas y listas para usar.

01const active = await plazbot.template.getActiveTemplates();
02console.log(`Plantillas activas: ${active.length}`);

Obtener Plantilla por ID

Obtiene el detalle de una plantilla especifica.

01const template = await plazbot.template.getTemplate("template-id");
02 
03console.log(template.name);
04console.log(template.status);
05console.log(template.language);
06console.log(template.category);

Campos de la Plantilla

Campo	Tipo	Descripcion
`id`	`string`	Identificador unico de la plantilla
`name`	`string`	Nombre de la plantilla
`status`	`string`	Estado: `APPROVED`, `PENDING`, `REJECTED`
`language`	`string`	Codigo de idioma (ej: `es`, `en`)
`category`	`string`	Categoria: `MARKETING`, `UTILITY`, `AUTHENTICATION`
`components`	`array`	Componentes de la plantilla (header, body, footer, buttons)

Uso con Mensajes

Una vez que tienes el nombre de la plantilla, puedes usarla para enviar mensajes:

01// Obtener plantillas activas
02const templates = await plazbot.template.getActiveTemplates();
03const templateName = templates[0].name;
04 
05// Enviar usando el modulo de mensajes
06await plazbot.message.onConversation({
07  to: "51912345678",
08  template: templateName
09});

Combina el modulo de Template con el de Message para automatizar el envio de plantillas. Puedes listar las activas y enviarlas de forma programatica.