Documentacion KSIDol > Modulos KSIDol > Envío de SMS

Guia del modulo: Envío de SMS

Guía de uso no técnica: para qué sirve el módulo, cómo utilizarlo y cómo se articula con Dolibarr.

Proveedor de SMSOVH SMS (API)

Fichas de Dolibarr conectadas15+ tipos

Variables de personalización~150

Seguimiento de envíos5 estados + agenda

1. Descripcion del modulo

El módulo Envío de SMS añade a Dolibarr la posibilidad de enviar SMS a sus clientes, prospectos, contactos y proveedores, directamente desde las fichas que consulta a diario (tercero, presupuesto, pedido, factura, intervención, contrato, expedición, socio...). En estas fichas aparece un botón "Enviar un SMS": abre un formulario precompletado con el nombre y el número de teléfono del destinatario, sin volver a teclear. Los mensajes se envían a través de la API de SMS de OVH, con su nombre de remitente validado. El módulo se apoya por completo en los datos nativos de Dolibarr: recupera los datos de contacto de terceros y contactos, las referencias e importes de los documentos, y registra cada envío en la agenda para dejar constancia. También ofrece plantillas de SMS reutilizables, variables que se rellenan automáticamente (nombre, referencia, importe, fechas, enlaces de descarga...), un seguimiento completo de los envíos y una gestión de cuota de SMS por usuario.

Envío de SMS desde las fichas de Dolibarr (botón + ventana integrada) o desde un menú dedicado
Número y nombre del destinatario recuperados automáticamente desde la ficha
Plantillas de SMS con variables que se rellenan solas (cliente, referencia, importe, fechas, enlaces de documento)
Vista previa en tiempo real, contador de caracteres/segmentos y modo de prueba antes del envío real
Seguimiento de todos los envíos con estado (enviado, en cola, fallido, prueba) y posibilidad de reenviar
Cuota de SMS por usuario y alertas automáticas cuando el stock se vuelve bajo
Cada envío queda registrado en la agenda de Dolibarr, vinculado al cliente y al documento correspondiente

2. Enviar un SMS desde una ficha o el menú

Es la función principal. Se añade un botón "Enviar un SMS" en las fichas correspondientes (tercero, presupuesto, pedido, factura, intervención, contrato, expedición, socio, contacto, así como pedidos, facturas y propuestas de proveedor). También existe un menú dedicado "Enviar SMS" para redactar un mensaje libre.

Desde una ficha, el formulario se abre en una ventana desplazable y redimensionable, con el nombre y el teléfono ya rellenados
El número puede corregirse o introducirse a mano (formato internacional, p. ej. +336...)
Zona de mensaje con contador de caracteres y número de segmentos SMS
Vista previa del mensaje mostrada en directo, teniendo en cuenta las variables sustituidas
Botón de envío y visualización inmediata de un mensaje de confirmación o de error
Menú "Enviar SMS" para un envío fuera de documento (mensaje puntual)

3. Plantillas de SMS reutilizables

El módulo permite crear una biblioteca de plantillas de mensajes, para no volver a escribir los textos recurrentes (recordatorio de cita, información de entrega, seguimiento, etc.). Las plantillas se gestionan en el menú "Plantillas de SMS".

Crear, modificar, activar/desactivar y eliminar plantillas
Cada plantilla tiene un código, una etiqueta, un contenido y un tipo (genérico o vinculado a un documento: presupuesto, pedido, factura, intervención, proveedor...)
En el formulario de envío, se elige una plantilla de una lista y se aplica con un clic
Función "Probar": generar una vista previa de la plantilla a partir de un objeto real (indicando su identificador) para verificar el resultado antes de usarla
Solo se ofrecen para el envío las plantillas activas y compatibles con el tipo de ficha

4. Personalización automática (variables)

Las plantillas y los mensajes pueden contener variables que se sustituyen automáticamente por los datos reales en el momento del envío. El formulario muestra la lista de variables disponibles y su valor para la ficha en curso.

Datos de contacto del destinatario: nombre del tercero, nombre del contacto, teléfono
Información del documento: referencia, referencia de cliente, etiqueta, notas, fechas (creación, validación, vencimiento, entrega...)
Importes del documento: base imponible, IVA, total, importe pendiente, en cifras o en letras
Datos de su empresa (nombre, dirección, identificadores, teléfono...) y firma del usuario
Enlaces prácticos: descarga directa del documento (presupuesto, pedido, factura, contrato, intervención), enlace de firma en línea, enlace de pago en línea
Posibilidad de añadir automáticamente la firma de la empresa al final del mensaje

5. Opciones de envío avanzadas

En el momento del envío, hay disponibles varios ajustes finos para adaptarse al tipo de mensaje y a la normativa.

Prioridad del mensaje: alta, media o baja
Tipo de mensaje: transaccional (p. ej. confirmación, código) o marketing
Retardo antes del envío en minutos: OVH entrega el SMS de forma diferida
Mención STOP: para los SMS de marketing se añade la mención; puede desactivarse para los mensajes transaccionales
Remitente: nombre de remitente validado en su cuenta OVH, propuesto por defecto

