# 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.

## Defina o requisito de gravação

1. Declare o objetivo da captura e quem precisa revisá-la.
2. 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.
3. Inclua o processo de aviso e consentimento adequado à conversa.
4. 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.
5. 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 a identidade da chamada e a identidade da gravação junto com o resultado. Uma sessão pode agrupar trechos relacionados, mas um rótulo de sessão sozinho não estabelece qual trecho produziu uma gravação. O [registro de chamadas](/docs/guides/voice/call-log) fornece o resultado telefônico.

Descubra as operações de gravação disponíveis para seu espaço de trabalho por meio da interface conectada e leia o contrato atual delas antes de usá-las. Não deduza um comando de gravação a partir de uma operação de leitura de registro de chamada.

## 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.

Verifique a política de retenção e a expiração reais do artefato que você usa. Não presuma que o registro de chamada, o áudio e a transcrição permanecem disponíveis pelo mesmo período.

## 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

- [Sequências de chamada](/docs/guides/voice/call-sequences)
- [Registro de chamadas](/docs/guides/voice/call-log)
- [Eventos de Voice](/docs/guides/voice/events)

## Related resources

- [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer)
- [Voice](/products/voice) (product)
- [Voice overview](/docs/guides/voice/overview) (docs)

[Get an implementation brief](/learn/workspace?topic=voice)