Início → Blog → Como montar uma transcrição sem escrever código
Como montar uma transcrição sem escrever código
Você não precisa de um programador para transcrever gravações automaticamente. Toda plataforma de automação sabe enviar uma requisição HTTP com um arquivo anexado, e é só isso que o serviço exige. Segue a configuração para n8n, Make e Zapier, além do erro que todo mundo comete uma vez.
O que a plataforma precisa
A receita é idêntica em todas elas:
- Endereço https://voicesscribe.com/v1/audio/transcriptions, método POST.
- Cabeçalho Authorization com o valor Bearer seguido da sua chave.
- Corpo em formulário: campo binário file e campo de texto model com whisper-1.
A resposta é um JSON com o campo text — é ele que segue pelo restante do cenário.
n8n
Use o nó HTTP Request: método POST, endereço https://voicesscribe.com/v1/audio/transcriptions, autenticação por cabeçalho. Em Body escolha Form-Data e adicione dois parâmetros — model com whisper-1 e file do tipo n8n Binary File apontando para a propriedade binária do nó anterior, normalmente chamada data.
A falha clássica aqui é enviar o arquivo como texto. Se a resposta for 400, em nove de cada dez vezes o campo file leva uma string em vez da propriedade binária.
Make e Zapier
No Make, use o módulo HTTP com a ação Make a request. Defina o tipo do corpo como multipart/form-data, mapeie o campo file para a saída binária do módulo anterior (um arquivo do Google Drive, um anexo de e-mail) e preencha model com whisper-1.
No Zapier, Webhooks by Zapier com Custom Request dá conta. O arquivo vem do anexo do passo anterior e o cabeçalho de autorização é adicionado à mão. O Zapier limita o tamanho dos anexos, então comprima gravações longas antes.
Para onde vai o texto
Três ligações que se montam em meia hora:
- Caixa de entrada para planilha. Chega um e-mail com anexo, o arquivo é transcrito, o texto vira uma linha nova.
- Nuvem para base de conhecimento. Um arquivo novo na pasta monitorada vira uma página com a transcrição.
- Telefonia para CRM. A gravação da chamada é transcrita e entra no card da negociação como nota.
Se o cenário processa lotes, coloque um limite de paralelismo: as plataformas adoram disparar tudo de uma vez e batem direto no limite de taxa.
Teste com as suas próprias gravações. O cadastro leva um minuto e os minutos gratuitos bastam para avaliar a qualidade.
Obter uma chave de API grátisPerguntas frequentes
É preciso um módulo de integração dedicado?
Não. O nó HTTP genérico, presente em qualquer plataforma de automação, é suficiente.
Qual o tamanho máximo de arquivo?
25 MB. Muitas plataformas no-code limitam anexos ainda mais, então comprimir para opus antes é um bom hábito.
Como obter legendas em vez de texto puro?
Adicione o campo response_format com srt ou vtt e a resposta já vem como arquivo de legenda.
Por que meu cenário retorna 400?
Confira se o campo file vai como dados binários, e não como nome de arquivo ou link. Essa é a causa mais comum.
Leitura relacionada
- Como montar um pipeline de transcrição para um acervo de áudio — Transcrever milhares de gravações sem perder nenhuma: fila de trabalho, concorrência, novas tentativas, retomada após uma queda e controle do valor da fatura.
- Como transformar notas de voz em texto automaticamente — Transforme notas de voz do celular e do gravador numa base pesquisável: pasta sincronizada, script observador, modelo de nota e dicas para áudio de rua.
- Erros da API de transcrição e o que eles realmente significam — Explicação dos códigos de status da API: por que aparecem 401, 400, 413, 429 e 502, como corrigir cada um e quais falhas vale a pena repetir.