Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/banredco/helpdesk/llms.txt

Use this file to discover all available pages before exploring further.

El panel de administración de Banred Helpdesk centraliza toda la configuración operativa del sistema: desde la creación de agentes y grupos de atención hasta la gestión de buzones de correo, plantillas y catálogos auxiliares. Solo los usuarios con rol Administrador o Supervisor pueden acceder a esta sección; cualquier intento de acceso por parte de un agente sin los permisos correspondientes termina con un mensaje de “Acceso denegado” y la sesión bloqueada antes de renderizar la página.

Módulos de configuración

El menú principal de configuración (/admin/settings.php) expone los siguientes módulos:

Estados y Prioridades

Gestión de estados del ciclo de vida de un ticket y niveles de prioridad.

Tipos

Tipificación de tickets para clasificar la naturaleza de cada solicitud.

Grupos

Equipos de atención que agrupan agentes por área o departamento.

Etiquetas

Etiquetas de libre configuración para clasificación rápida y filtrado.

Correos

Buzones IMAP/SMTP para recibir y enviar correos vinculados a tickets.

Plantillas

Plantillas de correo para notificaciones automáticas del sistema.

Respuestas Rápidas

Textos predefinidos que los agentes pueden insertar en respuestas y comentarios.

Control de acceso

El acceso al panel de configuración está restringido mediante la función requireRole(), definida en config/permissions.php. Esta función verifica que el role_id almacenado en la sesión activa pertenezca a la lista de roles permitidos; de lo contrario, detiene la ejecución inmediatamente.
// config/permissions.php
function requireRole(array $roles)
{
    if (
        !isset($_SESSION['role_id'])
        ||
        !in_array($_SESSION['role_id'], $roles)
    ) {
        die('Acceso denegado');
    }
}
Todos los archivos del panel de configuración invocan esta función al inicio:
// Ejemplo: admin/settings.php
requireRole([1, 2]);
La tabla siguiente resume los niveles de acceso por rol:
role_idNombreAcceso al panel de administración
1AdministradorAcceso total a todos los módulos
2SupervisorAcceso a configuración y gestión de tickets
3+AgenteSin acceso a configuración; solo tickets asignados
Todos los formularios del panel de administración incluyen protección contra ataques CSRF mediante el helper Csrf. Al renderizar un formulario se genera un token único con Csrf::generate(), que se embebe como campo oculto. Al procesar el envío, el servidor valida el token con Csrf::validate($_POST['csrf_token']) antes de ejecutar cualquier operación en la base de datos. Si la validación falla, se muestra el mensaje “La sesión del formulario expiró. Intenta nuevamente.” y no se realiza ningún cambio.

Páginas relacionadas

Usuarios y Roles

Cómo crear, editar y desactivar cuentas de agente, y referencia completa de los niveles de rol.

Grupos

Organización de agentes por equipo y enrutamiento automático de tickets.

Etiquetas y Tipos

Clasificación de tickets con etiquetas de color y tipos de solicitud.

Plantillas de Correo

Configuración de notificaciones automáticas por correo electrónico.

Build docs developers (and LLMs) love