Configuración de eTickets en una suscripción

Configuración de eTickets en una suscripción

En este articulo conocerás la manera en la que podrás configurar el portal de tickets (eTickets) en cualquier suscripción de Kaelia.

Info
Introducción
eTickets es el portal de atención al colaborador adaptable a las necesidades de cada empresa pudiendo configurarse, por ejemplo, como un portal para la atención de dudas de nomina o un portal de atención de tickets del área de TI. El portal de tickets maneja una vista de tipo KANBAN la cual muestra tres estatus principales Rechazado, Aprobado, Pendiente los cuales son 100% configurables además que cuenta con la funcionalidad de crear los distintos Tópicos acorde a las necesidades de la compañía. Finalmente es importante mencionar que es posible elegir entre dos tipos de perfiles acorde a el papel que jugara cada colaborador ya sea Operador (perfil enfocado en ser el encargado de responder tickets) y Solicitante (colaborador que realiza solicitudes).

Warning
Importante
Se comparten las dos web API de configuración existentes de eTickets.


Alert
Creación de los botones dentro del autoservicio para el acceso del operador y del colaborador a eTickets
Para que los colaboradores y operadores puedan acceder a eTickets debes crear dos botones disponibles en el autoservicio siendo "Administrador" de la cuenta de Kaelia, uno será el acceso a operadores y otro el acceso a solicitantes.

      1. Creación de botón para operador de eTickets.
  1. Ingresa a la cuenta asegurándote que tengas un perfil de administrador.
  2. Ingresa al menú "Autoservicio".
  3. Localiza el botón que tiene el símbolo de engranaje con el nombre "Configuración General" y da clic en el.
  1. Viaja a la parte inferior del menú y localiza la opción "Agregar aplicación externa +", da clic para ingresar a la configuración.

  1. Realiza el llenado del formulario de la siguiente manera.

Restringir acceso: Activar el Checkbox.

Llave: eTickets_Operador (Sugerencia de nombre puede modificarse)

Etiqueta: eTickets Operador (Sugerencia de nombre puede modificarse)

Icono: fas fa-file-alt (El icono puede cambiarse utilizando el codigo adecuado del portal Fast Fa Icons)

URL: https://app.eTickets.Kaelia.mx/tickets/operador?SuscripcionID=id de la suscripción (Sustituye el texto "id de la suscripcion" por el id de la cuenta de Kaelia en la cual se configurara eTickets)



      2. Creación de botón para colaborador de eTickets.
  1. Ingresa a la cuenta asegurándote que tengas un perfil de administrador.
  2. Ingresa al menú "Autoservicio".
  3. Localiza el botón que tiene el símbolo de engranaje con el nombre "Configuración General" y da clic en el.
  1. Viaja a la parte inferior del menú y localiza la opción "Agregar aplicación externa +", da clic para ingresar a la configuración.

  1. Realiza el llenado del formulario de la siguiente manera.

Restringir acceso: Activar el Checkbox.

Llave: eTickets_Colaborador (Sugerencia de nombre puede modificarse)

Etiqueta: eTickets (Sugerencia de nombre puede modificarse)

Icono: fas fa-sticky-note (El icono puede cambiarse utilizando el código adecuado del portal Fast Fa Icons)

URL: https://app.eTickets.Kaelia.mx/tickets?SuscripcionID={{SuscripcionID}}&UsuarioID={{Perfil.usuario.usuarioID}} (Este enlace es dinámico para que pueda identificar correctamente un perfil de autoservicio a un perfil de administrador.)



Alert
Proceso de configuración
  1. Ingresar a la API de eTickets de producción.


      2.  Realiza la búsqueda del ENDPOINT GET /api/Suscripciones/{SuscripcionID}/Mantenimiento/ActualizaBD.
  1. Debes autenticarte con tu token de sesión dando clic en el candado abierto dentro del endpoint.
  2. En el campo de "SuscripcionID" deberás colocar el ID de la suscripción a la cual le deseas configurar el portal eTickets.
  3. El campo "Forzar" se mantendra con el valor "false".
  4. Da clic en el botón "Execute" para ejecutar el endpoint.
  5. Valida que obtuviste una respuesta 200 que indica que se realizo una ejecución adecuada.

      3. Realiza la configuración de los estatus que se mostraran en la vista KANBAN buscando el ENDPOINT POST /api/Suscripciones/{SuscripcionID}/EstadosTickets.
  1. Debes autenticarte con tu token de sesión dando clic en el candado abierto dentro del endpoint.
  2. En el campo de "SuscripcionID" deberás colocar el ID de la suscripción a la cual le deseas configurar los estados para el portal de tickets.
  3. Dentro del "Request Body" deberás seguir la siguiente configuración base:

{

  "linkID": "string", -> Colocar siempre el valor null sin las comillas dobles.

  "etiqueta": "string", -> Colocar el nombre del estado que deseas crear (Pendiente, Aprobado o Rechazado) dentro de las comillas dobles.

  "descripcion": "string", -> Colocar la descripción/funcionamiento del estado que estas creando dentro de las comillas dobles.

  "orden": 0, -> Siempre colocar 0.

  "cerrado": true, -> Elige el flujo del estado que estas creando, "true" significa que es un estado de finalización de una interacción y "false" significa que es un estatus de disponibilidad para seguir interactuando es decir un estatus abierto.

  "color": "string" -> Elige el color que el estado mostrara dentro de la vista KANBAN utilizando los códigos de color hexadecimales dentro de las comillas dobles.

}


