whatsapp-template-client

Paquete npm para encapsular el envío de mensajes de WhatsApp Cloud API usando plantillas, con una implementación lista para alertabuzonexperiencia.

Qué extrae del proyecto original

• Construcción del payload para /{version}/{phoneId}/messages
• Template alertabuzonexperiencia
• Normalización del texto del mensaje antes de enviarlo
• Cliente reutilizable con fetch

Instalación

npm install whatsapp-template-client

Uso rápido

const { WhatsAppClient } = require("whatsapp-template-client");

const client = WhatsAppClient.fromEnv({
  WHATSAPP_DATA_TOKEN: process.env.WHATSAPP_DATA_TOKEN,
  WHATSAPP_DATA_PHONEID: process.env.WHATSAPP_DATA_PHONEID,
  WHATSAPP_DATA_VERSION: process.env.WHATSAPP_DATA_VERSION,
});

await client.sendAlertaBuzonExperiencia({
  to: "528112556629",
  folio: "1234",
  location: "Hospital Cumbres",
  message: "Paciente inconforme con el tiempo de espera.",
});

API

new WhatsAppClient({ token, phoneId, version, apiBaseUrl?, fetchImpl? })

Crea un cliente para WhatsApp Cloud API.

WhatsAppClient.fromEnv(env?)

Lee estas variables:

• WHATSAPP_DATA_TOKEN
• WHATSAPP_DATA_PHONEID
• WHATSAPP_DATA_VERSION

client.sendAlertaBuzonExperiencia({ to, folio, location, message, templateName?, languageCode? })

Construye el payload del template alertabuzonexperiencia y lo envía.

client.sendTemplate({ to, templateName, languageCode?, bodyParameters? })

Envía cualquier template basado en body parameters.

buildAlertaBuzonExperienciaPayload(...)

Devuelve el payload sin enviarlo.

sanitizeMessage(message, { maxLength? })

Quita saltos de línea, tabs, puntos y recorta a 190 caracteres por defecto.

Ejecutar pruebas

npm test

Publicar en npm

npm login
npm publish

Antes de publicar, verifica que el nombre whatsapp-template-client esté disponible en npm.