Widget-aheeva

Flujo del widget.

Aheeva es el proveedor del servicio de telefonía, con el cual podemos realizar llamadas telefónicas a los clientes. Al llegar a una tarea donde se encuentre el widget, siempre aparecerá con el contorno en color gris, lo que indica que no se ha utilizado aun, cuando se intenta realizar una llamada, el color del contorno cambiara a color azul y finalmente si se esta intentando enlazar o ya se enlazo una llamada el contorno del widget cambiara a color verde, lo que indica que existe una llamada activa. En caso de que exista algún error al intenta iniciar sesión el contorno del wiget cambiara a color rojo.

Funcionalidades

El widget de Aheeva es un componente creado en react js para realizar llamadas que trabaja junto con una librería proporcionada por Aheeva, a través de esta librería se puede hacer uso de los servicios de Aheeva.

El widget funciona a través de una librería proporcionada por Aheeva, mediante esta librería podemos conectarnos a su plataforma y consumir sus servicios, como realizar llamadas telefónicas, pero para poder hacer eso de estos servicios primero se debe realizar un login directamente en el código usando la librería, para realizar este login se necesita una cuenta de aheeva previamente registrada y configurada, esta cuenta debe tener permisos para realizar transferencias, conferencias y llamadas.

El widget cuenta con las siguientes funcionalidades

• Llamadas
  • Mute
  • Pausar y reanudar llamada
  • Pausar y reanudar grabación de la llamada
• Transferencias
  • IVR
  • Números de teléfono
• Conferencias
  • Agentes
  • Números de teléfono

Estatus del widget

El color del contorno del widget denota el estatus actual del widget, donde:

• Gris: indica que no hay un sesión activa en el widget.
• Azul: existe una sesión de aheeva iniciada en el widget, para llegar a este estatus se debe intentar realizar una llamada.
• Verde: este color denota que se encuentra una llamada activa o se esta intentando enlazar una llamada.
• Rojo: ocurrió un error y se acompaña de un mensaje en la parte inferior del widget.

Renderizar widget

Para implementar el widget se debe agregar al proyecto el archivo JSX que contiene el codigo del componente, posteriormente importarlo donde se quiere mostrar y renderizarlo de la siguiente manera:

<WidgetAheeva extraInfo=Plantilla:Servicio:'captura' listaTelefonos={dataObject.telefonos} sessionData={sessionData} dataResult={dataResult} logoutFlag={headerdata.open} showAheevaIframe={showAheevaIframe} disableWidget={false} />

El componente requiere los siguientes parametros:

• extraInfo: json con donde se debe indicar el "servicio", el cual es un identificador para la tarea donde se esta utilizando el widget, este valor sera utilizado para guardarlo en la BD FINDEPCO.
• listaTelefonos: el componente puede recibir un arreglo de telefonos que se mostraran como botones. [9999999999, 8888888888].
• sessionData: sessionData o equivalente del podlet.
• dataResult: dataResulto equivalente del podlet.
• logoutFlag: Variable del useState correspondiente a mostrar el modal del resumen final de la tarea, esta variable es utilizada para hcaerle saber al widget que la tarea esta llegando al final y se realiza un logout de aheeva y se actualiza el widget al estatus correspondiente
• showAheevaIframe: Valor booleano que al estar en true muestra el iframe de aheeva y contenedor con los logs de aheeva y si esta en false oculta ese contenido.
• disableWidget: Inhabilita el widget, por lo cual será imposible utilizarlo, Esto con fines de pruebas, si se llega a entrar a realizar una revicion de la tarea y no sea necesario realizar ninguna llamada.

Además para obtener los siguientes parámetros se necesita llamar al endpoint get_parameter del servicio layer-api-web-service: /api/get_parameter?clave=[nombre del parametro]

 {
   "identifier": null,
   "clave": "showAheevaIframe",
   "valor": "true"
 }

Referencias

Sitio oficial de Aheeva https://www.aheeva.com/

Documentación oficial de la librería https://bitbucket.org/aheeva/app-framework/src/master/