API de Grabación a pedido
Esta API solo esta disponible para los usuarios de Multi-ACD (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.
Las API de Record on Demand están disponibles en el portal de la Comunidad de desarrolladores.
Antes de que empiece
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 requiere el permiso Interactions Hub > APIs > Multi-ACD Record on Demand API.
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 exitosa. Comenzó la solicitud de Iniciar grabaciones a pedido.
-
Estado 202-Operación en proceso. Se aceptó la solicitud de Iniciar grabaciones a pedido y se está procesando.
-
Estado 400: Solicitud incorrecta
-
Estado 401: El usuario solicitante no pudo autenticarse.
-
Estado 403: El usuario solicitante no está autorizado para realizar la operación.
-
Estado 404-No encontrado. No se encontraron interacciones activas.
-
Estado 409: La solicitud no se puede ejecutar debido al estado del servicio.
-
Estado 425: La interacción está bloqueada mientras se procesa una solicitud anterior de Registro a pedido/Detención a pedido
-
Estado 500-Error interno del servidor.
-
Estado 504: Se agotó el tiempo de solicitud.
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 API da prioridad sobre las políticas Recording. 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 exitosa. Comenzó la solicitud de Detener grabaciones a pedido.
-
Estado 202-Operación en proceso. Se aceptó la solicitud de Detener grabaciones a pedido y se está procesando.
-
Estado 400-Solicitud incorrecta.
-
Estado 401: El usuario solicitante no pudo autenticarse.
-
Estado 403: El usuario solicitante no está autorizado para realizar la operación.
-
Estado 404-No encontrado. No se encontraron interacciones activas.
-
Estado 409: La solicitud no se puede ejecutar debido al estado del servicio.
-
Estado 425: La interacción está bloqueada mientras se procesa una solicitud anterior de Registro a pedido/Detención a pedido.
-
Estado 500-Error interno del servidor.
-
Estado 504: Se agotó el tiempo de solicitud.
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 rechaza el consentimiento, entonces CXone Mpower Recording no grabará la llamada, incluso si hay una política de grabación configurada para grabar la llamada, o si el agente graba la llamada a pedido o usando 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 se llamó a la API mientras la grabación de la llamada estaba en curso, Recording detendrá la grabación y la parte grabada de la llamada estará 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 exitosa. Se inició la solicitud de No grabar.
-
Estado 202-Operación en proceso. La solicitud de No grabar se aceptó y se está procesando.
-
Estado 400-Solicitud incorrecta.
-
Estado 401: El usuario solicitante no pudo autenticarse.
-
Estado 403: El usuario solicitante no está autorizado para realizar la operación.
-
Estado 404-No encontrado. No se encontraron interacciones activas.
-
Estado 409: La solicitud no se puede ejecutar 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: Se agotó el tiempo de solicitud.