• Guía de uso WhatsAppFS
• ¿Qué hace este plugin?

Guía de uso WhatsAppFS

Plugin para FacturaScripts que envía notificaciones automáticas por WhatsApp a tus clientes y a tu propio teléfono usando la API oficial de Meta (WhatsApp Business Cloud API).

1. Qué hace y qué no hace Qué hace

Envía mensajes de WhatsApp a tus clientes cuando ocurre un evento en FacturaScripts (factura emitida, presupuesto, pedido, cobro de recibo). Te avisa a ti (administrador) en tu propio WhatsApp cada vez que sucede algo importante. Manda un resumen diario de los recibos vencidos sin pagar. Permite recordatorios masivos de pago seleccionando cuáles enviar. Lleva un registro completo de cada mensaje enviado, con su estado.

Qué no hace

No envía mensajes a clientes sin teléfono guardado (los omite en silencio). No envía SMS, solo WhatsApp. No recibe respuestas de los clientes ni gestiona conversaciones bidireccionales (es solo salida). No reemplaza tu cuenta de WhatsApp personal: usa una línea de WhatsApp Business dedicada que tú configuras en Meta.

2. Requisitos previos

FacturaScripts versión 2025 o superior. Una cuenta de Meta for Developers (developers.facebook.com). Una app de Meta con WhatsApp Business activado y una línea (Phone Number) configurada. Un Access Token permanente.

El tramo gratuito de la API de Meta cubre con holgura el uso típico de una PYME. Consulta los precios actuales en la web de Meta si vas a enviar grandes volúmenes.

3. Instalación

Entra en FacturaScripts como administrador. Ve a Administración → Plugins. Pulsa "Subir plugin" y selecciona el archivo WhatsAppFS.zip. Activa el plugin con el botón de encendido. Pulsa "Desplegar cambios" si te lo pide. Refresca el navegador (Ctrl+F5).

Si actualizas desde una versión anterior: borra la caché en Panel de control → Avanzado → Limpiar caché, o borra manualmente el contenido de MyFiles/Cache/ y MyFiles/Tmp/.

4. Obtener las credenciales de Meta (paso a paso) Esto solo se hace una vez. Si ya tienes Phone Number ID y Access Token, pasa al punto 5.

Entra en developers.facebook.com con tu cuenta de Facebook. Crea una app: Mis Apps → Crear App → Empresa → WhatsApp. En el panel de la app, en la barra lateral, abre WhatsApp → Configuración de la API. Verás un número de prueba que Meta te ha asignado. Apunta el Phone Number ID (es un número largo bajo el desplegable de números). Más abajo, en "Generar token de acceso", copia el token temporal. Para producción, conviene generar un token permanente siguiendo las instrucciones de Meta (User Access Token o System User Access Token). Verifica un número propio si quieres salir del entorno de prueba (sandbox) y poder enviar a cualquier teléfono. En sandbox solo puedes enviar a números registrados como "testers".

5. Configuración inicial del plugin

En FacturaScripts, abre Ventas → WhatsApp FS (icono verde de WhatsApp en el menú). En la tarjeta "Conexión WhatsApp Business":

Pega el Phone Number ID en el primer campo. Pega el Access Token en el segundo.

En la tarjeta "Teléfono del administrador":

Introduce tu número en formato internacional, por ejemplo +34666123456. Si solo pones los 9 dígitos españoles, se añade el prefijo 34 automáticamente. Pulsa Enviar mensaje de prueba. Si todo está bien, recibes un WhatsApp inmediatamente. Si no, el panel muestra el error de la API y puedes corregir.

Pulsa Guardar configuración abajo del todo.

6. Configurar qué notificaciones quieres En la tarjeta "Notificaciones automáticas por evento" tienes una tabla con cinco eventos. Para cada uno hay dos interruptores: Avisar admin y Avisar cliente. Activa los que quieras según tu caso. Algunos ejemplos típicos:

Solo quiero saber yo lo que pasa, sin que el cliente reciba nada: activa la columna "Avisar admin" en todos los eventos, deja "Avisar cliente" desactivada. Quiero que el cliente reciba confirmación de factura y de cobro, y yo solo enterarme cuando hay morosos: activa "Avisar cliente" en Nueva factura y Recibo pagado, y "Avisar admin" únicamente en Resumen diario de recibos vencidos. Quiero ambos para todo: activa las dos columnas en todos los eventos.

Eventos disponibles EventoCuándo se disparaNueva factura emitidaAl crear/guardar una FacturaClienteRecibo pagadoCuando un recibo pasa de pendiente a pagadoResumen diario de recibos vencidosUna vez al día (CRON), si hay morososNuevo presupuestoAl crear/guardar un PresupuestoClienteNuevo pedidoAl crear/guardar un PedidoCliente Editar las plantillas Pulsa el icono del lápiz a la derecha de cada evento para abrir el editor. Tienes dos cajas de texto:

Plantilla admin: el texto que tú recibes. Suele ser corto y técnico ("Factura F-2026/001 emitida a Cliente X por 1.234€"). Plantilla cliente: el texto que recibe el cliente. Suele ser más cálido y firmado por la empresa.

Cada plantilla puede usar variables entre dobles llaves, como {{nombre}} o {{total}}. Debajo de cada editor tienes la lista exacta de variables disponibles para ese evento. Cualquier {{variable}} que no exista para ese evento se quedará tal cual en el mensaje, así que cuidado al copiar plantillas entre eventos.

Recomendación: usa siempre {{empresa}} al final de los mensajes al cliente para que sepa quién le escribe, ya que la línea de WhatsApp Business se muestra con el nombre del perfil que hayas configurado en Meta.

Cuando termines, pulsa Guardar configuración.

