Cozmos Docs es la nueva documentación oficial de la plataforma Cozmos. Por eso, reúne en un único espacio todo lo necesario para crear una cuenta, conectar equipos, configurar alarmas, gestionar licencias e integrar Cozmos con otros sistemas.
Además, agrupa las release notes de todos los módulos, está disponible en cinco idiomas y adapta el contenido al nivel de acceso de cada usuario. De este modo, cada persona encuentra la información que necesita, en el momento en que la necesita, sin depender de terceros.
El problema: la información que nadie encuentra
En una organización, la adopción de una nueva plataforma rara vez fracasa por falta de funcionalidades. Sin embargo, fracasa muchas veces porque quien la utiliza no sabe por dónde empezar.
Por ejemplo, las dudas se acumulan rápidamente. ¿Cómo se conecta un equipo LoRaWAN? ¿Qué datos necesita un equipo MQTT? ¿Cómo se crea una alarma que no salte con el primer retraso de comunicación? ¿Dónde se renueva una licencia?
Cuando la respuesta está repartida entre correos electrónicos, archivos antiguos o la memoria de un compañero, cada duda se convierte en una interrupción. En consecuencia, el equipo pierde tiempo. Al mismo tiempo, los nuevos usuarios tardan más en ser autónomos y el potencial de la plataforma queda sin aprovechar.
Por esta razón, creamos Cozmos Docs.
Cozmos Docs: una documentación pensada para quien opera Cozmos
Cozmos Docs no es un manual técnico genérico. Al contrario, se ha escrito a partir de las pantallas reales de la plataforma, con los mismos nombres de botones, campos y menús que el usuario encuentra en su día a día.
Asimismo, cada página sigue el orden del propio producto. Así, el usuario puede tener la documentación abierta junto a Cozmos y seguir cada paso a medida que lo realiza.
En resumen, la documentación se organiza en seis grandes áreas:
- Introducción, con la presentación de la plataforma, de los módulos y de la propia documentación;
- Tecnologías compatibles, con lo necesario para conectar equipos LoRaWAN, MQTT y de otros protocolos, y con la lista de equipos compatibles;
- Primeros pasos, con la creación de la cuenta, el inicio de sesión y los primeros pasos en la plataforma;
- Guías, con el dashboard, el mapa, el histórico, la gestión de equipos, las alarmas y los datos personales;
- Cozmos Admin, con las licencias, los usuarios, las gateways LoRaWAN y los logs;
- Integraciones, con la REST API, los Datos públicos y el Repositorio de archivos.
Del primer registro al primer equipo con Cozmos Docs
El inicio es el momento en que la documentación marca más la diferencia. Por ello, Cozmos Docs acompaña al nuevo usuario desde la creación de la cuenta hasta la conexión del primer equipo.
En primer lugar, la página Primeros pasos explica cada paso del registro: los datos del usuario, los datos de la entidad, la elección de las licencias y el pago. También explica por qué se solicita cada dato, como el NIF o la región fiscal. Este recorrido acompaña el nuevo registro de Cozmos Login 1.2, en el que las licencias y los planes se eligen durante la creación de la cuenta.
A continuación, la sección Tecnologías compatibles indica, para cada protocolo, los datos que debe tener el equipo, como el DevEUI y la AppKey en un equipo LoRaWAN. De este modo, el usuario sabe qué preparar antes de añadir su primera estación.
Guías de Cozmos Docs para el trabajo diario
Una vez creada la cuenta, las dudas cambian. Es decir, ya no se trata de empezar, sino de sacar partido de todo lo que ofrece la plataforma.
Las Guías cubren las áreas que el usuario utiliza todos los días:
- Dashboard, con los elementos disponibles y cómo configurarlos;
- Mapa, con la ubicación y el estado de las estaciones;
- Histórico, con el análisis de datos, las estadísticas y la importación de lecturas;
- Gestión de equipos, con qué es una estación, qué es una variable y cómo se asocian a las licencias, y con cómo añadir, visualizar y editar estaciones y enviar comandos;
- Alarmas, con las alarmas de variable y de estado, las sugerencias de alarmas y las notificaciones por correo electrónico, SMS y mensaje de voz;
- Cambiar datos personales, con el perfil, las reglas de la contraseña y la autenticación de dos factores.
Además, la nueva página de introducción a la gestión de equipos explica los conceptos básicos de Cozmos. Así, el usuario entiende cómo se relacionan las estaciones, las variables y las licencias antes de empezar a configurar.
La información adecuada para cada nivel de acceso
No todos los usuarios necesitan la misma información. Por ejemplo, un técnico que consulta datos no necesita saber cómo se crea un cliente. En cambio, un gestor necesita saber cómo se renueva una licencia o cómo se añade un nuevo usuario.
Por consiguiente, Cozmos Docs adapta el contenido al nivel de acceso de cada cuenta. La introducción, las tecnologías compatibles y los Primeros pasos son públicos. Tras iniciar sesión con la cuenta Cozmos, la documentación muestra las secciones a las que el usuario tiene acceso:
| Nivel | Guías | Integraciones | Cozmos Admin |
|---|---|---|---|
| Usuario | Sí | Sí | No |
| Gestor | Sí | Sí | Sí |
| Agente | Sí | Sí | Sí |
La sesión es la misma que en la plataforma. En consecuencia, no hace falta una cuenta adicional ni una nueva contraseña. Para quien gestiona varios clientes, la sección Cozmos Admin sigue la misma lógica de la Red de Agentes.
Otras novedades de Cozmos Docs
Además de las guías y de la organización por niveles, Cozmos Docs reúne otros recursos que hasta ahora estaban dispersos.
Release notes de todos los módulos
Todas las actualizaciones de Cozmos, Cozmos Admin, Cozmos EMS y Cozmos SIS están disponibles en la sección Release notes, organizadas por módulo y por versión. Así, es fácil seguir la evolución de la plataforma y saber qué ha cambiado en cada actualización.
Integraciones documentadas
La sección Integraciones explica cómo conectar Cozmos con otros sistemas a través de la REST API, cómo publicar datos en tiempo real en un sitio web con los Datos públicos y cómo utilizar el Repositorio de archivos. Además, cada integración cuenta con su manual en PDF y, cuando corresponde, con su especificación OpenAPI.
Cinco idiomas
La documentación está escrita en portugués de Portugal y puede consultarse en inglés, español, alemán y portugués de Brasil. De este modo, equipos y socios de distintos países consultan la misma información.
Menos dudas, más autonomía
Una buena documentación no sustituye el acompañamiento del equipo Cozmos. No obstante, permite que ese acompañamiento se centre en lo que realmente importa.
Cuando las respuestas a las dudas más habituales están a un clic, el usuario resuelve por sí mismo gran parte de las cuestiones del día a día. En consecuencia, los nuevos miembros de un equipo ganan autonomía más rápido. Al mismo tiempo, las organizaciones obtienen más valor de la plataforma desde el primer día.
En definitiva, el recorrido de un nuevo usuario pasa a ser:
Crear la cuenta → Entender la tecnología → Conectar el equipo → Configurar alarmas → Analizar los datos
Y, en cada uno de estos pasos, hay una página de Cozmos Docs para acompañarlo.
Una documentación que crece con la plataforma
Cozmos está en constante evolución, y la documentación sigue ese ritmo. Por último, cada nueva funcionalidad tiene su lugar en Cozmos Docs, con el mismo lenguaje y la misma estructura que el resto de las páginas.
Ya sea una organización que da sus primeros pasos con el plan gratuito o un socio que gestiona varios clientes en Cozmos Admin, Cozmos Docs está pensado para responder a las dudas de cada uno.
Descubra Cozmos Docs 🚀
Acceda a Cozmos Docs, explore las guías y descubra todo lo que la plataforma Cozmos puede hacer por su organización.
Después, inicie sesión con su cuenta Cozmos y consulte la documentación adaptada a su nivel de acceso, en las áreas que tienen sentido para su trabajo.
