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

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

Guía de uso de FacturaWhatsApp

FacturaWhatsApp permite enviar tus facturas, presupuestos, albaranes y pedidos de cliente en PDF directamente por WhatsApp, usando la API Cloud oficial de Meta (sin intermediarios). Añade un botón de envío en la ficha de cada documento y guarda un historial de todos los envíos. Está pensado para cualquier empresa que ya use FacturaScripts y quiera hacer llegar sus documentos a los clientes de forma rápida por WhatsApp.

1. Instalación

1. Descarga el ZIP de FacturaWhatsApp.
2. En FacturaScripts, ve a Administrador → Plugins, pulsa Añadir y sube el ZIP.
3. Actívalo y pulsa Reconstruir.

Requisitos: FacturaScripts 2026 o superior y PHP 8.1+. Necesitas una cuenta de Meta Business con un número de WhatsApp verificado y las plantillas de mensaje aprobadas por Meta.

2. Configuración inicial

El plugin añade una pestaña de configuración dentro de los ajustes de FacturaScripts.

1. Ve a Administrador → Panel de control (Ajustes) y abre la pestaña Configuración WhatsApp.
2. En Credenciales API Meta rellena:

• Token de acceso API Meta: el token permanente de tu app de Meta.
• Phone Number ID: identificador del número de WhatsApp.
• WhatsApp Business Account ID: identificador de tu cuenta de WhatsApp Business.

1. En Plantillas de mensaje indica el Nombre de plantilla que usarás para cada tipo de documento (factura, presupuesto, albarán y pedido). Deben coincidir con plantillas ya aprobadas en Meta.
2. En Configuración regional define el Prefijo telefónico por defecto (por ejemplo, +34) que se antepone a los números sin prefijo.
3. Guarda y pulsa Probar conexión. Verás "Conexión con la API de Meta correcta." si todo está bien, o un mensaje de error si el token o el Phone ID no son válidos.

3. Enviar un documento por WhatsApp

1. Abre la ficha de una factura, presupuesto, albarán o pedido de cliente (menú Ventas).
2. Pulsa el botón Enviar por WhatsApp.
3. Se abre la pantalla de envío mostrando el documento y el Número de teléfono WhatsApp del cliente. Revisa que el número sea correcto.
4. Confirma el envío. El plugin genera el PDF, lo sube a Meta y envía la plantilla de WhatsApp.
5. Si todo va bien verás "Documento enviado correctamente por WhatsApp."; si falla, un aviso te remite al historial.

4. Historial de envíos

1. Ve a Administrador → Historial de envíos WhatsApp.
2. Verás el listado de todos los envíos con un semáforo de estado: Enviado, Error o Pendiente.
3. Puedes buscar por número de documento, nombre del contacto o teléfono, y filtrar por:

• Estado (enviado / error / pendiente).
• Tipo de documento (factura, presupuesto, albarán, pedido).
• Rango de fechas (desde / hasta).

Este historial es útil para comprobar qué documentos se han entregado y localizar los envíos con error para reintentarlos.

Preguntas frecuentes

No veo el botón ni el menú del plugin. Ve a Administrador → Plugins, confirma que FacturaWhatsApp está activo y pulsa Reconstruir.

Al probar la conexión sale "Error de conexión: token o Phone ID incorrecto o no configurado." Revisa el Token de acceso, el Phone Number ID y el WhatsApp Business Account ID en la pestaña Configuración WhatsApp.

El envío falla aunque la conexión es correcta. Comprueba que el nombre de la plantilla coincide exactamente con una plantilla aprobada en Meta y que el número del cliente incluye prefijo válido.

¿Puedo enviar a un número sin prefijo internacional? Sí, se le añade automáticamente el prefijo telefónico por defecto que hayas configurado.

Soporte: soporte@adelantia.com