Habilitar a gravação de canal duplo
A gravação de canal duplo permite que você obtenha uma gravação de sua chamada com dois canais distintos: um canal de cliente (autor da chamada) e um canal de agente.
A gravação de canal duplo oferece muitas vantagens em relação às gravações de canal único (mono). Com o áudio de cada parte separado em sua própria faixa, é mais fácil analisar o conteúdo de uma gravação usando transcrição e análise de palavras‐chave. Além disso, há uma vantagem na qualidade da gravação de voz durante a reprodução. As gravações de canal duplo permitem que os gerentes de call center e supervisores de qualidade se concentrem em um único canal (apenas o cliente ou apenas o agente) ao analisar chamadas.
Com as gravações de canal duplo, também é mais fácil entender a gravação de chamadas durante a reprodução – conversas com clientes e agentes são representadas por cores diferentes no Flex Insights Player.
Neste guia, configuraremos gravações de canal duplo que começam no áudio do cliente quando ele liga. Isso produzirá uma gravação com dois canais distintos:
- O canal Cliente (o alto‐falante esquerdo quando reproduzido com alto‐falantes estéreo).
- O canal Agente (o alto‐falante direito quando reproduzido com alto‐falantes estéreo) para o restante dos participantes da conversa.
Na maioria dos casos, o canal Agente incluirá apenas um único agente do contact center.
Se você optar por gravar chamadas, precisará estar em conformidade com determinadas leis e regulamentos, relacionados à obtenção de consentimento para gravar (como a Lei de Invasão de Privacidade da Califórnia e leis semelhantes em outras jurisdições). Informações adicionais sobre as implicações legais da gravação de chamadas podem ser encontradas aqui.
Com essa abordagem de gravação do segmento do cliente, estamos gravando o cliente mesmo antes de entrar em contato com um agente. O arquivo pode conter a gravação do cliente aguardando na fila. Conversas abandonadas também são gravadas.
Considere as implicações legais de registrar o cliente antes de entrar em contato com um agente.
Usar o Studio para habilitar gravações
Por padrão, cada chamada Flex recebida acionará a execução do fluxo do Studio. Você pode identificar o fluxo exato do Studio inspecionando seus números de telefone ativos no console da Twilio. Por padrão, esse seria o fluxo "Voice IVR". Precisamos modificar esse fluxo para acionar a gravação e fornecer informações adicionais ao Flex Insights para processar corretamente a gravação e os metadados.
É assim que ficará o fluxo final do Studio:
Os blocos de construção
O fluxo de voz padrão contém apenas o widget SendCallToAgent. Para gravar uma chamada, precisamos adicionar o widget Gravação de chamadas ao fluxo.
Gravação de chamadas:
Configuração necessária:
Você deve alternar o botão GRAVAÇÃO DE CHAMADA para "Start Recording". Este widget informará ao fluxo do Studio para criar uma nova gravação para cada chamada recebida. Você pode obter mais informações sobre o widget na documentação do widget Gravação de chamadas.
Para os fins deste guia, conecte as transições Sucesso e Falha ao widget Send To Flex. Em seu ambiente de produção, pode fazer sentido adicionar alguma lógica adicional para lidar com esses casos adequadamente.
Dizer/Reproduzir:
O widget Gravação de chamadas não pode ser colocado como o primeiro widget após o acionador. Ele deve vir depois de outro widget como Dizer/Reproduzir ou Reunir (Gather). Dizer/Reproduzir permite reproduzir uma mensagem gravada ou ditar texto para um usuário durante uma chamada. Considere se o seu caso de uso exige que seus clientes sejam avisados antes de uma chamada ser gravada. Esta pode ser a oportunidade perfeita para obter o consentimento deles!
Configuração necessária:
Você precisa decidir o que quer Dizer/Reproduzir! Por questões de simplicidade, esse fluxo do Studio lê uma simples mensagem de boas‐vindas.
Consulte a documentação do widget Dizer/Reproduzir para obter detalhes sobre outras opções de personalização.
Modificar atributos da tarefa
Para que o Flex Insights processe corretamente a gravação de canal duplo, você precisará modificar o widget Send to Flex e adicionar mais algumas informações a seus Atributos. O conteúdo dos Atributos será adicionado aos Atributos da tarefa quando a tarefa for criada.
Você pode encontrar mais detalhes na documentação do widget Send to Flex.
Configuração
O conteúdo padrão do campo Atributos é:
{
"type": "inbound",
"name": "{{trigger.call.From}}"
}
Você precisará modificar o objeto para que ele fique da seguinte forma:
{
"type": "inbound",
"name": "{{trigger.call.From}}",
"conversations": {
"media": [
{
"url": "https://api.twilio.com/2010-04-01/Accounts/{{widgets.CallRecording.AccountSid}}/Recordings/{{widgets.CallRecording.Sid}}",
"type": "VoiceRecording",
"start_time": "{{widgets.CallRecording.StartTime}}",
"channels": [ "customer", "others" ]
}
]
}
}
Isso adiciona o objeto JSON conversations
que contém os metadados media
gravados.
Valores obrigatórios
Chave |
Valor |
url |
O URL da gravação. Não é necessário anexar o sufixo ".wav" suffix. Certifique‐se de inserir o nome correto do widget (CallRecording em nosso caso). Observação: Os nomes de variáveis diferenciam maiúsculas de minúsculas. |
tipo |
Valor estático: |
start_time |
Precisamos saber a hora de início da gravação para calcular corretamente as compensações de segmento na conversa. A hora de início da gravação pode ser acessada em líquido através da tecla |
channels |
A ordem dos canais na gravação.
Valor estático:
Para chamadas inbound, a primeira é o autor da chamada (cliente) e a segunda é o restante da conferência do Flex, por exemplo, agente. |
Observação: Fornecer valores incorretos no objeto media
pode introduzir inconsistências em métricas como tempos de conversa no Flex Insights.
Próximas etapas
Se você tiver habilitado anteriormente gravações de chamadas de canal único (mono) nas Configurações Flex, vá em frente e desative‐as; suas novas gravações de canal duplo podem ser realizadas!
Além disso, para maior segurança de suas gravações, considere habilitar a autenticação HTTP no endpoint da API de gravação. Vá para o Console da Twilio e habilite "Enforce HTTP Auth on Media URLs". Seus URLs de gravação são visíveis para qualquer serviço que consuma eventos do TaskRouter (por exemplo, aplicativos de terceiros através de complementos), e proteger o endpoint é uma boa prática. Certifique‐se de que sua infraestrutura não exija que esse endpoint seja desprotegido.
Ativar gravações fora do Studio
Se você não estiver usando o fluxo padrão do Studio para enviar chamadas para o Flex, ainda poderá usar gravações de canal duplo adicionando o objeto conversations/media
à sua Tarefa, conforme definido acima. Isso pode envolver iniciar/recuperar o URL de gravação usando a API Programmable Voice.
Iniciar uma gravação de chamada de canal duplo
Para iniciar uma gravação de canal duplo em uma chamada ao vivo, faça uma solicitação HTTP Post para o recurso Lista de gravações de uma Chamada em andamento:
POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallsSid}/Recordings.json
Você precisa especificar o parâmetro RecordingsChannel para gravar em canais separados. Ao usar cURL, a solicitação ficará assim:
curl -X POST https://api.twilio.com/2010-04-01/Accounts/ACXXXX..X/Calls/CAXXXX..X/Recordings.json \
--data-urlencode "RecordingChannels=dual" \
-u ACXXXX..X:your_auth_token
Obter o URL de gravação
No objeto conversations/media
, você precisa especificar o URL do arquivo de gravação. Resposta da API à sua solicitação de gravação, você encontrará os atributos necessários: account_sid
, sid
(gravando o SID) e start_time
. O valor start_time
deve estar no formato ISO 8601.
O URL de gravação ficará assim:
https://api.twilio.com/2010-04-01/Accounts/ACXXXX..X/Recordings/REXXXX..X
Para obter mais detalhes sobre gravações, visite a documentação de Programmable Voice.
Precisa de ajuda?
Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.