Inicio rápido

Esta guía te lleva desde cero hasta ver el primer evento en el dashboard en menos de 30 minutos. Si ya instalaste el plugin y tienes tus credenciales, salta directamente al paso 3.

Requisitos previos

Moodle 4.1 o superior con acceso de administrador.
HTTPS egress desde tu servidor Moodle hacia ingest.softsysanalytics.com y api.softsysanalytics.com.
Credenciales de tenant proporcionadas por SoftSys Solutions (tenant ID + API key).

Paso a paso

Solicita tu acceso y credenciales

Contacta al equipo de SoftSys Solutions para solicitar el aprovisionamiento del tenant. Recibirás:
- Tenant ID — un UUID único para tu organización.
- API key — con formato ssea_ seguido de 32 caracteres hexadecimales.
- Endpoints recomendados:
  - Ingest: https://ingest.softsysanalytics.com
  - API: https://api.softsysanalytics.com
  - Dashboard: https://app.softsysanalytics.com
Guarda la API key en un lugar seguro — no puede recuperarse después (solo revocarse y reemitirse).
Instala el plugin Moodle

Descarga el último local_ssea.zip del canal de release acordado con SoftSys Solutions.

En Moodle, ve a Administración del sitio → Plugins → Instalar plugins y sube el ZIP.

Sigue el asistente de instalación hasta que Moodle complete la migración de base de datos. Ver Plugin Moodle para instalación manual u opciones avanzadas.
Configura el plugin

Ve a Administración del sitio → Plugins → Plugins locales → SSEA Analytics y rellena los campos obligatorios:

Ajuste Valor
Habilitado Sí
Server URL https://ingest.softsysanalytics.com
API key tu clave (empieza por ssea_...)
Tenant ID tu UUID de tenant

Deja el Delivery mode en batch (recomendado) y Batch size en 50 por defecto. Guarda los cambios.
Valida en 30 minutos

Haz que uno o dos usuarios de prueba:
- Inicien sesión en Moodle.
- Naveguen a un curso.
- Abran un recurso o completen una actividad.
En paralelo:
- Abre el dashboard (https://app.softsysanalytics.com) con tus credenciales.
- Ve a la página Overview (/) — deberías empezar a ver contadores distintos de cero en los próximos minutos.
- Si usas el modo batch por defecto, la primera flush ocurre cada 5 minutos. Ten paciencia en la primera sincronización.
Explora el dashboard

Con los primeros eventos llegando, ya puedes empezar a recorrer las secciones:
- Users (/users) — verás aparecer los usuarios activos.
- Courses (/courses) — lista de cursos con métricas iniciales.
- At-Risk (/at-risk) — aún vacía; se poblará cuando el worker de detección tenga suficiente histórico (típicamente 24–48h).
- Alerts (/alerts) — también empezará a llenarse una vez que haya actividad sostenida.
Consulta Tour del dashboard para una descripción completa de cada página.

Ajuste	Valor
Habilitado	Sí
Server URL	`https://ingest.softsysanalytics.com`
API key	tu clave (empieza por `ssea_...`)
Tenant ID	tu UUID de tenant

¿Algo no funciona?

No llegan eventos

Verifica que el plugin está habilitado, la API key es correcta y el cron de Moodle está corriendo. Ver troubleshooting del plugin.

Error 401

Tu API key fue rechazada. Revisa que coincide con la que te entregó SoftSys Solutions y contacta soporte si persiste.

Error 402

Cuota diaria del plan superada. Ver Planes y límites.

Error SSL

Actualiza el bundle de CAs de tu servidor Moodle. Ver troubleshooting.

Tras completar el onboarding

El asistente de onboarding incluye un paso de selección de rol. La página de aterrizaje del dashboard se ajusta automáticamente al rol elegido:

Rol seleccionado	Página de aterrizaje
`admin`	Resumen del tenant (overview con KPIs y tendencias)
`teacher`	Listado de cursos del docente
`student`	Su propia página de detalle (perfil + calificaciones)

Si te equivocas en la selección, puedes corregirla desde Configuración → Rol una vez dentro. El cambio surte efecto en el siguiente request — la política se re-evalúa por petición. Ver Roles y permisos para la matriz completa.

¿Qué sigue?

Una vez que SSEA está recibiendo eventos:

Ejecuta la migración histórica (opcional): activa la scheduled task SSEA: Migrate Moodle data para sincronizar al backend el estado actual de usuarios, cursos, matrículas y calificaciones. Útil para pre-poblar el dashboard con el histórico existente.
Configura umbrales de At-Risk desde el dashboard (/settings) para ajustar la sensibilidad del detector al tipo de estudiantes de tu institución.
Explora la API (/api/events/, /api/dashboard/) si quieres construir integraciones propias sobre los datos del tenant.
Revisa los planes (/plans/) para entender las cuotas y cuándo conviene hacer upgrade.