Transcrever Áudio
Use esta ação quando tiver um arquivo de áudio no storage da sua empresa e quiser gerar uma transcrição dele.
Melhor para
- Transcrever um arquivo que o próprio workflow acabou de criar, como o resultado de Upload para Storage ou Download para Storage
- Transformar áudios ou gravações de chamadas em texto para passos posteriores
- Produzir arquivos de legenda (
srt,vtt) junto com a transcrição simples
Para transcrever um áudio que já está em uma conversa, use Executar função no documento com a função de transcrição da própria mensagem — ela foi feita para esse caso.
Campos principais
| Campo | O que faz |
|---|---|
| Arquivo | O áudio a transcrever, normalmente step(0).file de um passo anterior |
| Bucket e Caminho completo | Alternativa a Arquivo quando quiser apontar direto para o objeto |
| Perfil de transcrição | Quais configurações de transcrição usar. Deixe vazio para usar o padrão da empresa |
| Idioma | Sobrescreve o idioma do perfil, por exemplo pt-BR |
| Formats | Quais saídas gerar: txt, srt, vtt, json. Todas as quatro por padrão |
| Finalidade | Rótulo opcional para o que este passo faz, exibido nos logs |
O que passos posteriores podem usar
| Valor | O que é |
|---|---|
step(N).jobId | O ID do job de transcrição |
step(N).jobStatus | O status do job quando foi enfileirado — normalmente pending |
step(N).enginePath | Como o áudio será processado |
step(N).providerType | Qual provedor de transcrição vai executá-lo |
step(N).diarized | Se a transcrição vai identificar quem está falando |
Esta ação enfileira o job — ela não espera por ele
O passo devolve um ID de job e termina imediatamente. Uma transcrição real leva minutos, então ela roda em segundo plano.
Isso significa que a transcrição não fica disponível para o próximo passo da mesma execução. Para obter o resultado:
- Abra o painel de transcrições no aplicativo, ou
- Consulte o job pelo ID em outra execução de workflow, mais tarde
Você também recebe uma notificação quando o job termina.
Dicas
- É possível enfileirar até 10 jobs de transcrição por vez. Além disso, o passo falha até que jobs anteriores terminem.
- A transcrição conta para o uso do seu plano. Perfis que usam suas próprias chaves de provedor são registrados, mas não cobrados.
- Leia o resultado do job em
step(N).jobStatus, e não emstep(N).status—statusé reservado para códigos de status HTTP e não guarda o estado do job.