• FacturaWhatsApp: documentación, configuración y manual de uso

FacturaWhatsApp: documentación, configuración y manual de uso

FacturaWhatsApp — Manual de uso

Envía facturas, presupuestos, albaranes y pedidos en PDF por WhatsApp desde FacturaScripts, con la API Cloud oficial de Meta y sin intermediarios.

1. Requisitos previos

• FacturaScripts 2026+ y PHP 8.1+.
• Una cuenta de Meta Business con un número de WhatsApp Business verificado.
• Del panel de Meta para desarrolladores necesitas: Token de acceso, Phone Number ID y, opcionalmente, el WhatsApp Business Account ID.
• Plantillas de mensaje aprobadas por Meta con una cabecera de tipo documento (una por cada tipo de documento que quieras enviar).

2. Instalación

1. Panel de control → Plugins → Añadir, sube el ZIP y pulsa Activar. Reconstruye si se solicita.
2. Aparecen la pestaña de ajustes FacturaWhatsApp (Panel de control) y el menú Historial de envíos WhatsApp (Administrador).

3. Configuración (Panel de control → FacturaWhatsApp)

• Credenciales API Meta: token (campo oculto), Phone Number ID y Business Account ID.
• Plantillas de mensaje: nombre de la plantilla aprobada para factura, presupuesto, albarán y pedido, y el idioma de la plantilla (por ejemplo, es).
• Configuración regional: prefijo telefónico por defecto (por ejemplo, +34).
• Pulsa Probar conexión para validar el token y el Phone Number ID contra Meta.

4. Enviar un documento por WhatsApp (paso a paso)

1. Abre la ficha de una factura (o presupuesto, albarán, pedido).
2. Pulsa el botón verde Enviar por WhatsApp (solo aparece si las credenciales están configuradas).
3. Se abre la página de envío con el teléfono del cliente ya rellenado; revísalo o corrígelo.
4. Confirma. El plugin genera el PDF, lo sube a Meta y envía la plantilla con el documento adjunto.
5. El resultado (enviado/error) queda registrado.

5. Historial de envíos

Cada documento muestra una pestaña Historial de envíos WhatsApp con sus envíos. El listado central (Historial de envíos WhatsApp, en Administrador) reúne todos los envíos con semáforo de estado y filtros por estado, tipo de documento y fecha.

6. Normalización del teléfono

El número se limpia automáticamente (sin espacios ni signos) y, si no empieza por "+", se le antepone el prefijo por defecto configurado.

7. Seguridad

El token nunca se muestra en pantalla ni se guarda en los registros (se enmascara). Todas las llamadas usan HTTPS con verificación TLS y tiempos de espera.

8. Notas

• WhatsApp solo permite enviar plantillas aprobadas fuera de la ventana de 24 h; por eso el envío usa plantillas con cabecera de documento.
• Si un envío falla, revisa el historial: se guarda la respuesta de la API (sin el token) para diagnosticar.

9. Soporte

soporte@adelantia.com — YAST TELECOM SL.