Diferencia entre revisiones de «VIVAit Tracker»

De VIVAitwiki
Ir a la navegaciónIr a la búsqueda
Línea 347: Línea 347:
 
===== Búsqueda por Teléfono en el filtro de VIVAit Tracker 5.1 =====
 
===== Búsqueda por Teléfono en el filtro de VIVAit Tracker 5.1 =====
 
<br><br>
 
<br><br>
En este área se encuentran los campos que permiten realizar una búsqueda según los dígitos que aparecen en las columnas ''Origen'' y/o ''Destino'' del área de resultados de la búsqueda.<br>
+
En este área se encuentra el campo que permiten realizar una búsqueda según los dígitos que aparecen en las columnas ''Origen'' y/o ''Destino'' del área de resultados de la búsqueda.<br>
Este campo no es obligatorio:<br>
+
- Este campo no es obligatorio.<br>
- Si no se rellena no se filtra por origen ni destino.<br>
+
- Los caracteres permitidos son los dígitos 0 a 9, * y #.<br>
- El contenido indican los dígitos que deben aparecer en número origen y número destino en cualquier posición.<br>
+
- Se pueden utilizar de 1 carácter en adelante.<br>
- Si solo se cumplimenta el campo hora final se buscan las llamadas hasta esa hora.<br>
+
- La posición de los caracteres definen la búsqueda.<br>
- Si se rellenan los dos campos la búsqueda proporcionará las llamadas comprendidas entre ambas horas.  
+
- La búsqueda se realiza tanto en las llamadas como en los segmentos asociados. <br>
 +
- La gestión de los caracteres es totalmente manual.
 
<br><br>
 
<br><br>
 
<div style="text-align: center;">
 
<div style="text-align: center;">
Línea 358: Línea 359:
 
! style = "background-color:#0099ff; color:#ffffff" | <big><center>'''''Advertencia'''''</center></big>
 
! style = "background-color:#0099ff; color:#ffffff" | <big><center>'''''Advertencia'''''</center></big>
 
|-
 
|-
|style="margin: 0 auto; padding: 0.3cm;" | Los resultados del rango de horas pueden estar condicionados por otro campo del filtro.  
+
|style="margin: 0 auto; padding: 0.3cm;" | Los resultados del número de teléfono pueden estar condicionados por otro campo del filtro.  
 
|}
 
|}
 
</div>
 
</div>
 
<br><br>
 
<br><br>
[[File:rango_horas_tracker_V5.1.png|1500px|center|thumb]]
+
[[File:número_teléfono_tracker_V5.1.png|1500px|center|thumb]]
<br><br>
 
Estos campos se pueden rellenar manualmente editando el indicador ''--:--'' con el formato ''hh:mm'', o bien realizando la elección de la hora en el reloj que se muestra en la parte derecha de cada campo.
 
<br><br>
 
[[File:reloj_tracker_V5.1.png|1500px|center|thumb]]
 
<br><br>
 
Las particularidades de este calendario son:<br>
 
- La primera opción que se muestra es la hora actual.<br>
 
- La columna de la izquierda permite una selección circular de las horas, de 00 a 23.<br>
 
- La columna de la derecha permite una selección circular de los minutos, de 00 a 59.
 
 
<br><br>
 
<br><br>
 
<div style="text-align: center;">
 
<div style="text-align: center;">
Línea 377: Línea 369:
 
! style = "background-color:#0099ff; color:#ffffff" | <big><center>'''''Aviso'''''</center></big>
 
! style = "background-color:#0099ff; color:#ffffff" | <big><center>'''''Aviso'''''</center></big>
 
|-
 
|-
|style="margin: 0 auto; padding: 0.3cm; text-align: left;" | En la versión actual:<br>
+
|style="margin: 0 auto; padding: 0.3cm; text-align: left;" | En la versión actual no es posible separar el origen del destino en la búsqueda utilizando este campo.<br>
- si se configura la hora final anterior a la hora inicial no se obtiene ningún resultado.<br>
 
- si no se complementa correctamente los valores, solo minutos por ejemplo, no se tiene en cuenta el campo,<br>
 
- el borrado de valores debe hacerse manualmente.
 
 
|}
 
|}
 
</div>
 
</div>
<br><br>
 