Ejemplo de "Request Body" completo:

{

      "linkID": null,

      "etiqueta": "Aceptado",

      "descripcion": "Se ha autorizado la solicitud",

      "orden": 0,

      "cerrado": true,

      "color": "#2ECC71",

}
  1. Da clic en el botón "Execute" para ejecutar el endpoint.
  2. Valida que obtuviste una respuesta 200 que indica que se realizo una ejecución adecuada.
  3. Debes repetir este proceso uno por uno para cada estado que desees crear dentro del portal de tickets (Por ejemplo Pendiente, Abierto, Cerrado).


      4. Realiza la configuración del estado predeterminado buscando en ENDPOINT PUT /api/Suscripciones/{SuscripcionID}/EstadosTickets/{ID}/Predeterminado.
  1. Inicialmente debes conocer el identificador asignado de cada estado asigncuando fueron creados en el paso anterior, para lo cual deberás buscar el endpoint GET /api/Suscripciones/{SuscripcionID}/EstadosTickets.
  2. Debes autenticarte con tu token de sesión dando clic en el candado abierto dentro del endpoint.
  3. En el campo de "SuscripcionID" deberás colocar el ID de la suscripción de la cual deseas conocer el identificador de cada estado.
  4. Da clic en el botón "Execute" para ejecutar el endpoint.
  5. Valida que obtuviste una respuesta 200 que indica que se realizo una ejecución adecuada.

  1. Debes localizar el dato "id" que es el identificador de cada estado y elegir aquel que se considerara como predeterminado, es decir, cuando un nuevo ticket se cree por parte de un colaborador el mismo será asignado predeterminadamente a este estado.
  1. Para definir el estado predeterminado debes localizar el endpoint PUT /api/Suscripciones/{SuscripcionID}/EstadosTickets/{ID}/Predeterminado
  2. En el campo de "SuscripcionID" deberás colocar el ID de la suscripción en la que configuraremos el estado predeterminado.
  3. En el campo "ID" debes agregar el "id" del estado que elegiste como predeterminado anteriormente, por ejemplo "ET.22.rZAWPIE011.F1" que se muestra en la imagen anterior.
  4. Da clic en el botón "Execute" para ejecutar el endpoint.
  5. Valida que obtuviste una respuesta 200 que indica que se realizo una ejecución adecuada.

      5. Finalizaremos la configuración enlazando cada botón que creamos en el autoservicio para cada tipo de perfil (operador y colaborador) al portal de eTickets con lo cual conseguiremos brindar el nivel de acceso adecuado para cada uno de ellos y definir quien opera el portal y quien genera solicitudes.
  1. Identifica el ID del dispositivo asignado a cada botón del autoservicio ingresando al menú de "Dispositivos" dentro de Kaelia y localizando los botones previamente creados.
  1. Al dar clic a cada botón en la barra de direcciones de tu navegador localizaras el ID del dispositivo el cual inicia con el prefijo "Di", guarda ambos ID para finalizar la configuración.
  1. Localiza el endpoint POST /api/Suscripciones/{SuscripcionID}/Propiedades/NivelesAccesos/Config.
  2. Debes autenticarte con tu token de sesión dando clic en el candado abierto dentro del endpoint.
  3. En el campo de "SuscripcionID" deberás colocar el ID de la suscripción de la cual configuraremos los Niveles de Acceso.
  4. Dentro del "Request Body" deberás seguir la siguiente configuración base:

{

  "administrador": "string", -> Agrega el ID del botón configurado previamente en el autoservicio como operador del portal eTickets

  "colaborador": "string", -> Agrega el ID del botón configurado previamente en el autoservicio como colaborador del portal eTickets.

  "token": "string", -> Solicita a un colaborador dentro de Kaelia que tenga un perfil "Super Admin" te ayude a genera un APPID y un TOKEN para ligarlo a esta aplicacion.

  "mostrarAdministradores": true -> Si es true se mostrara para los colaboradores el nombre del operador que ha respondido su solicitud, si es false se anonimizara el nombre del operador.

}


Ejemplo de "Request body" completo:

{

  "administrador": "Di.sI3.u...........",

  "colaborador": "Di.sI3.Utz...........",

  "token": "eyJMbGF2ZSI6ImdvM..............",

  "mostrarAdministradores": false

}

  1. Da clic en el botón "Execute" para ejecutar el endpoint.
  2. Valida que obtuviste una respuesta 200 que indica que se realizo una ejecución adecuada.

Warning
Importante.
  1. Una vez completado el proceso anterior deberás brindar acceso a cada colaborador y cada operador al botón que le corresponda acorde a su nivel de acceso, desde la sección de "Accesos" dentro del perfil del colaborador.
  1. Los tópicos para los tickets se deben crear por el Operador/Administrador directamente dentro de eTickets.
  2. Si quieres dar seguimiento al uso del portal de tickets puedes leer el siguiente articulo, ¿Como puedo hacer uso del portal de Solicitudes y Aclaraciones dentro de Kaelia?