6. Modo de prueba antes del envío real

El modo de prueba permite preparar y verificar un SMS sin que se envíe ni se facture realmente ningún mensaje. Útil para validar una plantilla o un formato.

Interruptor "Modo de prueba" en el formulario de envío (activable por defecto en la configuración)
Un banner de advertencia recuerda que no se entregará ningún SMS
El mensaje de prueba se registra en el seguimiento con el estado "Prueba" y no consume cuota
También se crea un evento en la agenda para dejar constancia de la prueba

7. Seguimiento de envíos (historial)

El menú "Seguimiento de envíos" enumera todos los SMS procesados, con su estado y su contenido, para un control completo.

Columnas: fecha, destinatario, remitente, estado, contexto (tipo de ficha), mensaje y acciones
Estados gestionados: Nuevo, En cola, Enviado, Fallido, Prueba
Filtros por estado, por contexto (cliente, presupuesto, pedido, factura...) y búsqueda libre (contenido, destinatario, remitente)
En caso de fallo, se muestra el mensaje de error devuelto por OVH
Acción "Enviar" para reintentar un SMS en cola, fallido o nuevo
Acción "Eliminar" para retirar una línea del historial
Recordatorio de las opciones utilizadas (prioridad, tipo, retardo, STOP) bajo cada mensaje

8. Cuotas por usuario y alertas de stock

El módulo permite asignar una cuota de SMS a cada usuario y vigilar el crédito restante, tanto del lado de OVH como del lado del usuario.

Asignación de un número de SMS autorizados por usuario, con seguimiento de lo "utilizado" y lo "disponible"
Bloqueo del envío cuando la cuota del usuario se agota, con mensaje de alerta
Insignia que muestra los SMS restantes en las páginas de envío y de configuración
Alerta visual (tarjeta + punto en el menú superior) cuando el stock baja de un umbral configurable
Enlace de pedido de SMS mostrado al usuario para recargar crédito
Control de desviación entre el crédito real de la cuenta OVH y el total de las cuotas asignadas

9. Configuración y herramientas de administración

La página de configuración (reservada a los administradores) centraliza la conexión con OVH y los ajustes por defecto. También ofrece herramientas de verificación.

Conexión OVH SMS: endpoint, Application Key, Application Secret, Consumer Key y servicio (sms-XXXXX), con un botón de ayuda para generar la clave de acceso de OVH
Gestión del prefijo de país: detección automática, adición sistemática del prefijo por defecto o ninguna modificación
Valores por defecto: modo de prueba, prioridad, tipo, retardo, mención STOP, remitente por defecto
Visualización del crédito de SMS disponible en la cuenta OVH
URL de recompra de SMS y umbral de alerta de stock
Herramienta "Probar la configuración" (diagnóstico de endpoint, credenciales, servicio, acceso API, tablas)
Herramienta "Reiniciar el módulo" para empezar de cero en la entidad actual (datos y parámetros)

10. Vinculos con Dolibarr

El modulo no funciona de forma aislada: se integra con los bloques nativos de Dolibarr.

Terceros y contactos : El módulo lee el nombre y el número de teléfono (móvil con prioridad) del tercero o del contacto para precompletar el envío. Se añade un botón SMS en las fichas de tercero y de contacto, y el cliente queda vinculado al evento de agenda creado.
Presupuestos, pedidos y facturas de cliente : Aparece un botón SMS en las fichas de propuestas comerciales, pedidos y facturas. Las variables recuperan la referencia, las fechas y los importes (base imponible, IVA, total, pendiente) del documento, y pueden insertar un enlace de descarga directa, un enlace de firma en línea o un enlace de pago en línea.
Intervenciones, contratos y expediciones : Las fichas de intervención, contrato y expedición/entrega también disponen del botón SMS, con recuperación del cliente y de sus datos de contacto y enlace de descarga del documento cuando existe.
Documentos de proveedor : El módulo se añade igualmente a los pedidos, facturas y propuestas de proveedor, recuperando el tercero proveedor y las referencias correspondientes.
Agenda (eventos) : Cada SMS (enviado, fallido o de prueba) genera automáticamente un evento en la agenda de Dolibarr, vinculado al cliente, al contacto, al documento de origen y al proyecto en su caso, con el estado, el remitente y un extracto del mensaje.
Socios : Las fichas de socio están soportadas: envío de SMS a un miembro, con vinculación a su empresa asociada si existe.
Documentos, firma y pago en línea : Las variables pueden insertar enlaces de descarga directa de los documentos PDF, así como los enlaces nativos de firma en línea y de pago en línea generados por Dolibarr.
Empresa emisora y usuarios : Los datos de su empresa (menciones legales, dirección, identificadores) y la firma del usuario conectado alimentan las variables y la firma añadida al SMS; las cuotas de envío se gestionan por usuario de Dolibarr.