Skip to main content

​
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

import { Plazbot } from 'plazbot';

const plazbot = new Plazbot({
  workspaceId: "YOUR_WORKSPACE_ID",
  apiKey: "YOUR_API_KEY",
  zone: "LA"
});

// Usar: plazbot.template.getTemplates()

​
Listar Todas las Plantillas

Obtiene todas las plantillas del workspace, incluyendo las pendientes de aprobacion. 
const templates = await plazbot.template.getTemplates();

for (const t of templates) {
  console.log(`${t.name} - ${t.status}`);
}

​
Listar Plantillas Activas

Obtiene solo las plantillas que estan aprobadas y listas para usar. 
const active = await plazbot.template.getActiveTemplates();
console.log(`Plantillas activas: ${active.length}`);

​
Obtener Plantilla por ID

Obtiene el detalle de una plantilla especifica. 
const template = await plazbot.template.getTemplate("template-id");

console.log(template.name);
console.log(template.status);
console.log(template.language);
console.log(template.category);

​
Campos de la Plantilla

CampoTipoDescripcion
idstringIdentificador unico de la plantilla
namestringNombre de la plantilla
statusstringEstado: APPROVED, PENDING, REJECTED
languagestringCodigo de idioma (ej: es, en)
categorystringCategoria: MARKETING, UTILITY, AUTHENTICATION
componentsarrayComponentes de la plantilla (header, body, footer, buttons)

​
Uso con Mensajes

Una vez que tienes el nombre de la plantilla, puedes usarla para enviar mensajes: 
// Obtener plantillas activas
const templates = await plazbot.template.getActiveTemplates();
const templateName = templates[0].name;

// Enviar usando el modulo de mensajes
await plazbot.message.onConversation({
  to: "51912345678",
  template: templateName
});
Combina el modulo de Template con el de Message para automatizar el envio de plantillas. Puedes listar las activas y enviarlas de forma programatica.