Módulos del sistema

Desde Configuración → Módulos se administran las extensiones que amplían el CRM sin modificar su núcleo. Esta zona reúne el catálogo de módulos instalables, el laboratorio de pruebas, las rutas públicas y la tienda.

Un módulo puede añadir pantallas, procesos, campos, automatizaciones, informes o conexiones con servicios externos. Su disponibilidad, precio, versión y dependencias dependen del catálogo y del espacio de trabajo.

Alcance de esta guía

Esta es la guía pública para administrar módulos y para entender el contrato de las extensiones externas. No incluye rutas internas, permisos técnicos, nombres de servidores, variables de entorno, credenciales ni código privado del CRM.

Para construir una extensión compatible, consulta Módulos externos.

Mapa de la zonaCopy Anchor Link

La pantalla se organiza en cuatro áreas. Cada pestaña responde a una fase distinta del trabajo con extensiones:

El CRM separa estas áreas para que instalar una extensión, desarrollarla y publicarla sean decisiones controladas. Un módulo instalado no queda necesariamente publicado en Internet, y una ruta pública no implica que toda la interfaz del módulo sea pública.

Instalar módulosCopy Anchor Link

La pestaña Instalar módulos muestra las extensiones disponibles para el espacio y permite localizar rápidamente una por su nombre o identificador público.

Buscar y revisar el catálogoCopy Anchor Link

Antes de instalar, utiliza los controles de la parte superior para:

• ordenar el catálogo, por ejemplo alfabéticamente;
• buscar por nombre o slug;
• filtrar por estado;
• elegir cuántos resultados se muestran por página;
• personalizar las columnas visibles.

Cada fila del catálogo resume la información que conviene revisar:

El catálogo puede mostrar módulos muy diferentes: blogs, gestión hipotecaria, captación de vehículos, logística, formación, soporte o planificación. Los ejemplos visibles en una cuenta no constituyen una lista cerrada de funcionalidades.

Dependencias y compatibilidadCopy Anchor Link

Algunas extensiones requieren capacidades del CRM o de otros módulos. Antes de confirmar una instalación, comprueba:

1. qué módulo base necesita;
2. qué extensiones complementarias recomienda o exige;
3. qué versión del CRM o del módulo es compatible;
4. si añade datos, rutas públicas, tareas o automatizaciones;
5. qué configuración inicial debe completar el responsable del espacio.

Instala primero las dependencias indicadas y después la extensión principal. Si el sistema no permite activar un módulo, revisa el estado de sus dependencias antes de repetir la operación.

Instalación y activaciónCopy Anchor Link

El flujo habitual es:

1. localizar el módulo en el catálogo;
2. leer su descripción, versión y dependencias;
3. seleccionar Instalar o Instalar y activar;
4. revisar el resumen de cambios y aceptar;
5. completar la configuración que solicite el módulo;
6. abrir su pantalla principal y comprobar un caso real de prueba.

Instalar incorpora el paquete al espacio. Activar hace visibles sus menús y capacidades. Si una extensión permite desactivarla, la desactivación debe entenderse como una pausa operativa: revisa siempre el aviso mostrado por el CRM antes de confirmar, porque la conservación de datos y configuración puede depender del módulo.

Prueba antes de ponerlo en producción

No actives una extensión directamente sobre procesos críticos sin probar sus pantallas, permisos funcionales, relaciones con clientes o prospectos, tareas y automatizaciones. Utiliza datos de prueba o un entorno de validación cuando el módulo vaya a modificar una operativa importante.

Actualizar módulos instaladosCopy Anchor Link

El botón Actualizar módulos instalados permite aplicar versiones nuevas y sus migraciones compatibles.

Una actualización puede:

• incorporar nuevas pantallas o acciones;
• corregir errores;
• cambiar campos o estados;
• adaptar rutas públicas;
• transformar datos existentes mediante una migración.

Antes de actualizar:

• revisa la versión disponible y sus notas de cambio;
• confirma que las dependencias siguen siendo compatibles;
• evita hacerlo durante una operación crítica;
• verifica que dispones de una copia o procedimiento de recuperación adecuado;
• prueba después las funciones que más utiliza tu equipo.

