Cómo administrar agentes de cables a través de la API REST

Hola a todos, soy Pedro Martínez, y hoy os traigo: :

Cómo administrar agentes de cables a través de la API REST

Publicado el 14 de octubre de 2020

En esta publicación, le mostraremos cómo puede usar la API REST de Centralitasbaratas.espara unirse a todos los agentes o dejar la cola seleccionada. Normalmente, las agencias pueden unirse o salir de la cola marcando el código de servicio #423* o #424* respectivamente o con el panel de configuración de Softphone. En algunas situaciones, sin embargo, puede resultar beneficioso automatizar este proceso realizando la tarea programada. Cómo crear una tarea programada queda fuera del alcance de este artículo, pero hay una amplia documentación y tutoriales disponibles sobre este tema.

Instalar NodeJS

Nota: Si ya tiene NodeJS instalado en su computadora, puede omitir esta sección y continuar con “Obtenga el código de cliente API” a continuación.

Centralitasbaratas.esREST API es una interfaz agnóstica del lenguaje de programación disponible a través del protocolo HTTP. Por tanto, se puede utilizar cualquier herramienta de secuencia de comandos que pueda realizar solicitudes HTTP. Elegimos JavaScript para este ejemplo, ya que rápidamente se convierte en el lenguaje de programación común en muchos entornos. Como requisito previo, deberá instalar NodeJS en su computadora para ejecutar el código de cliente API de JavaScript desde la ventana del terminal o como una tarea programada. La instalación de NodeJS está fuera del alcance de este manual, pero en general debería ser tan simple como descargar e instalador para su plataforma.

Una vez que NodeJS esté instalado, puede asegurarse de que funcione correctamente. Abra la ventana del terminal (en Windows, inicie el menú Inicio y ejecute “Símbolo del sistema”) y ejecútelo:

node -v

debe aparecer como se muestra a continuación (el número de versión puede variar):

v8.12.0

Obtenga el código de cliente API

El código JavaScript de API Client para este tutorial está disponible en GitHub. Puedes usarlo git para clonar el código, o simplemente descargar ultima versión como .zip archivar y descomprimir en su computadora. Una vez que hayamos obtenido el código, podemos intentar ejecutarlo. En la ventana de terminal, ejecute:

cd queue-api
node queue.js

debe proporcionar salidas de la siguiente manera:

Error: Centralitasbaratas.esAPI credentials file [api.credentials] not found

Este mensaje de error esperado es necesario porque antes de que podamos usar el código de cliente API, necesitamos obtener referencias API y guardarlo en el archivo ‘api.credentials’.

Obtenga referencias de API

Necesitamos guardar las referencias de API en un archivo de texto en la misma carpeta donde queue.js el archivo es. Abra cualquier editor de texto (como el Bloc de notas en Windows) para que podamos copiar / pegar los datos que obtenemos cuando seguimos las instrucciones de esta sección. Para iniciar sesión con las credenciales de API en su cuenta de Centralitasbaratas.es, nota: debe ser uno de los administradores y siga los pasos a continuación:

1. Cambie al panel de administración.
2. Abra el panel de usuario.
Haga clic en el icono “Editar” junto a una de las cuentas de administrador.
4. Cambie a la pestaña Avanzado.
5. Cópielo en el “ID de usuario de API” del portapapeles y luego péguelo en el procesador de texto. Siga el ID de usuario con “:”, de modo que el contenido del editor de texto se vea así: 10001: (su ID de usuario de API será, por supuesto, un número diferente).
6. Ingrese el nombre de su clave API. Puede ser cualquier cosa: usaremos ‘Tarea de cuerda’.
7. Seleccione ’30 días ‘como tiempo de espera. Si su clave API no se usa dentro de los 30 días, automáticamente dejará de ser válida por razones de seguridad.
8. Haga clic en “Agregar” para generar la clave API.
9. Busque la clave API que acabamos de agregar a la lista y haga clic en el icono “Llave inglesa” y seleccione “Mostrar detalles” en el menú contextual.
10. Copie la clave API en el portapapeles y péguela en el editor de texto. El contenido del editor de texto ahora debería verse así:

10001:abcdef1234567890abcdef0987654321

Nota: el número de ID de usuario de API y la clave de API serán diferentes para usted. Lo anterior es solo texto de muestra que no es una clave API válida.

Guarde este archivo de texto ahora como api.credentials archivo en la misma carpeta donde queue.js el archivo es.

Inserte el código

Ahora deberíamos estar listos para ejecutar el código. En el siguiente ejemplo, usamos ‘EST support’ como nombre de espera, pero por supuesto, usará el nombre de la lista de espera que existe en su cuenta de Centralitasbaratas.es. Abramos la ventana de terminal y ejecútelo:

cd queue-api
node queue.js

Lo anterior debería producir resultados:

This script allows to make all Agents in selected Queue join or leave

Usage: queue.js '<Queue Name>' <join|leave>

El mensaje anterior indica que la secuencia de comandos se reconoció correctamente api.credentials archivo que hicimos en el paso anterior. Sin embargo, el script requiere dos parámetros:

* ‘Nombre del carro’, que es nuestro ejemplo, será ‘Soporte EST’
* Unirnos o salirnos, según la operación que queramos realizar.

Así que intentemos que todos los agentes de soporte de EST estén en línea:

node queue.js 'EST Support' join

Esta vez la salida es:

2 Agents has joined queue "EST Support"

y de manera similar podemos hacer que todos los agentes salgan de la cola de ‘Soporte EST’ mediante:

node queue.js 'EST Support' leave

quien regresa:

2 Agents has left queue "EST Support"

Para automatizar el funcionamiento de la entrada y salida de la agencia, solo es necesario configurar la tarea programada que se realiza node queue.js 'EST Support' leave o node queue.js 'EST Support' join en determinados momentos del día y días de la semana.

Y eso ha sido todo por hoy,, agradezco que lo compartas si te ha gustado