API de Grabación a pedido

Esta API solo esta disponible para los usuarios de CXone Multi-ACD (CXone Open).

Estas API permiten iniciar, detener y desactivar la grabación de llamadas a pedido, lo que activa el control de grabación mediante API.

Antes de comenzar

Antes de comenzar a utilizar las API de enmascarar y desenmascarar, debe configurar un permiso de usuario, generar una clave de acceso y seguir el proceso de registro y autenticación que se explica en el portal de desarrolladores.

Esta API necesita el permiso de Buscar y Reproducir >API > Registro Multi-ACD por Pedido.

POST Iniciar grabaciones a pedido

La API permite que un agente o aplicación comience a grabar una llamada en curso de un usuario específico. Puede usarse para captar interacciones o conversaciones específicas que sean relevantes para fines de conformidad, garantía de calidad o capacitación.

Puede especificar que comience una grabación de voz solamente, o de voz y pantalla. Este método con API tiene prioridad sobre las políticas de grabación.

El indicador mediaType es opcional y permite controlar los tipos de medios que se graban. Los valores admitidos son voz y voiceAndScreen, que activan el inicio de la grabación de voz solamente o de voz y pantalla.. Si el indicador no se supera, el valor predeterminado será voz.

userId*:

Cadena

El tipo de medio que se grabará.

POST/interaction-recording-management-service/interactions/start-recording-on-demand?user-id=1234567

Respuesta

  • Estado 200-Operación realizada con éxito. Comenzó la solicitud de Iniciar grabaciones a pedido.

  • Estado 202-Operación en curso. Se aceptó la solicitud de Iniciar grabaciones a pedido y se está procesando.

  • Estado 400-Solicitud incorrecta

  • Estado 401-El usuario solicitante no ha podido autenticarse.

  • Estado 403-El usuario solicitante no está autorizado a realizar la operación.

  • Estado 404-No se ha encontrado. No se encontraron interacciones activas.

  • Estado 409-No es posible ejecutar la solicitud debido al estado del servicio.

  • Estado 425-La interacción está bloqueada mientras se procesa una solicitud anterior de Grabación a pedido/Detener grabaciones pedido.

  • Estado 500-Error interno del servidor.

  • Estado 504-La solicitud ha caducado.

POST Detener grabaciones a pedido

La API permite detener la grabación de voz y pantalla de la llamada en curso de un usuario específico. Se puede usar para proteger la privacidad de los clientes o para cumplir la normativa que limita la grabación de ciertos tipos de conversaciones.

Este método con API tiene prioridad sobre las políticas de grabación. POST. Detener grabaciones a pedido. La grabación solo se puede reanudar llamando a Iniciar grabaciones a pedido.

userId*:

Cadena

ID de usuario del agente que se va a grabar.

POST/interaction-recording-management-service/interactions/stop-recording-on-demand?user-id=1234567

Respuesta

  • Estado 200-Operación realizada con éxito. Comenzó la solicitud de Detener grabaciones a pedido.

  • Estado 202-Operación en curso. Se aceptó la solicitud de Detener grabaciones a pedido y se está procesando.

  • Estado 400-Solicitud incorrecta.

  • Estado 401-El usuario solicitante no ha podido autenticarse.

  • Estado 403-El usuario solicitante no está autorizado a realizar la operación.

  • Estado 404-No se ha encontrado. No se encontraron interacciones activas.

  • Estado 409-No es posible ejecutar la solicitud debido al estado del servicio.

  • Estado 425-La interacción está bloqueada mientras se procesa una solicitud anterior de Grabación a pedido/Detener grabaciones pedido.

  • Estado 500-Error interno del servidor.

  • Estado 504-La solicitud ha caducado.

POST Desactivar la opción de grabar la llamada

La API permite desactivar la opción de grabar voz y pantalla en caso de que el cliente rechace el consentimiento y no acepte ser grabado. Esto es especialmente relevante para el Reglamento General de Protección de Datos (RGPD) de la UE. Si un cliente niega el consentimiento, CXone Recording no grabará la llamada, incluso si hay una política de grabación definida para grabar la llamada o si el agente graba la llamada a pedido o usando una API.

POST. No es posible iniciar la grabación de llamadas con API para todo el contacto con el cliente, como transferencias, consultas y conferencias. Si llamó a la API durante la grabación de la llamada, CXone Recording interrumpirá la grabación y la parte grabada de la llamada quedará disponible para búsqueda y reproducción.

El consentimiento para la grabación solo se aplica a la llamada actual. No se guarda para las futuras interacciones con el cliente.

userId*:

Cadena

ID de usuario del agente que se va a grabar.

POST/interaction-recording-management-service/interactions/do-not-record?user-id=1234567

Respuesta

  • Estado 200-Operación realizada con éxito. Se inició la solicitud de No grabar.

  • Estado 202-Operación en curso. La solicitud de No grabar se aceptó y se está procesando.

  • Estado 400-Solicitud incorrecta.

  • Estado 401-El usuario solicitante no ha podido autenticarse.

  • Estado 403-El usuario solicitante no está autorizado a realizar la operación.

  • Estado 404-No se ha encontrado. No se encontraron interacciones activas.

  • Estado 409-No es posible ejecutar la solicitud debido al estado del servicio.

  • Estado 425-La interacción está bloqueada mientras se procesa una solicitud anterior.

  • Estado 500-Error interno del servidor.

  • Estado 504-La solicitud ha caducado.