Después de actualizar, valida al menos el acceso al módulo, una creación y edición, sus relaciones con el CRM y cualquier endpoint o inserción pública que utilices.

Promocionar un ZIP al espacioCopy Anchor Link

La zona Promocionar ZIP al tenant permite incorporar al catálogo del espacio un paquete exportado desde el laboratorio o un paquete compatible aprobado para ese entorno.

El paquete debería estar versionado e incluir, como mínimo, el manifiesto del módulo, sus dependencias y los recursos que el contrato público permita distribuir. El proceso recomendado es:

1. exportar el ZIP desde el laboratorio;
2. comprobar el nombre, la versión y la procedencia del paquete;
3. subirlo mediante el área de carga;
4. seleccionar Promocionar ZIP;
5. revisar los avisos de validación;
6. instalarlo y activarlo desde el catálogo;
7. ejecutar una prueba funcional y revisar sus rutas públicas.

No subas paquetes que contengan contraseñas, tokens, claves privadas, datos reales de clientes o código que no deba distribuirse. La promoción incorpora una versión al espacio; no convierte automáticamente todas sus vistas o endpoints en públicos.

LaboratorioCopy Anchor Link

El Laboratorio es el espacio de trabajo destinado a diseñar, probar y preparar módulos antes de incorporarlos al CRM operativo. El objetivo es separar la experimentación de la instalación que utiliza el equipo.

Flujo público de trabajoCopy Anchor Link

Un ciclo de desarrollo de módulo puede seguir estas fases:

1. Definir la necesidad. Describe qué problema resuelve y qué entidad del CRM utiliza.
2. Preparar el módulo. Organiza el manifiesto, las vistas, las acciones y las rutas que formen parte de su contrato.
3. Probar en el laboratorio. Comprueba navegación, validaciones, estados, errores y comportamiento responsive.
4. Revisar la seguridad. Verifica autenticación, permisos funcionales, datos mínimos y ausencia de secretos en el paquete.
5. Exportar una versión. Genera un ZIP identificable y asociado a una versión concreta.
6. Promocionar al espacio. Sube el paquete desde la administración de módulos.
7. Instalar y validar. Comprueba la extensión en el CRM y documenta cualquier configuración necesaria.

Si el laboratorio aparece como pendiente de configurar, el puente público entre el CRM y el laboratorio todavía no está listo para ese espacio. En ese caso debe intervenir el responsable de la cuenta o el equipo que gestiona la instalación; no es necesario publicar ni solicitar al usuario final variables técnicas.

Laboratorio y producción

El laboratorio sirve para preparar una versión. La activación, los datos de negocio y la publicación de rutas se gestionan después desde el espacio correspondiente.

Qué debe probar un desarrolladorCopy Anchor Link

Antes de promocionar una extensión, verifica:

• que el manifiesto declara un identificador estable y una versión;
• que las dependencias están declaradas;
• que las pantallas tienen estados de carga, vacío y error;
• que los formularios validan los datos antes de enviarlos;
• que las acciones no duplican operaciones si se repite una petición;
• que las relaciones con clientes, prospectos, tareas o medios respetan el contexto;
• que los endpoints públicos devuelven respuestas documentadas;
• que el paquete no incluye secretos ni información privada del entorno.

Consulta la estructura de un módulo externo, la guía de endpoints públicos y las recomendaciones de seguridad.

Rutas públicas y embebidosCopy Anchor Link

La pestaña Rutas públicas y embebidos presenta el registro de endpoints que los manifiestos del catálogo han declarado para exposición externa.

Esta vista permite filtrar por módulo, endpoint o alias y revisar:

• la finalidad pública de la ruta;
• el alias que se utiliza para identificarla;
• los métodos admitidos, como GET o POST;
• si está publicada;
• si dispone de modo embebible;
• la URL pública generada por el CRM;
• si puede probarse desde la propia pantalla.

La información se sincroniza desde los manifiestos. Por ello, si una ruta no aparece, revisa primero la versión instalada y la declaración pública del módulo.

Publicación y embebidoCopy Anchor Link

Una ruta puede estar instalada pero no publicada. También puede estar publicada sin permitir iframe. Son controles independientes:

El botón de prueba sirve para comprobar una ruta de forma rápida. No sustituye a las pruebas de autenticación, validación, límites de uso y tratamiento de errores que debe realizar el integrador.

Para la integración, utiliza siempre el contrato publicado del módulo y no dependas de rutas internas, nombres de archivos, tablas o sesiones del CRM. Consulta Endpoints públicos y Webhooks e integraciones.

No publiques datos por accidente

Revisa el contenido de cada respuesta antes de publicar una ruta. Un endpoint público debe devolver únicamente los datos necesarios para su finalidad y nunca credenciales, identificadores internos sensibles, registros de otros espacios o información personal que no corresponda.

Tienda de módulosCopy Anchor Link

La pestaña Tienda ofrece un catálogo comercial separado de los módulos que ya están instalados en el espacio. Puede incluir extensiones gratuitas, compras únicas y suscripciones periódicas.

En la tienda puedes:

• explorar el catálogo;
• buscar por nombre, función o identificador;
• consultar la descripción y el modelo de precio;
• añadir módulos gratuitos;
• comprar módulos de pago;
• revisar el directorio de módulos asociados;
• consultar los gastos o compras del espacio.

Los módulos pueden cubrir áreas como soporte interno, formación, proveedores, logística, tiendas online, control horario, energía o gestión financiera. La oferta y los importes mostrados son los vigentes en la cuenta y pueden cambiar.

Tienda y catálogo del espacioCopy Anchor Link

No son exactamente la misma vista:

• el catálogo del espacio muestra módulos disponibles para instalar o actualizar en ese CRM;
• la tienda muestra módulos que pueden adquirirse o añadirse a la cuenta;
• el directorio permite consultar los módulos que ya están asociados al espacio.

Si la tienda muestra No autorizado, el usuario actual no dispone del contexto de cuenta o del acceso comercial necesario. No debe interpretarse como un error del módulo. Comprueba la sesión, el espacio seleccionado y los permisos de compra.

Ciclo de vida recomendadoCopy Anchor Link

Un módulo debe gestionarse como una dependencia versionada:

Evaluar → Instalar → Configurar → Probar → Activar → Operar
                                      ↓
                              Actualizar o pausar

Pausar o retirar una extensiónCopy Anchor Link

Antes de desactivar o desinstalar:

1. identifica qué equipos utilizan el módulo;
2. revisa las tareas, automatizaciones, formularios y rutas que dependen de él;
3. exporta o conserva la información que necesites;
4. desactiva primero si solo quieres detener su uso temporalmente;
5. desinstala únicamente después de leer la confirmación y las consecuencias.

Desinstalar puede retirar pantallas, configuraciones o datos propios de la extensión. Las relaciones con entidades del CRM y la política de conservación dependen del módulo, por lo que la confirmación del sistema es la referencia final.

Para quienes crean módulos externosCopy Anchor Link

La administración de módulos está pensada para que un integrador pueda desarrollar una extensión sin acceder al código interno del CRM. El contrato público debe cubrir, de forma explícita:

• manifiesto e identificador del paquete;
• versiones y dependencias;
• vistas y navegación;
• acciones y validaciones;
• montajes o widgets;
• endpoints públicos y webhooks;
• permisos funcionales;
• instalación, actualización y retirada;
• tratamiento de errores y límites.

Empieza por Módulos externos y continúa con:

• Manifiesto y estructura y estructura del paquete;
• Vistas y acciones;
• Montajes e integración visual;
• Endpoints públicos;
• Seguridad del módulo;
• Publicación.

Si una de esas páginas todavía está en preparación, utiliza la convención pública descrita en esta guía y evita depender de detalles internos del core.

Problemas habitualesCopy Anchor Link

Relación con el resto del CRMCopy Anchor Link

Los módulos amplían el CRM, pero siguen conectados a sus zonas principales:

• pueden crear o consultar clientes y prospectos;
• pueden generar tareas, eventos o avisos;
• pueden utilizar medios y formularios;
• pueden alimentar informes;
• pueden integrarse mediante API y webhooks.

Documentar estas relaciones ayuda a distinguir qué pertenece al CRM base y qué comportamiento añade cada extensión.