Pular para o conteúdo
Petal

SoluçõesMac7 min de leitura

Aqua Voice não funciona: offline, terminal e microfone

Aqua Voice não funciona? Libere HTTPS e WebSockets na porta 443, teste o microfone em Settings > Audio e use o Paste Last Transcript em terminais.

Publicado pela Optimal Apps, criadora do Petal.

Nesta página

O Aqua Voice não funciona? Descubra qual etapa falha. Se nada acontece, confira a rede primeiro: o ditado na nuvem do Aqua precisa de conexão com a internet e usa HTTPS e WebSockets seguros pela porta 443, que alguns proxies corporativos bloqueiam. Se o microfone demora ou perde palavras, abra Settings > Audio, escolha o seu microfone e clique em Test, depois compare com um microfone com fio. Se o texto não aparece em um terminal como o Claude Code, dite e pressione Paste Last Transcript. Se o texto não aparece no Chrome, atualize o Aqua.

Estas soluções vêm do FAQ do Aqua, do guia dele sobre atraso no microfone, do changelog e de uma issue pública no GitHub.

Aqua Voice não funciona: checklist de solução rápida

O que você vê Causa provável Solução
Erro ou nenhum resultado em todo ditado Sem conexão, ou problema no serviço do Aqua Confira a rede e o status.aquavoice.com
Funciona em casa, mas falha no trabalho O proxy bloqueia WSS ou inspeciona TLS na porta 443 Peça à TI para liberar WSS para os hosts do Aqua
As primeiras palavras são cortadas O microfone Bluetooth muda de modo Teste em Settings > Audio e compare com um microfone com fio
O medidor se mexe, mas o texto chega tarde Atraso na rede Confira a conexão e o status do serviço
Microfone errado, ou uma entrada virtual foi escolhida A entrada padrão é um dispositivo virtual Selecione o microfone no Aqua e bloqueie a entrada virtual
Nenhum texto no Claude Code ou em outro terminal O terminal ignora entradas simuladas Pressione Paste Last Transcript
Nenhum texto em campos web do Chrome Problema de inserção no Chromium Atualize para a v0.21.4 ou posterior
Nenhum texto em nenhum app Permissão de Acessibilidade ou de microfone Redefina a permissão nos Ajustes do Sistema

Passo 1: Confira a conexão e o status do serviço

O FAQ do Aqua diz: "Cloud dictation needs an internet connection." Ou seja, o ditado na nuvem precisa de conexão com a internet. O FAQ também diz que a disponibilidade offline varia conforme a plataforma, a versão do app e o modo. Em um Mac ou PC com Windows, considere que o ditado precisa de rede, a não ser que o suporte do Aqua confirme o contrário para a sua configuração.

  1. Abra uma página web para confirmar que você está online.
  2. Abra o status.aquavoice.com e veja se há uma interrupção no serviço.
  3. Desligue a VPN e teste de novo.
  4. Se você alterna entre redes Wi-Fi, teste em outra rede.

Se o Aqua funciona em uma rede e não em outra, vá para o Passo 2.

Passo 2: Libere a porta 443 e os WebSockets no proxy ou no firewall

O FAQ do Aqua afirma: "Aqua uses HTTPS and secure WebSockets (WSS) over port 443." Ele também diz que "proxies that block WSS or inspect TLS can cause connection errors." Essa é a causa comum quando o Aqua Voice funciona em casa, mas não no escritório.

Envie este pedido para a sua equipe de TI:

  1. Libere HTTPS e WSS de saída na porta 443 para os hosts do Aqua. O FAQ cita exemplos como api.aquavoice.com, core.aquavoice.com e realtime.aquavoice.com, e diz que essa não é uma lista completa.
  2. Libere o upgrade de WebSocket para esses hosts.
  3. Desative a inspeção de TLS para esses hosts.
  4. Peça ao suporte do Aqua a lista completa de hosts para a sua plataforma e versão.

Você não consegue resolver um proxy corporativo de dentro do app.

Passo 3: Teste o microfone em Settings > Audio

O guia do Aqua sobre atraso no microfone dá esta ordem:

  1. Abra Settings > Audio no Aqua.
  2. Selecione o seu microfone e escolha Test.
  3. Fale e observe quando o medidor de entrada começa a se mexer.

O que o resultado significa:

  • O medidor começa tarde: o atraso está no microfone. Vá para o Passo 4.
  • O medidor se mexe rápido, mas o texto chega tarde: o atraso está na rede ou no serviço. Volte para o Passo 1.

Passo 4: Compare o Bluetooth com um microfone com fio

O FAQ diz: "Bluetooth microphone mode switching can add delay." Um fone Bluetooth muda de modo quando o microfone começa a funcionar, e as primeiras palavras podem se perder.

  1. Fale a mesma frase curta com o seu fone Bluetooth, com o microfone embutido e com um microfone com fio, se você tiver um.
  2. Repita depois que o microfone ficar parado por um tempo, porque o atraso costuma ser pior no primeiro uso.
  3. Se só o Bluetooth demora, use o microfone embutido ou um com fio para ditar. O FAQ do Aqua dá o mesmo conselho para os AirPods.

Para soluções gerais com fones no Mac, leia ditado com microfone Bluetooth no Mac.

Passo 5: Selecione a entrada certa

  1. No Aqua, selecione o microfone que você quer, em vez de depender do padrão do sistema.
  2. Confira a chave de mudo do microfone.
  3. No Mac, abra Ajustes do Sistema > Privacidade e Segurança > Microfone e confirme que o Aqua Voice está ativado.
  4. Se você usa um software de roteamento de áudio, como o BlackHole, ele pode virar a entrada padrão. O changelog do Aqua (v0.19.12) diz que você pode bloquear entradas virtuais para o Aqua escolher um microfone real.

