Configurar los servicios del sistema
Utiliza las doce áreas del sistema para conectar Obelisk, ajustar recopilación e informes y verificar los servicios de la automatización opcional.
Localizar el área correspondiente
Abre Administración → Sistema y utilidades. Sus áreas incluyen identidad e idioma, autenticación, PBX y bases de datos, rutas, actualización, salud de colas, tendencias y previsiones, Gemini, análisis en segundo plano, SMTP y limpieza, diagnóstico y licencia. Trabaja en el área del requisito o síntoma real.
Cambiar y guardar un área
Anota los valores existentes antes de sustituirlos. Conexiones, rutas de grabaciones y opciones de conservación tienen consecuencias distintas; cambiar el intervalo de pantalla no repara una conexión SQL o AMI.
Configurar la dependencia
Define conexión PBX/base de datos, ruta o parámetros SMTP necesarios. Para IA, revisa modelo y clave de Gemini y después los ajustes del procesamiento en segundo plano.
Separar análisis y eliminación
Revisa el estado del análisis automático por separado de limpieza y conservación. Activar tareas programadas no activa por sí solo el borrado de grabaciones; sus opciones requieren configuración propia.
Recorrer los doce paneles de Sistema
La navegación lateral contiene once paneles numerados de ajustes y diagnóstico, más Licencia. Algunos controles tienen su propio guardado o confirmación: lee el botón y el resultado local antes de salir del panel.
| Panel | Qué controla |
|---|---|
| 1. Identidad e idioma | Identidad de empresa y línea PBX, idioma de informes, separador CSV y memoria de tareas de audio e informe mensual. |
| 2. Seguridad y acceso | Intentos y bloqueo de acceso, más duración de sesiones normales y Pantalla con guardado propio. |
| 3. Asterisk y bases de datos | Conexión y credenciales AMI, base de datos de aplicación y base de origen CDR. Comprueba el servicio correcto si una función no conecta. |
| 4. Grabaciones y archivos de registro | Ruta de grabaciones Asterisk, trabajo pendiente de carpetas anteriores, extensiones de audio permitidas, rutas de registros de procesos y aplicación, y geografía de IP públicas. |
| 5. Intervalos de actualización | Actualización en vivo, caché, recogida histórica e intervalo entre solicitudes IA, más URL y atribución de teselas del mapa. Son intervalos con funciones distintas. |
| 6. Salud de las colas | Objetivos de SLA y espera y penalizaciones de los indicadores de salud; relaciona el estado resultante con la situación operativa real. |
| 7. Tendencias y previsiones | Sensibilidad de tendencias, histórico, muestra y horizonte de previsión, caché, horas de heatmap y tamaño de nube de palabras de calidad. |
| 8. Google Gemini AI | Clave API, modelo y temperatura, herramientas de modelos, muestreo y zona horaria de informes. Revisa la planificación semanal y mensual mostrada. |
| 9. Análisis de audio y protección | Límites de escaneo y lotes, tamaño y estabilidad de archivos, tiempos de procesos, fallos transitorios y estado del análisis automático. |
| 10. Correo SMTP y limpieza de audio | Destinatarios y remitente, servidor SMTP y cifrado, limpieza y conservación. Distingue borrado local de limpieza de archivos remotos de IA. |
| 11. Comprobaciones de instalación | Ejecuta diagnósticos de solo lectura, revisa requisitos de base de datos y entorno y las correcciones concretas propuestas. |
| Licencia | Consulta tipo, estado y caducidad cuando exista; usa el enlace de gestión para activar la licencia. |
Guardar sesiones e intervalos de forma consciente
En Seguridad y acceso, la inactividad normal se expresa en minutos, la duración máxima normal en horas y la de Pantalla en días. Utiliza el botón Guardar propio de esa política. Usuarios selecciona el modo de sesión; este panel define su duración.
Comprender el ciclo del audio con Gemini
El análisis IA de una grabación envía audio al servicio Gemini configurado. Según el tamaño de la solicitud, Obelisk incluye el audio directamente o carga un archivo temporal mediante Files API. La limpieza depende de esa vía.
Enviar el audio seleccionado
Las solicitudes pequeñas incluyen el audio directamente. Las grandes cargan un archivo temporal y esperan a que esté listo antes de pedir el análisis. La carga no elimina la grabación original del PBX.
Completar el intento de análisis
Gemini procesa la solicitud y Obelisk gestiona el resultado o error. El archivo de Files API debe seguir disponible durante el intento de análisis; no se solicita borrarlo inmediatamente después de enviarlo.
Solicitar la eliminación del archivo temporal
Para un archivo cargado e identificado como propio, Obelisk intenta solicitar su borrado al terminar el flujo, también ante errores gestionados. El audio incluido directamente no tiene objeto Files API que borrar. La conservación local se gestiona aparte.
Configurar la ruta de grabaciones y revisar enlaces simbólicos
En Sistema y utilidades → Grabaciones y archivos de registro, indica una ruta existente en el servidor Obelisk. El valor inicial es /var/spool/asterisk/monitor, con subcarpetas año/mes/día. La cuenta asterisk debe poder recorrer las carpetas y leer el audio. Una conexión SQL remota no copia las grabaciones a esta ruta.
Usar la ruta real del archivo
Prefiere el directorio real o el punto de montaje previsto, conservando carpetas año/mes/día y nombres. Comprueba una grabación conocida en Grabaciones y después el estado de análisis automático por separado. No uses chmod 777 ni elimines controles de ruta para hacer visible un archivo.
Al mover el mismo archivo
Pausa las tareas de audio y espera a que terminen antes de mover archivos. Guarda la nueva ruta, revisa la vista previa de pendientes de la carpeta anterior en este panel y confirma la transferencia solo si es el mismo archivo. Se transfieren trabajo pendiente e historial de exploración; no se mueven ni borran audios. Reanuda tras verificar.
| Operación | Qué ocurre con los enlaces simbólicos |
|---|---|
| Explorar, escuchar y descargar | Las rutas se resuelven dentro de la raíz de grabaciones. Puede leerse un enlace a un destino existente dentro de esa raíz real, incluso si la propia raíz configurada es un enlace. Se rechazan los enlaces que salen de ella. Siguen aplicándose los permisos de página y acción. |
| Descubrimiento automático de audio | El worker resuelve la raíz, pero rechaza enlaces simbólicos en las carpetas año/mes/día y omite archivos que sean enlaces. Por tanto, poder escuchar un archivo no garantiza que se descubra automáticamente. |
| Limpieza por categoría de error | El cleaner rechaza una raíz configurada que sea en sí un enlace simbólico y omite enlaces bajo la raíz resuelta. Solo pueden ser aptas las categorías de error seleccionadas y verificadas; aparecer en el catálogo no autoriza el borrado. |
| Conservación de audio | La conservación rechaza enlaces simbólicos en la raíz configurada o sus carpetas superiores, omite enlaces en subcarpetas/archivos y archivos con varios enlaces duros. También verifica antigüedad, análisis completo utilizable y actividad del archivo. |
Conectar el análisis con los informes periódicos
Configura clave y modelo Gemini, revisa el muestreo y elige la zona horaria de informes. El panel muestra la planificación semanal y mensual y explica el tratamiento de datos tardíos. Comprueba el idioma en Identidad e idioma y destinatarios, remitente y SMTP en Correo y limpieza.
Verificar el modelo
Usa las herramientas de listado y prueba, elige el modelo y guarda la selección. Una prueba no guarda otro modelo ni confirma un análisis de audio completado.
Comprobar el análisis de origen
Revisa el estado automático y confirma resultados de grabaciones aptas. En elementos suspendidos, lee el motivo y corrígelo antes de volver a poner en espera las grabaciones seleccionadas.
Verificar generación y entrega por separado
Revisa la ejecución programada y el registro semanal o mensual, y comprueba el buzón destinatario. Generar el informe y entregar el correo son resultados distintos.
Verificar configuración y ejecución
Ejecuta la comprobación de conexión y Diagnóstico tras guardar. Revisa el estado de ejecución cuando corresponda y prueba la función real. La disponibilidad de configuración no confirma entrega correcta a Gemini o SMTP ni un flujo completo en producción.
Gestionar el análisis suspendido
Una actualización conserva las grabaciones suspendidas. Examina el motivo en el estado del análisis automático y vuelve a ponerlas en espera solo tras corregir la causa. Distingue destinatarios de informes y avisos de seguridad y confirma el idioma previsto.
Mantén las definiciones cron y SQL bajo control del soporte
Las tareas cron y los eventos SQL cumplen funciones distintas. No modifiques planificaciones, comandos de workers, procedimientos almacenados ni definiciones de eventos SQL sin una indicación concreta del soporte Obelisk. Editar, ejecutar y restaurar un procedimiento tienen efectos diferentes: no son una actualización genérica de la página.
Consultar componentes y licencias de terceros
La aplicación instalada incluye una lista legible de bibliotecas, fuentes, datos geográficos y sus archivos de licencia originales. En la ruta estándar, abre /obelisk/assets/vendor/notices/THIRD_PARTY_NOTICES.txt en tu servidor Obelisk; por SSH el mismo archivo está en /var/www/html/obelisk/assets/vendor/notices/THIRD_PARTY_NOTICES.txt. Adapta la ruta base si es distinta. La lista separa componentes distribuidos de servicios externos de gráficos/mapas y descargas opcionales.
Utiliza los controles y comprende qué cambia
Usa el panel numerado para localizar el ajuste y lee unidad y guardado. Las sesiones usan minutos, horas y días en campos distintos. Actualización, recogida histórica e intervalo IA son controles diferentes; cambiar uno no cambia automáticamente los demás.
Capturas completas del producto
Datos de ejemplo. Abre la captura para ampliarla y relacionar los controles con las instrucciones del capítulo.
Abrir captura completa
Lee la pantalla sección por sección
Relaciona los números y paneles siguientes con la pantalla completa. Las capturas utilizan datos de ejemplo; los procedimientos anteriores explican cómo trabajar con tu instalación.
Conexiones de aplicación y PBX
Revisa la configuración de la base de datos, las fuentes FreePBX y la conexión Asterisk AMI. Distingue credenciales y direcciones de cada integración.
Rutas y almacenamiento
Localiza grabaciones, registros y datos de la aplicación. Revisa las rutas configuradas y su estado antes de procesar audio o investigar una instalación.
Intervalos de actualización y recogida
Ajusta la actualización en vivo, la caché AMI compartida, la recogida del historial y el intervalo entre solicitudes web de IA según la instalación.
Salud de las colas
Configura los pesos y umbrales de los indicadores de salud de las colas para que los avisos reflejen las condiciones que quieres supervisar.
Tendencias, previsiones y visualización de informes
Configura la sensibilidad de tendencias, previsiones de espera, caché SLA, horas de las matrices y nube de palabras de Calidad e IA.
Configuración de Gemini e IA
Elige la configuración del proveedor, modelos y opciones de análisis de las funciones de IA que actives. También sirven de base para los informes de Calidad e IA.
Procesamiento en segundo plano
Revisa el estado de los procesos de audio, las grabaciones pendientes, las solicitudes rechazadas y los reintentos. Sigue la cola e investiga los elementos que requieren atención.
Correo, conservación y mantenimiento
Configura destinatarios de informes y envío SMTP, tiempos de conexión y limpieza de audio. Define las opciones que utilizan las tareas programadas del servidor.
Diagnóstico de instalación
Ejecuta la comprobación y revisa resultados de conexiones, rutas y componentes necesarios. Abre la guía dedicada para comprender las comprobaciones y vistas previas de reparación de permisos.
Licencia instalada
Consulta el tipo de licencia y, cuando corresponda, su vencimiento. Abre la gestión desde este panel para seguir el proceso de activación o renovación.