[[File:rango_fechas_mal_tracker_V5.1.png|1500px|center|thumb]]
 
 
<br><br>
 
<br><br>
 
[[#Descripción de la interfaz de VIVAit Tracker 5.1 | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/VIVAit_Tracker Volver al índice]
 
[[#Descripción de la interfaz de VIVAit Tracker 5.1 | Volver arriba]] / [https://vivait-wiki.mdnova.local/wiki/vivait/index.php/VIVAit_Tracker Volver al índice]

Revisión del 14:37 30 dic 2025

Producto: VIVAit Call v5.1

VIVAit Suite



1 Introducción a VIVAit Tracker 5.1



Con la versión 5.1 de la plataforma VIVAit Call se ha lanzado un nuevo tracker: VIVAit Tracker, que supone una mejora sobre el producto anterior: Tracker WEB más enfocado al mundo Call Center.
Los puntos claves del nuevo portal VIVAit Tracker dirigido al entorno corporativo son:

• Adaptación para facilitar su uso en entornos de telefonía corporativa.
• Permite seguir llamadas y escuchar/descargar grabaciones en caso de existir.
• Integrado con entornos de texto (TBC y desarrollos futuros).



Volver arriba / Volver al índice

1.1 Arquitectura de VIVAit Tracker 5.1



Los bloque funcionales, servicios y elementos que componen la aplicación están divididos en dos capas principales:

- Frontend
Reside en un servidor web Apache.
Se invoca desde un navegador mediante una URL del tipo https://host/ws/
       https://172.25.128.252/Tracker_Corporativo/
Es la parte visual: HTML, CSS, JavaScript.
No accede directamente a la base de datos; solo obtiene datos desde una API.



- Backend / API REST
Corre en un servidor web Tomcat.
Expone la API en:
       https://172.25.128.252/Tracker-Rest/tracker/.
Contiene la lógica que permite interactuar con la BBDD.
Responde en JSON para que el frontend pueda ofrecérselo al navegador.



Diagrama funcional de la arquitectura de VIVAit Tracker 5.1

Arquitectura3 tracker V5.1.png



Volver arriba / Volver al índice

1.1.1 Flujo completo del ciclo de datos



Siguiendo el proceso se contemplan los siguientes pasos:

Paso 1 El usuario invoca el frontend residente en Apache desde un navegador, usando javascript, mediante la URL del tipo:

       https://host/Traker_Corporativo/

El navegador carga la página web servida por Apache.

Paso 2 Una vez superada la fase de validación se muestra un formulario que permite al usuario definir los parámetros de una consulta.

La página del formulario inicia una transacción para efectuar una solicitud HTTP POST al endpoint correspondiente, por ejemplo:
               https://172.25.128.252/Tracker_Corporativo/
siendo la carga util de esta solicitud los datos del formulario rellenado por el usuario:
               {fechaInicio: "", fechaFin: "", horaInicio: "", horaFin: "", listaExtensiones: [], listaGrupos: [],…}          



Paso 3 Al recibir los datos del formulario el frontend hace una petición a la API REST de Tomcat.



Paso 4 La API se conecta a la base de datos, ejecuta las consultas necesarias y devuelve la respuesta.



Paso 5 El frontend recibe el JSON con los datos de la consulta en la respuesta:

               POST https://172.25.128.252/Tracker-Rest/tracker/lista
El navegador lo representa en pantalla. En ningún momento el navegador accede directamente a la base de datos; todo pasa por la API.



Volver arriba / Volver al índice

1.2 Seguridad de VIVAit Tracker 5.1



El acceso está controlado mediante validación de tokens.

Paso 1 Autenticación inicial

• Al introducir sus credenciales el usuario se valida a través del servicio de autenticación sercen
               https://172.25.128.252/sercen/postautenticar1
• Sercen genera un token firmado que identifica la sesión del usuario.



Paso 2 Validación interna de permisos

• Una vez que el frontend tiene el token, cada petición pasa por una validación de la API del tomcat:
               https://172.25.128.252/Tracker-Rest/tracker/verificarToken
En la misma se comprueba que:
- El token es válido.
- El usuario tiene permisos para el recurso que está intentando usar.
Es necesario que el usuario tenga acceso a la aplicación Grabador, ver Usuarios.
• No se ejecuta ninguna acción si el token no es validado primero.



Paso 3 Proxy inverso apache-tomcat

• Apache actúa como punto de entrada único:
- El usuario solo ve URLs de apache.
- Las peticiones que requieren lógica del backend se redirigen internamente a tomcat.
- Esto se consigue mediante proxy inverso, por ejemplo:
/Tracker_Corporativo → servido por apache
               https://172.25.128.252/Tracker_Corporativo/
/Tracker-Rest → Apache las pasa a Tomcat de forma transparente para el usuario
               https://172.25.128.252/Tracker-Rest/tracker/extensiones
• El navegador utilizado por el usuario nunca ve a tomcat.



Volver arriba / Volver al índice

2 Descripción de la interfaz de VIVAit Tracker 5.1



La aplicación de VIVAit Tracker 5.1 tiene dos página web:

- La página de validación, donde se piden las credenciales al usuario,
- La página de trabajo, donde se realizan todas las acciones referentes a la funcionalidad suministrada.

Volver arriba / Volver al índice

2.1 Inicio de sesión en VIVAit Tracker 5.1



El acceso a la aplicación VIVAit Tracker se hace a través de un navegador con un enlace de la siguiente forma:

https://host/Tracker_Corporativo/



donde "host" será el nombre o dirección IP del servidor en el que está instalada la aplicación VIVAit Tracker.



Ejemplo:

https://172.25.128.92/Tracker_Corporativo/



A continuación aparece una ventana donde es necesario autentificarse mediante las credenciales correspondientes:

- Usuario: sera un usuario creado en el sistema con los permisos de acceso a la aplicación Grabación,
- Contraseña: el password asociado a este usuario.



Nota
Tener acceso a la aplicación Grabación no impide que el usuario tenga también otras funcionalidades, como movilidad corporativa o agente ACD.



Login tracker V5.1.png



Al utilizar el botón Entrar V5.png se pueden dar distintas situaciones posibles, con resultados diferentes, según se hayan cumplimentados los campos Usuario y Contraseña.

1. Inicio de sesión sin credenciales
2. Inicio de sesión con credenciales válidas
3. Inicio de sesión con credenciales inválidas
4. Inicio de sesión sin permisos



2.1.1 Inicio de sesión sin credenciales



Si no se han rellenado los campos Usuario y Contraseña aparece la siguiente ventana informando de la situación:

Login sin tracker V5.1.png



Volver arriba / Volver al índice

2.1.2 Inicio de sesión con credenciales válidas



Si las credenciales introducidas son correctas se abre la ventana que permite el uso de la aplicación Tracker.


Acceso tracker V5.1.png



Volver arriba / Volver al índice

2.1.3 Inicio de sesión con credenciales inválidas



Si las credenciales no son válidas aparece un mensaje informativo:

Login mal tracker V5.1.png

Es necesario realizar un nuevo intento introduciendo un usuario válido y una contraseña correcta.

Volver arriba / Volver al índice

2.1.4 Inicio de sesión sin permisos



Si el usuario no tiene acceso a la aplicación Grabación aparece una ventana informativa.

Sin permisos tracker V5.1.png

Es necesario informar al administrador del sistema VIVAit Call para que asigne al usuario los permisos adecuados.

Volver arriba / Volver al índice

2.2 Interfaz de trabajo de VIVAit Tracker 5.1



Una vez que el usuario ha iniciado sesión con éxito la ventana que se muestra se divide en varías áreas:

1. Logo del portal
2. Área de usuario
3. Área de filtro
4. Botones de acción
5. Resultados de la búsqueda



Menú general tracker V5.1.png



Volver arriba / Volver al índice

2.2.1 Área del Logo del portal de VIVAit Tracker 5.1



Muestra el logotipo que identifica la aplicación Tracker y una breve descripción de la misma.

Logo tracker V5.1.png



Volver arriba / Volver al índice

2.2.2 Área de Usuario de VIVAit Tracker 5.1



En esté área se encuentra tres funciones descritas, de izquierda a derecha, de la siguiente forma:

Cambio de idioma de la interfaz, en este momento valores posibles son: ES = español, EN = inglés.
Ocultar / Mostrar área de filtro, útil para liberar espacio en la pantalla para analizar los datos una vez realizada la consulta.
Cerrar sesión, permite cerrar sesión del usuario actual. Aparece la pantalla que pide credenciales.



Usuario tracker V5.1.png



Volver arriba / Volver al índice

2.2.3 Área de filtro de VIVAit Tracker 5.1



En este espacio se encuentran los campos que permiten configurar el filtro de búsqueda de datos en la BBDD.

Filtros tracker V5.1.png



Los campos que se encuentran en este área son:

• 1 - Rango de Fechas, contienen las fechas que delimitan la búsqueda.
• 2 - Rango de Horas, contienen delimitan horaria en la búsqueda.
• 3 - Búsqueda por Teléfono, indica que dígitos aparecen en los campos origen o/y destino para que se muestre el registro.
• 4 - Límite, se indica la cantidad de registros (segmentos) que se mostraran. La cantidad de llamadas mostradas está supeditada a la cantidad de segmentos.
• 5 - Extensiones, permite realizar la búsqueda basada en las extensiones configuradas en el sistema.
• 6 - Grupos, permite realizar la búsqueda basada en los grupos corporativos configurados en el sistema..
• 7 - Tipo de Llamada, permite realizar la búsqueda según el tipo de llamada.
• 8 - Estado de Grabación, este filtro añade el componente del estado de la grabación de la llamada.



Los filtros no son excluyentes, sino acumulativos. Por ello es necesario usarlos con prudencia ya que pueden ocultar el resultado de la busqueda.

Filtros números tracker V5.1.png



Definición
En Asterisk, una llamada es la comunicación lógica completa que se establece entre un origen y un destino, aunque durante su curso pueda atravesar distintos elementos del enrutamiento (colas, transferencias, grupos de timbrado, IVR, etc.) e incluso generar derivaciones o “ramas” (por ejemplo, para grabación o monitorización). Un segmento es cada tramo individual de esa llamada: una conexión concreta entre dos puntos del recorrido (o una rama paralela) que representa una parte específica del flujo; por eso, una misma llamada puede estar compuesta por varios segmentos consecutivos y/o simultáneos.



Nota
Algunas llamadas pueden no tener segmentos. Como es el caso de las llamadas de facilidades.



Volver arriba / Volver al índice

2.2.3.1 Rango de Fechas en el filtro de VIVAit Tracker 5.1



En este área se encuentran los campos que permiten realizar una búsqueda según una fecha inicial y/o una fecha final.
Ninguno de los campos es obligatorio:
- Si no se rellena ninguno de estos campos no se filtra por fecha.
- Si solo se cumplimenta el campo fecha inicial se obtendrán las llamadas realizadas desde ese día.
- Si solo se cumplimenta el campo fecha final se buscan las llamadas hasta esa fecha.
- Si se rellenan los dos campos la búsqueda proporcionará las llamadas comprendidas entre ambas.

Advertencia
Los resultados del rango de fechas pueden estar condicionados por otro campo del filtro.



Rango fechas tracker V5.1.png



Estos campos se pueden rellenar manualmente editando el indicador dd/mm/aaaa, o bien realizando la elección de la fecha en el calendario que se muestra en la parte derecha de cada campo.

Calendario tracker V5.1.png



Las particularidades de este calendario son:
- Permite elegir el día actual mediante el enlace Hoy.
- Permite borrar el contenido del campo mediante el botón Borrar.
- No permite configurar una fecha posterior al día actual.

Aviso
En la versión actual, si se configura la fecha final anterior a la fecha inicial no se obtiene ningún resultado.



Rango fechas mal tracker V5.1.png



Volver arriba / Volver al índice

2.2.3.2 Rango de Horas en el filtro de VIVAit Tracker 5.1



En este área se encuentran los campos que permiten realizar una búsqueda según una hora inicial y/o una hora final.
Ninguno de los campos es obligatorio:
- Si no se rellena ninguno de estos campos no se filtra por hora.
- Si solo se cumplimenta el campo hora inicial se obtendrán las llamadas realizadas desde esa hora.
- Si solo se cumplimenta el campo hora final se buscan las llamadas hasta esa hora.
- Si se rellenan los dos campos la búsqueda proporcionará las llamadas comprendidas entre ambas horas.

Advertencia
Los resultados del rango de horas pueden estar condicionados por otro campo del filtro.



Rango horas tracker V5.1.png



Estos campos se pueden rellenar manualmente editando el indicador --:-- con el formato hh:mm, o bien realizando la elección de la hora en el reloj que se muestra en la parte derecha de cada campo.

Reloj tracker V5.1.png



Las particularidades de este calendario son:
- La primera opción que se muestra es la hora actual.
- La columna de la izquierda permite una selección circular de las horas, de 00 a 23.
- La columna de la derecha permite una selección circular de los minutos, de 00 a 59.

Aviso
En la versión actual:

- si se configura la hora final anterior a la hora inicial no se obtiene ningún resultado.
- si no se complementa correctamente los valores, solo minutos por ejemplo, no se tiene en cuenta el campo,
- el borrado de valores debe hacerse manualmente.



Rango fechas mal tracker V5.1.png



Volver arriba / Volver al índice

2.2.3.3 Búsqueda por Teléfono en el filtro de VIVAit Tracker 5.1



En este área se encuentra el campo que permiten realizar una búsqueda según los dígitos que aparecen en las columnas Origen y/o Destino del área de resultados de la búsqueda.
- Este campo no es obligatorio.
- Los caracteres permitidos son los dígitos 0 a 9, * y #.
- Se pueden utilizar de 1 carácter en adelante.
- La posición de los caracteres definen la búsqueda.
- La búsqueda se realiza tanto en las llamadas como en los segmentos asociados.
- La gestión de los caracteres es totalmente manual.

Advertencia
Los resultados del número de teléfono pueden estar condicionados por otro campo del filtro.



Número teléfono tracker V5.1.png



Aviso
En la versión actual no es posible separar el origen del destino en la búsqueda utilizando este campo.



Volver arriba / Volver al índice

2.2.3.4 Límite en el filtro de VIVAit Tracker 5.1



En este espacio se encuentran los campos que permiten configurar el filtro de búsqueda de datos en la BBDD.

Filtros tracker V5.1.png



A continuación se muestran los diferentes campos y su forma de utilización.

Volver arriba / Volver al índice

2.2.3.5 Extensiones en el filtro de VIVAit Tracker 5.1



En este espacio se encuentran los campos que permiten configurar el filtro de búsqueda de datos en la BBDD.

Filtros tracker V5.1.png



A continuación se muestran los diferentes campos y su forma de utilización.

Volver arriba / Volver al índice

2.2.3.6 Grupos en el filtro de VIVAit Tracker 5.1



En este espacio se encuentran los campos que permiten configurar el filtro de búsqueda de datos en la BBDD.

Filtros tracker V5.1.png



A continuación se muestran los diferentes campos y su forma de utilización.

Volver arriba / Volver al índice

2.2.3.7 Tipo de Llamada en el filtro de VIVAit Tracker 5.1



En este espacio se encuentran los campos que permiten configurar el filtro de búsqueda de datos en la BBDD.

Filtros tracker V5.1.png



A continuación se muestran los diferentes campos y su forma de utilización.

Volver arriba / Volver al índice

2.2.3.8 Estado de Grabación en el filtro de VIVAit Tracker 5.1



En este espacio se encuentran los campos que permiten configurar el filtro de búsqueda de datos en la BBDD.

Filtros tracker V5.1.png



A continuación se muestran los diferentes campos y su forma de utilización.

Volver arriba / Volver al índice

2.2.4 Botones de acción de VIVAit Tracker 5.1



La tabla que se muestra a continuación detalla la jerarquía de menús y submenús del portal de administración, e incluye enlaces directos a las respectivas secciones:



Volver arriba / Volver al índice

2.2.5 Resultados de la búsqueda en VIVAit Tracker 5.1



La tabla que se muestra a continuación detalla la jerarquía de menús y submenús del portal de administración, e incluye enlaces directos a las respectivas secciones:



Volver arriba / Volver al índice

3 Utilización de VIVAit Tracker



La tabla que se muestra a continuación detalla la jerarquía de menús y submenús del portal de administración, e incluye enlaces directos a las respectivas secciones:



Volver arriba / Volver al índice




FIN



FIN



FIN



FIN



FIN



FIN



FIN



FIN



FIN



FIN



FIN