Gestionar usuarios con acceso
Un usuario es una cuenta que puede entrar a AuditorIA. Desde esta seccion se gestionan sus datos de acceso, roles, campanas asignadas y el ID de operador que lo vincula con casos, auditorias o devoluciones cuando corresponde.
No todos los operadores necesitan usuario. Si una persona solo debe aparecer como auditable, seleccionable en formularios o visible en reportes, puede alcanzar con crearla como operador local. Creale usuario cuando tambien tenga que iniciar sesion en la app.
Antes de empezar
Antes de crear o modificar usuarios, revisa que existan estos datos:
| Dato | Para que se usa |
|---|---|
| Rol | Define que secciones y acciones puede usar la cuenta. |
| Campanas | Delimitan sobre que llamadas o chats puede trabajar, cuando el rol usa alcance por campana. |
| ID de operador | Identifica a la persona en llamadas, chats, auditorias, filtros y reportes. |
| Email y username | Identifican la cuenta de acceso. |
| Contrasena inicial | Permite el primer ingreso o el cambio posterior de clave. |
Las opciones visibles dependen de permisos. Si no ves Gestion de equipo, Crear usuario, editar roles, asignar campanas o cambiar el ID de operador, pedile a quien administra accesos que revise tu rol.
Entrar a usuarios
- En el menu lateral, abri Gestion de equipo.
- Entra a Administracion de usuarios.
- Usa la vista Dashboard para revisar indicadores generales del equipo, o la vista de usuarios para buscar y administrar cuentas.
El Dashboard sirve como lectura general antes de entrar a una cuenta puntual. Muestra usuarios activos, roles definidos, cantidad de operadores, inferencias recientes, consumo semanal, distribucion de roles y actividad reciente del modulo. No es la vista para corregir una cuenta individual: para eso usa la pestana Usuarios.
La lista permite buscar por nombre, email u operador, filtrar por roles y campanas, usar filtros por campo, cambiar la paginacion y alternar vista compacta o expandida.
Buscar y filtrar usuarios
Usa el buscador principal cuando tenes un dato parcial y no necesitas precisar el campo. Ese buscador esta pensado para busquedas rapidas por nombre, email u operador.
Para busquedas mas exactas, usa el filtro Campo:
- Elegi si queres filtrar por Usuario, Email, Nombre o Apellido.
- Escribi el valor a buscar.
- Usa Aplicar.
- Usa Limpiar para volver a la lista sin ese filtro.
Entender la lista
La tabla resume los datos principales de cada cuenta:
| Columna | Que muestra |
|---|---|
| Usuario | Nombre, apellido, email o username visible. |
| Roles | Roles asignados a la cuenta. |
| Estado | Si la cuenta esta activa, invitada o suspendida. |
| Operator ID | ID funcional que vincula la cuenta con operador/casos. |
| Campanas | IDs de campanas asignadas. |
| Creado | Fecha de creacion de la cuenta. |
| Acciones | Acceso al detalle, edicion o eliminacion. |
Estados visibles
| Estado | Que significa |
|---|---|
| Activo | La cuenta esta habilitada y verificada. |
| Invitado | La cuenta esta habilitada, pero el email todavia no figura como verificado. |
| Suspendido | La cuenta esta deshabilitada. |
No trates estos estados como roles. El rol define permisos; el estado indica la condicion de acceso de la cuenta.
Crear un usuario
Usa Crear usuario cuando una persona necesita entrar a AuditorIA.
- Hace clic en Crear usuario.
- Elegi Usuario Individual.
- Completa nombre, apellido, username y email.
- Carga el ID de Operador.
- Define la contrasena inicial y confirma la contrasena.
- Indica si la cuenta queda activa y si el email queda marcado como verificado.
- Asigna un rol.
- Asigna campanas de llamadas y/o redes sociales, si corresponde.
- Guarda el usuario.
La pantalla actual pide ID de Operador para crear la cuenta. Eso no significa que todo usuario sea necesariamente una persona auditada: significa que AuditorIA necesita un identificador funcional para vincular o sincronizar esa cuenta con la representacion local cuando corresponda.
Elegir el ID de operador
El ID de operador es el puente entre la cuenta que inicia sesion y la persona que aparece en llamadas, chats, auditorias y reportes.
Usa el mismo ID cuando:
- la persona ya tiene llamadas o chats historicos cargados con ese operador;
- debe ver sus propios casos o devoluciones;
- va a aparecer como operador en auditorias manuales, cargas de audio, filtros o reportes.
Si el sistema indica que el ID ya existe, no lo fuerces con otro valor para avanzar. Primero verifica si esa persona ya tiene un usuario o si existe como operador local. Duplicar operadores puede partir el historial y confundir reportes.
Cambiar el ID de operador de una cuenta existente puede cambiar que casos personales ve ese usuario. Antes de modificarlo, confirma que el nuevo ID sea el correcto y que no estes separando a la persona de su historial.
Asignar roles
El rol define que puede ver y hacer el usuario. No conviene asumir roles universales como contrato fijo, porque cada organizacion puede configurarlos distinto.
Al crear o editar una cuenta:
- Abri el selector de Rol o la pestaña Roles del detalle.
- Elegi uno o mas roles disponibles.
- Revisa la vista previa de rutas y funcionalidades cuando la pantalla la muestre.
- Guarda los cambios.
Para entender como se crean roles y permisos, continua en Roles, permisos y opciones visibles.
Asignar campanas
Las campanas asignadas delimitan el alcance de datos cuando el rol trabaja por campana. Por ejemplo, una persona con permisos de revision puede ver tareas de las campanas asignadas, no necesariamente de toda la plataforma.
La asignacion distingue canales:
| Tipo de campana | Donde impacta |
|---|---|
| Call Center / Llamadas | Audios, tareas de llamadas, auditorias de llamada y reportes de llamadas. |
| Redes Sociales / RRSS | Chats, auditorias de conversaciones y reportes de redes sociales. |
Al editar campanas, podes buscar por nombre o ID, agregar o quitar campanas y revisar el resumen de cambios antes de guardar.
Si la campana que necesitas no aparece, revisa primero Configuracion de campanas. Si existe pero el usuario no la ve, revisa su rol y su asignacion de campanas.
Crear usuarios en carga masiva
La pestaña Carga Masiva permite crear varios usuarios desde un CSV.
- Descarga la plantilla desde la pantalla.
- Completa una fila por usuario.
- Carga el CSV.
- Revisa los candidatos detectados.
- Ajusta datos, rol, campanas o ID de operador si hace falta.
- Usa Crear todos cuando la lista este correcta.
La plantilla usa columnas como firstName, lastName, email, role, campaigns, enabled, emailVerified y password. La pantalla puede recomendar IDs de operador para los candidatos; revisalos antes de crear las cuentas.
Para cargas masivas, crea primero un lote chico y verifica que los usuarios queden con rol, campanas y operator ID correctos. Despues repeti el proceso con el resto.
Editar una cuenta existente
Desde el menu de acciones o al abrir una fila, AuditorIA muestra el detalle del usuario.
Segun tus permisos, podes:
- editar nombre y apellido;
- editar email;
- cambiar roles;
- cambiar el ID de operador;
- asignar o quitar campanas;
- cambiar la contrasena;
- revisar sesiones activas;
- eliminar el usuario.
La pestaña Informacion concentra datos personales, operator ID, campanas, contrasena y zona de eliminacion. La pestaña Roles muestra roles asignados y permite cambiarlos. La pestaña Sesiones muestra sesiones activas registradas por Keycloak.
No uses la eliminacion como limpieza normal. Eliminar una cuenta es irreversible y puede borrar tambien su representacion local asociada. Si el objetivo es corregir permisos, normalmente conviene ajustar rol, campanas, operator ID o contrasena antes de eliminar.
Relacion con operadores locales
Usa esta regla practica:
| Situacion | Que hacer |
|---|---|
| La persona necesita entrar a AuditorIA | Crear o editar un usuario con acceso. |
| La persona solo debe ser auditada o seleccionada en flujos | Crear o mantener un operador local. |
| La persona ya existe como operador y ahora necesita login | Crear usuario y vincular el mismo ID de operador. |
| El usuario no ve sus casos o devoluciones | Revisar operator ID, campanas asignadas y rol. |
| El usuario ve la seccion pero no una accion | Revisar permisos del rol. |
No dupliques la persona con otro ID para resolver un problema de acceso. Primero identifica si el problema esta en el usuario, en el operador local, en el rol o en las campanas asignadas.
Problemas frecuentes
No aparece Gestion de equipo
Tu usuario no tiene la ruta o feature necesaria para administrar usuarios. Pedile a un administrador que revise tu rol en Roles, permisos y opciones visibles.
No puedo crear usuario
Puede faltar el permiso de creacion, puede haber un email repetido o puede faltar un dato obligatorio como rol u operator ID. Revisa el mensaje de error y confirma si la persona ya existe.
El usuario no ve una campana
Revisa tres cosas:
- Que la campana exista y corresponda al canal correcto: llamadas o RRSS.
- Que el usuario tenga esa campana asignada.
- Que su rol tenga permisos para ver o trabajar con esa seccion.
El usuario no ve sus propias tareas
Verifica que el ID de operador de la cuenta coincida con el ID usado en las llamadas o chats. Si el operator ID no coincide, AuditorIA puede no reconocer esos casos como propios.
Cambie roles o campanas y no se refleja
Primero refresca la pantalla. Si sigue igual, pedi al usuario que vuelva a iniciar sesion para renovar su contexto de permisos.