Gravações e transcrições
Projete a gravação em torno da evidência que sua equipe precisa. A resposta de quem ligou, o correio de voz e uma gravação de ambos os lados são requisitos diferentes. Identifique a fonte de captura e a chamada que a produz antes de construir um processo de revisão.
Comandos de gravação e transferências para sequências gerenciadas de gravação exigem acesso à prévia de gravação no nível da organização. Em uma sequência Bird, configure a gravação com as etapas disponíveis no construtor de sequências. Uma janela de gravação captura o áudio recebido no trecho de origem. Uma chamada com participantes interligados pode gerar gravações separadas para cada participante; não presuma que uma gravação contém a conversa mixada. O uso comum de trunks SIP não cria uma gravação automaticamente.
Defina o requisito de gravação
- Declare o objetivo da captura e quem precisa revisá-la.
- Identifique a fonte de áudio. Verifique se a aplicação conectada grava áudio recebido, prompts gerados ou ambos. Uma gravação de PBX (o sistema telefônico empresarial que roteia chamadas) ou de central de atendimento tem sua própria fonte e permissões.
- Inclua o processo de aviso e consentimento adequado à conversa.
- Defina a janela de captura e os requisitos de acesso e retenção. Interrompa a captura antes de entrada sensível quando o fluxo exigir; ocultar a telemetria do teclado não remove a fala do áudio.
- Decida se o fluxo precisa de transcrição. Uma captura de áudio bem-sucedida e uma transcrição bem-sucedida são resultados separados.
Mantenha o sistema de origem explícito se seu PBX ou runtime conversacional grava a chamada. Migrar a conectividade telefônica não migra o arquivo de gravação existente.
Prepare um teste de captura controlado
Use um número que sua equipe controla. Teste o comportamento esperado de início, parada e desligamento, incluindo uma chamada curta que termina antes da janela normal de captura. Confirme qual participante está audível e se o áudio esperado foi retido.
Mantenha as identidades da chamada, do trecho e da gravação junto com o resultado. Uma chamada pode agrupar trechos relacionados. Identifique o trecho que produziu a gravação. O log do trecho fornece o resultado telefônico.
Abra Voice > Calls e selecione a chamada para inspecionar os artefatos capturados. Consulte a referência publicada de API, CLI ou MCP antes de integrar a recuperação de gravações: a existência de uma ação de gravação no painel não publica uma operação equivalente nessas superfícies.
Diferencie os estados de processamento
Verifique a disponibilidade do áudio e o processamento da transcrição de forma independente. Uma transcrição pendente, uma transcrição com falha e um áudio indisponível exigem respostas diferentes. Texto vazio não estabelece que o participante não disse nada.
Uma chamada pode terminar antes de o processamento concluir. Preserve o resultado telefônico final enquanto verifica o estado posterior do artefato. Se o áudio retido expirar, tentar novamente a reprodução não pode restaurá-lo.
Quando uma transcrição for ambígua, revise o áudio de origem quando disponível. Nomes, datas e números podem ser reconhecidos incorretamente. Confirme ações importantes no sistema que as executou.
Revise acesso e retenção
Use as permissões do sistema que possui o artefato. Compartilhe uma referência de chamada ou gravação controlada com um colega autorizado em vez de copiar áudio para registros não relacionados. Trate URLs de reprodução temporárias como acesso temporário, não como referência de arquivo durável.
Os arquivos de áudio Bird têm uma política de expiração de armazenamento de 30 dias. Entradas de gravação e transcrições têm regras de expiração separadas, então uma entrada pode continuar listada após o áudio ficar indisponível. Esses registros expiram 31 dias após o fim do dia-âncora em UTC: uma entrada de gravação usa seu próprio horário de início, e uma transcrição usa o horário de início do áudio de origem. A transcrição não reinicia a janela de retenção. Um resultado vazio não estabelece que nada foi gravado. Para gravações armazenadas pelo seu PBX ou runtime conversacional, verifique a política de retenção desse sistema separadamente.
Confirme o resultado de negócio
Mantenha áudio de origem, transcrição, resumo gerado e resultado de negócio separados. Um resumo pode ajudar um revisor a encontrar um problema; o sistema de reservas, pagamentos ou suporte confirma se uma ação foi concluída.
Registre evidências ausentes ou parciais na revisão. Uma chamada concluída não estabelece que uma gravação existe, e uma transcrição sozinha não prova que todos os participantes foram capturados.
Próximos passos
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico.