Documentacion KSIDol > Modulos KSIDol > WhatsApp (KsiWhatsapp)
Guia del modulo: WhatsApp (KsiWhatsapp)
Guía de uso no técnica: para qué sirve el módulo, cómo utilizarlo y cómo se articula con Dolibarr.
Objetos cubiertosPresupuestos, pedidos, facturas
CanalWhatsApp Web
Formulario de envío100 % nativo Dolibarr
CompatibilidadDolibarr 24.0
1. Descripcion del modulo
El módulo WhatsApp añade un botón « Enviar por WhatsApp » en las fichas de los presupuestos, de los pedidos de clientes y de las facturas validadas. Reutiliza exactamente el formulario nativo « Enviar por correo » de Dolibarr: los destinatarios, las plantillas de correo y los adjuntos siguen siendo los de Dolibarr, nada se reimplementa. Un segundo botón, añadido dentro de ese formulario, transforma el mensaje redactado — asunto, cuerpo convertido en texto sin formato y enlace de descarga público del PDF — en un enlace de WhatsApp Web abierto en una nueva pestaña. El envío sigue siendo completamente manual y no se apoya en ningún servicio externo: sin API de WhatsApp Business, sin cuenta de terceros, sin clave.
- Un botón « Enviar por WhatsApp » aparece junto a los botones de acción nativos de los presupuestos, pedidos de clientes y facturas.
- El formulario de envío es 100 % nativo Dolibarr: el módulo no modifica nada en él, solo le añade un botón suplementario.
- El mensaje de WhatsApp retoma el asunto y el cuerpo redactados en el formulario (plantillas de correo nativas incluidas), convertidos en texto sin formato, seguidos de un enlace de descarga del documento PDF.
- WhatsApp Web se abre en una nueva pestaña con el mensaje precumplimentado: es el usuario quien desencadena el envío, nada es automático.
- Ninguna API de WhatsApp Business, ninguna cuenta de terceros, ninguna clave: cero servicios externos.
2. Instalación y activación
La instalación sigue el circuito habitual de los módulos Dolibarr; la activación prepara automáticamente todo lo necesario para el funcionamiento del enlace de descarga.
- Descomprimir el archivo del módulo en el directorio htdocs/custom/ de Dolibarr.
- Activar el módulo « KsiWhatsapp » en Configuración → Módulos/Aplicaciones.
- El módulo nativo « Redes sociales » se activa automáticamente: es él quien lleva el campo WhatsApp de la ficha del tercero.
- La entrada « whatsapp » del diccionario de redes sociales se crea o se reactiva si hace falta.
- En la activación se establecen las tres autorizaciones de descarga externa (facturas, propuestas comerciales, pedidos): son necesarias para el enlace público adjunto al mensaje.
- El módulo no crea ningún menú: la configuración se abre con el engranaje de la línea del módulo, en la lista de módulos (acceso de administrador).
3. Configuración
La página de configuración agrupa cuatro ajustes, todos precumplimentados al activar el módulo.
- « URL de WhatsApp Web »: la dirección utilizada para redactar el mensaje (por defecto https://web.whatsapp.com/send?).
- « Permitir la descarga externa de facturas »: necesario para que el enlace enviado por WhatsApp permita descargar la factura.
- « Permitir la descarga externa de presupuestos »: necesario para que el enlace enviado por WhatsApp permita descargar el presupuesto.
- « Permitir la descarga externa de pedidos »: necesario para que el enlace enviado por WhatsApp permita descargar el pedido.
4. Uso diario
El botón « Enviar por WhatsApp » aparece en la ficha del objeto en las mismas condiciones que el botón nativo de envío por correo electrónico: estado adecuado y permisos de envío respetados.
- Facturas: botón mostrado en una factura validada o pagada; los abonos quedan excluidos.
- Presupuestos: botón mostrado en un presupuesto validado o firmado.
- Pedidos de clientes: botón mostrado en un pedido validado o aceptado.
- Los permisos de envío nativos de Dolibarr se respetan: un usuario que no puede enviar el objeto por correo electrónico tampoco puede enviarlo por WhatsApp.
- Si no se encuentra ningún número utilizable, el botón se muestra desactivado, como el botón nativo cuando el tercero no tiene dirección de correo electrónico.
- Desarrollo: hacer clic en « Enviar por WhatsApp » abre el formulario de envío nativo; elegir si se desea una plantilla de correo, ajustar el asunto y el mensaje, y hacer clic en el segundo botón « Enviar por WhatsApp »: WhatsApp Web se abre en una nueva pestaña con el mensaje y el enlace de descarga.
- El botón sigue presente tras aplicar una plantilla de correo o añadir un adjunto en el formulario.
5. Número de destino
El módulo busca el mejor número disponible y lo normaliza antes de componer el enlace de WhatsApp.
- Orden de búsqueda: campo WhatsApp de la pestaña Redes sociales del tercero, después los teléfonos del tercero (móvil, fijo, personal), y por último los teléfonos que lleva el propio documento.
- El número elegido se normaliza en cifras: solo se aceptan los números de 8 a 15 cifras.
- Recomendación: introducir los números en formato internacional (+34…); sin el módulo KSI SendSMS, no se añade automáticamente ningún prefijo.
- Si el módulo KSI SendSMS está instalado, el prefijo internacional se completa automáticamente.
6. Enlace de descarga del documento
El mensaje de WhatsApp termina con un enlace que permite al destinatario descargar el PDF del documento.
- El enlace reutiliza el enlace de compartición pública del PDF ya generado, tal como existe en la GED de Dolibarr.
- Si el PDF aún no existe o no tiene enlace de compartición, el mensaje sale sin enlace: genere el documento antes del envío.
- Las tres autorizaciones de descarga externa establecidas en la activación permiten al destinatario descargar el documento desde ese enlace.
7. Preguntas frecuentes
Las respuestas a las preguntas más habituales sobre el funcionamiento del módulo.
- ¿El envío es automático? No: el módulo prepara el mensaje y abre WhatsApp Web; el envío se hace siempre manualmente.
- ¿El PDF va adjunto al mensaje? No: el mensaje contiene un enlace de descarga del documento.
- ¿Por qué el botón está desactivado o ausente? Desactivado: no se ha encontrado ningún número utilizable en el tercero o en el documento. Ausente: el estado del documento no permite el envío, o el usuario no tiene permiso para enviar.
- ¿Los abonos están cubiertos? No, los abonos quedan excluidos.
- ¿El módulo modifica el formulario de envío nativo? No: solo le añade un botón; destinatarios, plantillas de correo y adjuntos siguen gestionados por Dolibarr.
8. Requisitos previos
Los elementos necesarios para el funcionamiento del módulo.
- Dolibarr 24.0.
- PHP 8.1.
- Módulo nativo « Redes sociales » (activado automáticamente con el módulo).
- Módulos Facturas, Presupuestos y/o Pedidos según el uso deseado.
- JavaScript activado en el navegador (el botón añadido al formulario de envío depende de él).
9. Vinculos con Dolibarr
El modulo no funciona de forma aislada: se integra con los bloques nativos de Dolibarr.
- Terceros (redes sociales y teléfonos) : El número de destino procede en primer lugar del campo WhatsApp de la pestaña Redes sociales de la ficha del tercero, después de los teléfonos del tercero (móvil, fijo, personal) y, por último, de los que lleva el documento.
- Facturas, presupuestos y pedidos de clientes : El botón « Enviar por WhatsApp » se añade en las fichas de esos tres objetos, en las mismas condiciones de estado y de permisos que el botón nativo de envío por correo electrónico; los abonos quedan excluidos.
- Formulario de envío por correo y plantillas : El módulo reutiliza el formulario nativo « Enviar por correo » de Dolibarr, con sus destinatarios, sus plantillas de correo y sus adjuntos, sin modificarlo: solo le añade un botón suplementario.
- Documentos (GED) : El enlace de descarga del mensaje se apoya en el enlace de compartición pública del PDF ya generado y registrado en la GED de Dolibarr.
- Módulo Redes sociales : Dependencia nativa del módulo, activada automáticamente: lleva el campo WhatsApp de la ficha del tercero y el diccionario de redes sociales, cuya entrada « whatsapp » queda garantizada en la activación.
- Multientidad : La compartimentación multientidad se respeta: el botón solo actúa sobre los documentos de la entidad actual y el enlace de descarga se construye a partir del directorio de documentos de la entidad del objeto.
