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).

⚠️ 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.