Gestionar operadores locales
Un operador local es la identidad funcional de una persona que puede ser auditada o seleccionada en AuditorIA. Sirve para asociar llamadas, chats, auditorias manuales, filtros y reportes con una persona, aunque esa persona no tenga una cuenta para iniciar sesion.
No lo confundas con un usuario. Un usuario con acceso entra a AuditorIA con login, rol, permisos y campanas asignadas. Un operador local puede existir sin usuario cuando solo hace falta identificar a la persona auditada.
Antes de empezar
Antes de crear o modificar operadores, revisa estos datos:
| Dato | Para que se usa |
|---|---|
| ID de operador | Identifica a la persona en llamadas, chats, auditorias y reportes. Es el dato mas importante. |
| Nombre y apellido | Ayudan a reconocer al operador en listas, selectores y reportes. |
| Permite completar el perfil y, si corresponde, dar de alta la cuenta en Keycloak. | |
| ID de origen | Referencia externa de CRM, integracion o sistema de origen, si existe. |
| Origen | Indica de donde viene el registro. Debe usar un origen reconocido por la plataforma. |
Las opciones visibles dependen de permisos. Si no ves Gestion de equipo, Operadores, Crear operador, editar, eliminar o Dar de alta en Keycloak, pedi que revisen tu rol y permisos.
Entrar a operadores locales
- En el menu lateral, abri Gestion de equipo.
- Entra a Operadores.
La pantalla muestra operadores locales pendientes de sincronizacion con Keycloak. En la practica, son operadores que existen en la tabla local de AuditorIA y todavia no estan vinculados a una cuenta de acceso.
Entender la lista
La tabla resume los datos principales de cada operador:
| Columna | Que muestra |
|---|---|
| Operator ID | ID funcional del operador. |
| Nombre | Nombre y apellido guardados en el perfil local. |
| Correo asociado al operador, si existe. | |
| Source ID | ID externo del sistema de origen, si existe. |
| Origen | Fuente del registro. |
| Creado | Fecha de creacion del registro local. |
| Acciones | Editar o eliminar, si tenes permisos. |
El contador superior indica cuantos operadores locales aparecen con los filtros actuales.
Buscar y filtrar operadores
Usa el buscador cuando tenes un dato parcial del operador. Para busquedas mas exactas:
- Abri el selector Busqueda.
- Elegi el campo: User ID, Nombre, Apellido, Email u Origen.
- Escribi el valor.
- Usa Aplicar.
- Usa Limpiar para volver al listado sin filtros.
El boton de actualizacion vuelve a consultar la lista sin cambiar el filtro elegido.
Crear un operador local
Usa Crear operador cuando una persona debe aparecer en cargas, auditorias, filtros o reportes, pero no necesariamente necesita entrar a AuditorIA.
- Hace clic en Crear operador.
- Completa el ID de operador.
- Agrega nombre, apellido y email si los tenes.
- Completa ID de origen y Origen si el operador viene de un sistema externo o integracion.
- Guarda el registro.
Antes de crear un operador, buscalo por ID, nombre o email. Duplicar operadores puede partir el historial entre dos identidades distintas y afectar busquedas, auditorias y reportes.
Elegir el ID de operador
El ID de operador es el puente entre la persona y sus casos operativos. Ese valor se usa en llamadas, chats, auditorias manuales, reportes y, si la persona tambien tiene cuenta, como operator_id del usuario.
Usa el mismo ID cuando:
- la persona ya tiene llamadas o chats historicos con ese operador;
- el operador aparece en reportes o auditorias previas;
- la persona va a tener usuario para ver sus propios casos o devoluciones;
- una integracion externa ya envia ese ID.
No inventes un ID nuevo para resolver un problema de acceso. Primero revisa si la persona ya existe como operador local o como usuario con acceso.
Cambiar el ID de un operador existente puede estar bloqueado si ya tiene llamadas, chats o auditorias asociadas. Si el sistema no permite cambiarlo, no es un error casual: esta evitando separar una identidad de su historial.
Abrir el detalle del operador
Hace clic sobre una fila para abrir el panel lateral del operador. Desde ahi podes revisar:
- ID de operador;
- fecha de creacion y ultima actualizacion;
- nombre;
- email;
- ID de origen;
- origen.
Tambien podes copiar el ID, editar el perfil, cerrar el panel o iniciar el alta en Keycloak si corresponde.
Editar datos del operador
Usa Editar cuando necesites corregir datos del perfil local:
- nombre;
- apellido;
- email;
- ID de origen;
- origen;
- URL del avatar;
- ID de operador, solo si corresponde y el sistema lo permite.
La edicion corrige el registro local del operador. No cambia por si sola roles, permisos ni campanas de una cuenta de acceso. Esos datos pertenecen al usuario en Keycloak y se administran desde Gestionar usuarios con acceso.
El campo Origen representa la fuente del registro, como internal, api-external, net2phone, neotel, anura, sftp o s1-gateway. Si no estas seguro de que valor usar, confirma primero como ingresa ese operador al sistema.
Dar de alta en Keycloak
Si un operador local tambien necesita entrar a AuditorIA, podes iniciar el alta desde el panel lateral con Dar de alta en Keycloak.
Ese flujo crea una cuenta de acceso a partir del operador local. La pantalla reutiliza el ID del operador y completa los datos base; despues pide datos propios del usuario:
- contrasena inicial;
- rol;
- campanas;
- estado activo;
- email verificado.
Despues de crear la cuenta, esa persona deja de ser solo un operador local sin Keycloak y pasa a tener usuario con acceso. A partir de ahi, roles, campanas, contrasena y permisos se mantienen desde Gestionar usuarios con acceso.
No uses este flujo para crear otra identidad de la misma persona. Si el operador ya tiene historial, conserva el mismo ID de operador para que llamadas, chats, auditorias y reportes sigan apuntando a la misma persona.
Eliminar un operador
Usa Eliminar solo cuando el operador fue creado por error y no deberia quedar disponible.
La eliminacion intenta borrar el operador de la tabla local. Puede fallar si el operador tiene dependencias, como auditorias, chats o llamadas asociadas.
No elimines operadores como limpieza normal de historico. Si el operador ya tiene actividad, eliminarlo puede afectar trazabilidad o quedar bloqueado por el sistema. Si el problema es que la persona necesita acceso, usa Dar de alta en Keycloak o revisa el usuario existente.
Relacion con usuarios con acceso
Usa esta regla practica:
| Situacion | Que hacer |
|---|---|
| La persona solo debe ser auditada o seleccionada | Mantener o crear operador local. |
| La persona debe entrar a AuditorIA | Dar de alta en Keycloak o crear usuario con el mismo ID de operador. |
| La persona ya tiene usuario y no ve sus casos | Revisar operator_id, campanas asignadas y rol en el usuario. |
| La persona aparece duplicada en reportes | Revisar si existen dos operadores con IDs distintos para la misma persona. |
| No aparece en un selector de carga o auditoria | Verificar que exista como operador local y que el filtro de campana permita verlo. |
Problemas frecuentes
No veo Operadores
Tu usuario no tiene la ruta o feature necesaria para administrar operadores. Pedi que revisen el rol en Roles, permisos y opciones visibles.
No puedo crear operador
Puede faltar un dato obligatorio, puede existir otro operador con el mismo ID o email, o puede faltar permiso de edicion.
No puedo dar de alta en Keycloak
El operador debe tener nombre, apellido, email y un ID numerico valido. Tambien necesitas permisos para crear la cuenta en Keycloak.
El operador no aparece para cargar un audio
Primero verifica que exista como operador local. Si el usuario que carga tiene visibilidad global de operadores, el selector puede mostrar operadores de forma independiente de la campana. Si no tiene esa visibilidad, la lista depende de la campana elegida y puede quedar vacia hasta seleccionar una campana con operadores asociados.
Cambiar el ID falla
Si el operador ya tiene auditorias, chats o llamadas asociadas, el sistema puede bloquear el cambio de ID para no romper el historial.