APIs de gravação sob demanda
Essa API apenas está disponível para Multi-ACD (Open) usuários do .
Essas APIs permitem iniciar, parar e desativar a gravação de chamadas sob demanda, o que possibilita o controle de gravações via API.
Os API Registro sob Demanda estão disponíveis no portal Developer Community.
Antes que você comece
Antes de começar a usar as APIs de mascaramento e desmascaramento, configure uma permissão de usuário, gere uma chave de acesso e siga o processo de registro e autenticação explicado no portal do desenvolvedor.
Este API requer a permissão Interactions Hub >API > Multi-ACD Registro sob Demanda API permissão.
POST Iniciar a gravação sob demanda
A API permite que um agente ou aplicativo comece a gravar uma chamada em andamento para um usuário específico. Ele pode ser usado para capturar interações ou conversas específicas que sejam relevantes para fins de conformidade, garantia de qualidade ou treinamento.
É possível especificar o início da gravação apenas da voz ou da voz e da tela. Este método API tem prioridade em comparação com políticas de gravação.
O sinalizador mediaType é opcional e permite controlar quais tipos de mídia são gravados. Os valores compatíveis são voice e voiceAndScreen, permitindo iniciar a gravação somente da voz ou da voz e da tela. Se o sinalizador não for passado, o valor padrão será voice.
userId*: |
string O tipo de mídia a ser gravado. |

POST /interaction-recording-management-service/interactions/start-recording-on-demand?user-id=1234567
Resposta
-
Status 200-Bem sucedido operação. Iniciar a gravação quando a solicitação sob demanda for iniciada.
-
Status 202-Operação em andamento. A solicitação de início sob demanda foi aceita e está sendo processada.
-
Status 400 – Solicitação incorreta
-
Status 401 - O usuário solicitante não conseguiu se autenticar.
-
Status 403 – O usuário solicitante não está autorizado a realizar a operação.
-
Status 404-Não encontrado. Não foram encontradas interações ativas.
-
Status 409 - A solicitação não pode ser executada devido ao estado do serviço.
-
Status 425 - A interação está bloqueada durante o processamento de um registro anterior sob demanda/Parar solicitação sob demanda
-
Status 500-Interna erro de servidor.
-
Status 504 – A solicitação atingiu o tempo limite.
POST Interromper a gravação sob demanda
A API permite interromper a gravação da voz e da tela de uma chamada em andamento para um usuário específico. Ela pode ser usada para proteger a privacidade do cliente ou para cumprir as normas que restringem a gravação de determinados tipos de conversas.
Esse método de API dá prioridade sobre Recording políticas. A opção POST Interromper a gravação sob demanda somente pode ser retomada chamando Iniciar a gravação sob demanda.
userId*: |
string ID do usuário do agente a ser gravado. |

POST /interaction-recording-management-service/interactions/stop-recording-on-demand?user-id=1234567
Resposta
-
Status 200-Bem sucedido operação. A solicitação de interrupção da gravação sob demanda foi iniciada.
-
Status 202-Operação em andamento. A solicitação de interrupção sob demanda foi aceita e está sendo processada.
-
Status 400 – Solicitação incorreta.
-
Status 401 - O usuário solicitante não conseguiu se autenticar.
-
Status 403 – O usuário solicitante não está autorizado a realizar a operação.
-
Status 404-Não encontrado. Não foram encontradas interações ativas.
-
Status 409 - A solicitação não pode ser executada devido ao estado do serviço.
-
Status 425 - A interação é bloqueada durante o processamento de um registro anterior sob demanda/Parar solicitação sob demanda.
-
Status 500-Interna erro de servidor.
-
Status 504 – A solicitação atingiu o tempo limite.
POST Desabilitar a opção de gravar a chamada
A API permite desabilitar a opção de gravar a voz e a tela de uma chamada, caso o cliente recuse o consentimento e não concorde em ser gravado. Isso é especialmente relevante para o Regulamento Geral de Proteção de Dados da UE (RGPD). Se um cliente recusar o consentimento, CXone Mpower Recording não gravará a chamada, mesmo que haja uma política de gravação definida para gravar a chamada, ou se o agente gravar a chamada sob demanda ou usando API.
Após a API, a gravação de chamadas não pode ser iniciada para o contato inteiro com o cliente, incluindo transferências, consultas e conferências. Se o API foi chamado enquanto a gravação da chamada estava em andamento Recording interromperá a gravação, a parte gravada da chamada estará disponível para pesquisa e reprodução.
O consentimento de gravação somente se aplica à chamada atual. Ele não é salvo para o cliente para interações futuras.
userId*: |
string ID do usuário do agente a ser gravado. |

POST /interaction-recording-management-service/interactions/do-not-record?user-id=1234567
Resposta
-
Status 200-Bem sucedido operação. A solicitação de não gravação foi iniciada.
-
Status 202-Operação em andamento. A solicitação de Não gravar foi aceita e está sendo processada.
-
Status 400 – Solicitação incorreta.
-
Status 401 - O usuário solicitante não conseguiu se autenticar.
-
Status 403 – O usuário solicitante não está autorizado a realizar a operação.
-
Status 404-Não encontrado. Não foram encontradas interações ativas.
-
Status 409 - A solicitação não pode ser executada devido ao estado do serviço.
-
Status 425 - A interação está bloqueada durante o processamento de uma solicitação anterior.
-
Status 500-Interna erro de servidor.
-
Status 504 – A solicitação atingiu o tempo limite.