Pular para o conteúdo
Turbo Notify

Transcrição de áudio

Com a transcrição ligada, cada áudio que chega no seu número vem com o texto em audio.transcription, no webhook message.received, no polling e em GET /v1/numbers/{ref}/messages/{id}. Você usa a sua própria chave de API: o uso e o custo ficam na sua conta no provedor.

Provedores

ProvedorModelo usado se você não escolher
Groqwhisper-large-v3-turbo
OpenAIwhisper-1

Preços e limites mudam de um provedor para outro e com o tempo. Confira no site de cada um antes de decidir.

Como configurar

1. Crie a chave de API no provedor

As telas do provedor mudam com o tempo: se um nome não bater, procure o equivalente.

Groq

  1. Entre em console.groq.com. Se ainda não tiver conta, crie uma.
  2. Abra API Keys e clique em Create API Key. Dê um nome, por exemplo “Turbo Notify”.
  3. Copie a chave (começa com gsk_). Ela aparece uma vez só: guarde antes de fechar a janela.

OpenAI

  1. Entre em platform.openai.com e abra API keys.
  2. Clique em Create new secret key, dê um nome e copie a chave (começa com sk-). Ela aparece uma vez só.
  3. A transcrição da OpenAI é cobrada por uso: adicione crédito em Settings > Billing da conta antes de testar. Sem saldo a chave é aceita, mas os áudios não são transcritos.

2. Cole a chave no dashboard

Acesse Transcrição (abre em nova aba) e preencha:

CampoValor
ProvedorGroq ou OpenAI
Chave de APIA chave que você copiou
ModeloOpcional. Deixe em branco para usar o modelo da tabela acima

3. Teste e salve

Clique em Testar conexão: o Turbo Notify confirma que o provedor aceitou a chave. Depois clique em Salvar. A partir daí, os áudios recebidos são transcritos. Áudios que chegaram antes não são transcritos depois.

Como a transcrição funciona

  • Só áudios recebidos são transcritos. Áudios que você envia não.
  • O idioma vem do país do número de quem enviou o áudio (um número +55 é transcrito em português). Para um país que o Turbo Notify não reconhece, o provedor detecta o idioma.
  • Áudios acima de 24 MB não são transcritos.
  • Se a transcrição falhar, a mensagem chega do mesmo jeito, sem o texto.

Se não funcionar

O campo audio.transcription traz kind: "unavailable" e um reason. Os motivos estão em Consultar mensagem. Os mais comuns:

  • provider_error: o provedor recusou a chave. Crie outra no provedor e salve de novo em Transcrição (abre em nova aba) .
  • not_configured: não há transcrição ativa. Confira se o botão Transcrição ativa está ligado.
  • timeout: o provedor demorou mais do que o tempo permitido. A próxima mensagem tenta de novo.

Se o provedor recusar por limite de uso, espere ou aumente o limite na conta dele. O estado da conexão (Saudável ou Com problemas) aparece na própria tela de Transcrição.

Segurança

  • A chave é guardada cifrada (AES-256-GCM) e nunca aparece em logs nem em respostas. A tela mostra só o começo e o fim dela.
  • Use uma chave só para o Turbo Notify, para poder revogá-la no provedor sem afetar outros usos.

Relacionado