Plantillas de Mensajes

ALTUM ERP incluye cuatro plantillas de mensajes de WhatsApp predefinidas, una por cada tipo de documento que puede enviarse a los clientes. Para que funcionen, cada plantilla debe estar aprobada en su cuenta de Meta y su nombre registrado en la configuración de WhatsApp.

Requisitos previos

• Plantillas de mensaje aprobadas en la Meta Business Suite con los parámetros correspondientes.
• Acceso a la pestaña Configuración de WhatsApp Business con el permiso whatsapp.configurar.

Plantillas disponibles

ALTUM ERP soporta exactamente los siguientes cuatro tipos de mensaje:

1. Factura (FACTURA)

Envía un CFDI timbrado al cliente con un enlace al PDF del comprobante.

Parámetros que se insertan en la plantilla:

Parámetro	Descripción
folio	Folio del CFDI, incluyendo la serie si aplica (ejemplo: A-0001).
total	Monto total del comprobante con dos decimales (ejemplo: 1500.00).
pdfUrl	URL del PDF del CFDI generado.

Cuándo se usa: Al timbrar un CFDI, desde la acción “Enviar por WhatsApp” en el módulo de facturación.

2. Ticket (TICKET)

Envía el comprobante de una venta en punto de venta.

Parámetros que se insertan en la plantilla:

Parámetro	Descripción
folio	Folio de la venta (ejemplo: V-001).
total	Monto total de la venta con dos decimales.

Cuándo se usa: Al finalizar una venta en el POS, desde la acción “Enviar ticket por WhatsApp”.

Nota

El tipo Ticket es el único que no requiere que el cliente tenga habilitado el opt-in de WhatsApp. Es un mensaje transaccional de la venta.

3. Cotización (COTIZACION)

Envía una cotización con su monto y fecha de vencimiento.

Parámetros que se insertan en la plantilla:

Parámetro	Descripción
folio	Folio de la cotización.
total	Monto total de la cotización con dos decimales.
vigenciaHasta	Fecha de vencimiento de la cotización en formato dd/mm/aaaa (calculada a 30 días desde la creación).

Cuándo se usa: Desde el detalle de una cotización en el módulo de Ventas.

4. Recordatorio de Pago (RECORDATORIO_PAGO)

Envía un aviso al cliente con el saldo pendiente de sus facturas vigentes.

Parámetros que se insertan en la plantilla:

Parámetro	Descripción
clienteNombre	Razón social del cliente.
saldoPendiente	Suma del saldo sin pagar de hasta 5 facturas vigentes con dos decimales.
facturasFolio	Lista de folios de las facturas con saldo pendiente, separados por comas.

Cuándo se usa: Desde el módulo de Cobranza o al enviar un recordatorio manual desde el perfil del cliente.

Configurar el ID de plantilla en ALTUM ERP

En la pestaña Configuración de WhatsApp Business, la sección Plantillas muestra un campo de texto para cada tipo de mensaje:

Campo	Plantilla correspondiente
Plantilla Factura	Nombre o ID de la plantilla FACTURA aprobada en Meta.
Plantilla Ticket	Nombre o ID de la plantilla TICKET aprobada en Meta.
Plantilla Cotización	Nombre o ID de la plantilla COTIZACION aprobada en Meta.
Plantilla Recordatorio de Pago	Nombre o ID de la plantilla RECORDATORIO_PAGO aprobada en Meta.

Si un campo queda vacío, el intento de envío del tipo de mensaje correspondiente fallará con el error “Template no configurado para tipo de mensaje”.

Reglas y validaciones

• Los cuatro tipos de mensaje son los únicos soportados; no es posible crear tipos personalizados desde la interfaz.
• Los parámetros se envían a la API de Meta en el orden listado arriba para cada tipo. Su plantilla en Meta debe estar configurada con el mismo número de parámetros en el mismo orden.
• El campo vigenciaHasta de la cotización se calcula automáticamente sumando 30 días a la fecha de creación de la cotización; no es un campo editable.
• Para el recordatorio de pago, el sistema consulta hasta 5 CFDIs vigentes del cliente con saldo pendiente; los folios se concatenan separados por comas.

Casos frecuentes

El mensaje falla con error “TEMPLATE_ERROR”. El ID de plantilla ingresado en ALTUM ERP no coincide con el nombre de la plantilla aprobada en Meta, o la plantilla fue rechazada o suspendida por Meta. Verifique el estado de la plantilla en Meta Business Suite.

El campo pdfUrl llega vacío al cliente. El CFDI debe tener un PDF generado antes de enviarse por WhatsApp. Asegúrese de que el proceso de timbrado haya completado la generación del PDF.

El recordatorio de pago no muestra facturas. El sistema busca CFDIs en estado VIGENTE del cliente. Si el cliente no tiene facturas vigentes con saldo pendiente, los campos saldoPendiente y facturasFolio quedarán en 0.00 y N/A respectivamente.