Passo 6: Aqua Voice não cola o texto em um terminal ou no Claude Code

A issue #51725 no repositório anthropics/claude-code no GitHub descreve um texto do Aqua Voice que sumia sem aviso no prompt do Claude Code. O relato veio do Windows 11, com o Aqua v0.14.2 no terminal integrado do Cursor. A teoria de quem relatou era que o Aqua inseria o texto com pressionamentos de tecla simulados, que o Claude Code não aceitava. O Paste Last Transcript, que usa o clipboard, funcionou.

  1. Dite como de costume.
  2. Se nenhum texto aparecer, pressione Paste Last Transcript. O changelog do Aqua informa como padrão Control-Command-V no Mac e Control-Shift-Seta para a Direita no Windows.
  3. Para mudar o atalho, abra Settings > Keybindings no Aqua. Você também pode associar o comando a um botão do mouse.

Isso acrescenta um pressionamento de tecla a cada ditado. Para outras soluções em terminais e editores, leia ditado não funciona no VS Code, no Terminal ou no Claude Code.

Passo 7: Aqua Voice não cola o texto no Chrome

O changelog do Aqua para a v0.21.4 (outubro de 2026) diz que a versão melhorou a inserção de texto no Chrome e em outros apps Chromium no Mac, para o caso em que um ditado terminado não aparece no campo. Uma versão anterior, a v0.11.6, corrigiu um bug de colagem no VS Code e no Cursor.

  1. Atualize o Aqua para a versão mais recente.
  2. Teste o campo web de novo.
  3. Se ainda falhar, pressione Paste Last Transcript.

Passo 8: Redefina as permissões

Se o texto não aparece em nenhum app no Mac:

  1. Abra Ajustes do Sistema > Privacidade e Segurança > Acessibilidade.
  2. Desative e ative o Aqua Voice. Se isso não ajudar, remova o app com o botão de menos e adicione de novo.
  3. Faça o mesmo em Privacidade e Segurança > Microfone.
  4. Encerre o Aqua e abra de novo.

Os passos completos estão em permissão de Acessibilidade não funciona depois de atualizar um app.

Passo 9: Fale com o suporte do Aqua

O FAQ do Aqua pede que você informe o nome e a versão do app nos campos que não funcionam. Para o atraso no microfone, o guia pede o seu sistema operacional, a versão do Aqua, o modelo do microfone, o tipo de conexão e quando o atraso acontece (no teste do microfone, no início de uma gravação ou depois que você termina de falar).

Quando você precisa de um ditado que funcione offline: Petal

O Aqua Voice é um bom app de ditado na nuvem, e muitos dos problemas acima são problemas de rede por natureza: um serviço na nuvem precisa de uma conexão funcionando e de um caminho aberto pelo seu firewall. Se você dita em voos, em redes de escritório restritas ou com material confidencial, um app que roda no dispositivo evita esse tipo de problema.

O Petal para Mac é grátis e de código aberto (MIT):

  • A fala roda no seu Mac. Escolha um modelo como o Parakeet, o Whisper Large V3 Turbo ou o Qwen3-ASR. Depois do download, o ditado não precisa de rede, de conta nem de regra de proxy.
  • A limpeza também roda no seu Mac. O Petal W1, um modelo que roda no dispositivo, remove vícios de linguagem e corrige a pontuação. Um modelo na nuvem com a sua própria chave é opcional.
  • Uma colagem pelo clipboard. O Petal envia Command-V e restaura o clipboard antigo depois de 700 ms, o que ajuda no VS Code e em terminais.
  • Router por app. Configure um terminal como As Said e o Mail como Email.

O Petal não tem todos os recursos do Aqua, por exemplo o Notetaker do Aqua. Para uma comparação completa, leia alternativa ao Aqua Voice.

Perguntas

O Aqua Voice funciona offline?

O FAQ do Aqua diz que o ditado na nuvem precisa de conexão com a internet e que a disponibilidade offline varia conforme a plataforma, a versão do app e o modo. Em um computador sem conexão, conte com a falha do ditado na nuvem. Pergunte ao suporte do Aqua o que a sua configuração suporta.

Por que o Aqua Voice não funciona na rede do trabalho?

O Aqua usa HTTPS e WebSockets seguros (WSS) pela porta 443. O FAQ dele diz que proxies que bloqueiam WSS ou inspecionam TLS podem causar erros de conexão. Peça à equipe de TI para liberar WSS para os hosts do Aqua e para pular a inspeção de TLS nesses hosts.

Por que o Aqua Voice não cola o texto no Claude Code ou em um terminal?

A issue #51725 no GitHub relata que o texto do Aqua sumia sem aviso no Claude Code no Windows, enquanto o Paste Last Transcript funcionava. Dite e depois pressione o Paste Last Transcript (Control-Command-V no Mac, por padrão).

Por que o Aqua Voice perde as minhas primeiras palavras?

O guia do Aqua diz que microfones Bluetooth podem levar um tempo para mudar para o modo de microfone. Teste o microfone em Settings > Audio e compare um fone Bluetooth com o microfone embutido ou com um microfone com fio.

Existe uma alternativa offline ao Aqua Voice para Mac?

O Petal para Mac é grátis e de código aberto. Ele roda os modelos de fala no seu Mac, então o ditado funciona sem rede depois do download do modelo.

SoluçõesMac

Ditado do Mac no idioma errado: como resolver

Ditado do Mac no idioma errado? Adicione o idioma em Teclado > Ditado, troque o idioma ao ditar, confira a fonte de entrada e conclua o download.

SoluçõesMac

Spokenly não funciona no Mac: como resolver

Spokenly não funciona no Mac? Corrija Microfone e Acessibilidade, o atalho, o download de modelos locais, o Local-only mode e falhas na colagem.