Instalación WhatsappWidget
🎯 Funciones principales
Limpia automáticamente el número (espacios / guiones / paréntesis / puntos).
Detecta país y aplica prefijo internacional correcto.
Botón directo a WhatsApp Click-To-Chat.
Compatible con WhatsApp normal y Business.
No usa API oficial → no requiere altas / keys / proveedores externos.
Al instalar el plugin se actualizan / sincronizan los códigos telefónicos internacionales en la tabla de países de FacturaScripts automáticamente. (esto evita tener datos incompletos y garantiza funcionalidad correcta del widget)
📦 Requisitos
FacturaScripts 2025
PHP 8.0+
Navegadores modernos (Chrome / Edge / Firefox / Safari)
Tener instalado e iniciar sesión en la app oficial de whatsapp, whatsapp Business o bien en la web de whatsapp.
Cuando el navegador pregunta con qué aplicación abrir el enlace, configurarlo para que ejecute alguna de las anteriores.
⚙️ Instalación
Copia plugin en la carpeta: /Plugins/ o usa el instalador de FacturaSript
Activa plugin en Panel → Plugins
Ya aparece el widget automático donde haya teléfono móvil
(info técnica interna) durante instalación se ejecuta la inserción/actualización de prefijos telefónicos país.
🧾 Uso
Cuando edites o visualices teléfonos móviles en:
clientes
contactos
proveedores
verás el botón WhatsApp al lado del número.
Cuando lo pulses → abre WhatsApp Web o App (depende del dispositivo).
(si no hay teléfono guardado en el campo no aparecerá el enlace)
En documentos de venta, presupuestos, pedidos, albaranes, facturas
Si hay teléfono guardado en el campo telefono1 o teléfono2 de la ficha de cliente aparecerá el botón de enviar whatsapp, si no aparecerá un botón rojo indicando que el cliente no tiene teléfonos registrados.
⚠️ Limitaciones conocidas
Si el país no tiene prefijo definido en la tabla PAIS → no se genera el link.
Si el número no es móvil válido → no genera el botón.
Algunas veces WhatsApp móvil no refresca el objetivo de la conversación correctamente si ya está abierto en background. Si esto ocurre, cierre la app y vuelva a pulsar el enlace. Esto es un comportamiento propio de WhatsApp, no del plugin.