7. Uso diario 7.1 Notificaciones automáticas Una vez configuradas, no tienes que hacer nada. Cada vez que en FacturaScripts ocurre uno de los eventos activados, el plugin envía los WhatsApp correspondientes en segundo plano. Si el cliente no tiene teléfono guardado en su ficha, se omite sin error. El envío queda registrado en el histórico. 7.2 Envío rápido manual En la columna izquierda, tarjeta verde "Envío rápido":

Escribe el teléfono (con o sin prefijo). Opcionalmente, un nombre para identificarlo en el histórico. Escribe el mensaje libre. Pulsa Enviar.

Útil para mandar un mensaje puntual a alguien que no está como cliente, o para enviar información extra fuera de los eventos automáticos. 7.3 Recordatorios masivos de impagos En la columna derecha, tarjeta "Recordatorios de pago pendientes":

La tabla muestra los recibos vencidos sin pagar, ordenados por días de vencimiento. Los clientes sin teléfono aparecen con el icono de teléfono tachado y su casilla deshabilitada. Marca los recibos a los que quieres enviar recordatorio (o usa la casilla del encabezado para todos). Pulsa Enviar recordatorios seleccionados.

El plugin enviará un mensaje a cada cliente con el texto definido en la plantilla "cliente" del evento "Resumen diario de recibos vencidos" (con sus variables {{nombre}}, {{importe}}, {{vencimiento}}, {{dias_vencido}}), respetando una pausa entre envíos para no saturar la API. 7.4 Histórico de mensajes Pestaña Mensajes Enviados del propio panel. Verás:

Fecha y hora del envío. Cliente o teléfono destinatario. Tipo de mensaje (factura, recibo_pagado, recordatorio, admin_factura_nueva, etc.). Estado: enviado, entregado, leído, error. En caso de error, el detalle del fallo devuelto por Meta.

Filtros laterales por tipo y estado para auditar fácilmente.

8. Variables disponibles por evento Nueva factura emitida {{nombre}}, {{numero_factura}}, {{fecha}}, {{total}}, {{empresa}} Recibo pagado {{nombre}}, {{importe}}, {{numero_factura}}, {{fecha}}, {{empresa}} Resumen diario de recibos vencidos (admin) {{total_vencidos}}, {{importe_total}}, {{top_clientes}}, {{empresa}} Recordatorio individual de vencido (cliente) {{nombre}}, {{importe}}, {{vencimiento}}, {{dias_vencido}}, {{empresa}} Nuevo presupuesto / Nuevo pedido {{nombre}}, {{numero}}, {{fecha}}, {{total}}, {{empresa}}

9. Resolución de problemas No recibo el mensaje de prueba al admin

Comprueba que el Access Token sea válido y que no haya expirado (los tokens temporales caducan a las 24h). Verifica que tu número esté en la lista de "testers" si tu app de Meta sigue en modo desarrollo. Revisa el histórico de mensajes: si aparece "error", el detalle te dice qué falla (token caducado, número no autorizado, etc.).

El cliente no recibe la notificación automática

Comprueba que el cliente tenga el campo telefono1 o telefono2 relleno en su ficha. Verifica que el interruptor "Avisar cliente" del evento correspondiente esté activado. En modo sandbox de Meta, solo se entregan mensajes a números registrados como testers.

Aparece un sidebar duplicado o el menú no funciona

Vacía la caché de FacturaScripts (Panel de control → Avanzado → Limpiar caché) y haz Ctrl+F5. Asegúrate de tener la versión 3 o superior del plugin.

Error "API de WhatsApp no configurada"

Vuelve a guardar la configuración asegurándote de que Phone Number ID y Access Token están rellenos.

El CRON de recibos vencidos no envía el resumen

Comprueba que FacturaScripts tenga el CRON configurado en el servidor (cron del sistema operativo o webhook). Verifica que el interruptor "Avisar admin" del evento "Resumen diario de recibos vencidos" esté activo. El resumen se envía una sola vez al día; si ya se envió hoy, no se reintentará hasta mañana.

Quiero enviar a un teléfono que no es español

Introduce el número con prefijo completo y el signo +, por ejemplo +33612345678. El plugin no añade prefijo si ya hay uno; solo añade 34 cuando detecta exactamente 9 dígitos sueltos.

10. Buenas prácticas

Personaliza las plantillas con el nombre de tu empresa y un tono cercano. La gente recibe muchos mensajes; si suena a robot, los ignoran. No actives "Avisar cliente" en Nuevo presupuesto hasta que tengas claro qué texto le mandas. Un presupuesto suele requerir contexto y un mensaje impersonal puede dar mala imagen. Empieza activando solo "Avisar admin" en todos los eventos durante una semana, para acostumbrarte al volumen y ajustar plantillas. Luego activa al cliente. Revisa el histórico al menos una vez por semana los primeros meses para detectar errores silenciosos. Guarda los Access Token en un gestor de contraseñas. Si Meta los rota, tendrás que regenerarlos.

11. Privacidad El plugin se comunica directamente con la API de Meta usando tu propio token. No hay servidores intermedios. Los mensajes y datos de tus clientes viajan únicamente entre tu instalación de FacturaScripts y los servidores de WhatsApp Business. El histórico de mensajes se almacena en tu propia base de datos de FacturaScripts (tabla whatsapp_mensajes). Si desinstalas el plugin, esa tabla se mantiene para conservar el registro; si quieres borrarla, hazlo manualmente desde tu gestor de base de datos.

12. Soporte Si encuentras un error o quieres proponer una mejora, abre un ticket en la forja de FacturaScripts indicando:

Versión de FacturaScripts. Versión del plugin (mira facturascripts.ini). Captura del error si aparece en el panel o en MyFiles/Cache/MyTools/Logs/. Pasos exactos para reproducirlo.