Agregar/Eliminar Skills a Cola UCCX con Postman y JSON

El UCCX (Unified Contact Center Express), nos ofrece un API REST con el cual podemos realizar varias operaciones como consultar, crear, actualizar o eliminar diferentes componentes de nuestro Contact Center.

Este artículo muestra un pequeño ejemplo de cómo agregar o eliminar habilidades (skills) a una cola del UCCX, con Postman y JSON. Antes de empezar se requiere los siguientes datos:

Credenciales de un usuario administrador del UCCX.

Vamos a consultar las colas, para eso se creó una cola en el UCCX con el nombre CSQ_Demo, pero antes de realizar la consulta hay que completar la autenticación y algunos encabezados que se necesita para realizar la prueba.

Primero hay que seleccionar el método GET y luego introducir la URL donde vamos a realizar la solicitud, por ejemplo http://{{uccx-host}}/adminapi/csq, donde uccx-host es una variable en la pondremos el valor de la ip o nombre de dominio de nuestro servidor UCCX.

GET y URL en Postman

En Postman hay una pestaña debajo de la URL donde vamos a realizar la consulta que se llama Authorization, en esa parte vamos a seleccionar como tipo ‘Basic Auth’ y luego introducimos nuestro usuario y contraseña del UCCX, y luego presionamos el botón “Update Request”, eso nos va a generar un encabezado al GET de colas.

Imagen autenticación

El API del UCCX por defecto retorna las respuestas en XML, entonces para que nos devuelva la respuesta en JSON hay que agregar dos encabezados, uno con el nombre “Accept” y el valor “application/json” y el otro con el nombre “Content-Type” y el valor “application/json”, como la siguiente imagen.

Imagen encabezados

Cuando esos datos están listos, vamos a presionar el botón “Send”, eso nos va a retornar un JSON, con todas las colas de nuestro UCCX y sus propiedades.

Imagen Respuesta CSQs

Para agregar habilidades a la cola que se quiere actualizar, lo que hacemos es copiar el objeto de la cola, modificamos sus estructura con los cambios que queremos actualizar y luego realizamos un PUT a la URL que está en la propiedad self de la cola. En nuestro caso vamos a agregar 2 habilidades nuevas, entonces buscamos la propiedad “poolSpecificInfo.skillGroup.skillCompetency”, si no exite la lista, la creamos, luego por cada habilidad que vamos a agregar tenemos que crear un objeto dentro de dicha lista con las propiedades: * competencelevel: número del 1 al 10. * skillNameUriPair*: Objeto con el nombre(@name) y la URL(refURL) de la habilidad. * weight: Peso de la habilidad, por defecto es “1”.

Imagen con el body del PUT

Cuando ya tenemos el objeto de la cola con todas la habilidades que queremos, presionamos el botón “Send”, y si el código de la respuesta es un 200, la cola ha sido actualizada, podemos volver a ejecutar el GET de colas que anteriormente realizamos y veremos los cambios.

Imagen resultado

Para eliminar una habilidad, es el mismo proceso pero al momento de actualizar la cola, lo que hacemos es quitar las habilidades que no queremos que tenga esa cola.

*En algunos API del UCCX, puede dar el error “Invalid Link” al momento de actualizar, eso se debe a que el JSON de la parte del “skillNameUriPair”, debe ir primero la propiedad “@name” y luego “refURL”