Modo de voz do Whizi não funciona: todo erro e sua solução

A resposta curta

O modo de voz falha por um de quatro motivos: a conta não está conectada ou ficou sem minutos de voz, o navegador bloqueou o microfone, a conexão em tempo real com o serviço de voz falhou, ou a sessão atingiu um dos seus próprios limites. A mensagem que a Whizi mostra diz qual deles é, e cada mensagem corresponde a exatamente uma condição no código.

Encontre o texto que você está vendo nesta tabela e depois leia a seção correspondente abaixo para os detalhes.

O que você vê	De onde vem	O que fazer
Sign in to Whizi to use voice mode.	Nenhum token de sessão quando a sobreposição de voz é aberta	Faça login e reabra o modo de voz
Upgrade your subscription to talk with Whizi in voice mode.	Uma conta gratuita iniciando uma sessão de voz	Assine: contas gratuitas têm 0 minutos de voz
Your monthly voice minutes have been used up.	A reserva de voz do período foi recusada	Espere o período reiniciar, ou suba de plano
Microphone access is blocked. Allow it in your browser to use voice mode.	A solicitação de microfone foi rejeitada pelo navegador	Permita o microfone para whizi.io e tente novamente
This browser does not support realtime voice.	Nenhum getUserMedia ou AudioContext	Use um navegador que tenha os dois
Realtime voice is not configured yet. Please try again later.	A chave do provedor de voz não está configurada no servidor	Nada que você possa fazer: tente novamente mais tarde
The realtime voice connection failed.	Um erro de websocket durante a sessão	Tente novamente e verifique a rede
Voice sessions are limited to 15 minutes. Start a new session to continue.	O temporizador da sessão atingiu o limite de 15 minutos	Inicie uma nova sessão

O servidor da Whizi apenas gera um token de sessão de curta duração, e o navegador então abre um websocket diretamente para o provedor de voz. Nenhum áudio passa pelo backend da Whizi. É por isso que as falhas de microfone são inteiramente locais ao seu navegador, enquanto as mensagens da seção de conexão vêm da geração do token no servidor ou do provedor, a montante dele.

A voz não inicia: as travas da conta

Três recusas acontecem antes que qualquer áudio seja capturado, e nenhuma delas é um bug.

Sign in to Whizi to use voice mode. A sobreposição de voz exibe isso quando nenhum token está disponível. Uma sessão desconectada ou expirada produz isso. Faça login e reabra o modo de voz.

Upgrade your subscription to talk with Whizi in voice mode. Este é o HTTP 402 com o código subscription_required, retornado quando uma conta gratuita tenta iniciar uma sessão de voz. Contas gratuitas têm uma cota de 0 minutos de voz, então não há acesso parcial para recorrer. O plano mais barato com alguma cota de voz é o Starter, a $15.99/mês, que inclui 10 minutos de voz em tempo real por mês.

Your monthly voice minutes have been used up. e Your weekly voice minutes have been used up. Esses são HTTP 429 com o código voice_limit_reached, lançados quando a reserva de voz do período é recusada. O termo é "weekly" (semanal) em um ciclo de cobrança semanal e "monthly" (mensal) nos demais casos, então qual deles você vê indica em qual ciclo o seu plano está.

As cotas, por período de cobrança mensal:

Plano	Minutos de voz por mês
Free	0
Starter	10
Pro	80
Powerhouse	500

Períodos de cobrança semanais recebem um quarto da cota mensal, arredondado para cima: 3 minutos no Starter, 20 no Pro, 125 no Powerhouse.

O microfone não inicia

Essas quatro mensagens vêm todas do lado do navegador do modo de voz, antes ou durante a captura. Como o áudio nunca chega aos servidores da Whizi, nada relacionado à sua conta ou plano as afeta.

This browser does not support realtime voice. Exibida quando getUserMedia ou AudioContext não está disponível. Isso é uma verificação de capacidade, não um problema de permissão, então nenhuma quantidade de permissões concedidas vai resolver isso. Tente um navegador diferente.

Microphone access is blocked. Allow it in your browser to use voice mode. Exibida quando a solicitação de microfone é rejeitada com NotAllowedError ou SecurityError. Conceda acesso ao microfone para o site e inicie a sessão novamente.

The microphone could not be started. A mensagem genérica para qualquer outra falha de microfone. Se a permissão foi concedida e o navegador é capaz, essa é a mensagem que aponta para o próprio dispositivo ou para outro aplicativo que está usando a entrada.

Voice mode could not start. O recurso usado quando a sequência de início lança um erro sem mensagem própria, então não carrega nenhum detalhe para agir. Verifique permissão, navegador e dispositivo, nessa ordem.

A conexão falha ou cai

Iniciar uma sessão tem duas etapas que podem falhar de forma independente: o servidor gera um token, depois o navegador abre um websocket. As mensagens dizem qual etapa quebrou.

Falhas ao gerar o token:

Mensagem	Status e código	Gatilho
Realtime voice is not configured yet. Please try again later.	503 voice_live_unavailable	A chave da API do provedor não está configurada no worker
Realtime voice is temporarily rate-limited. Please retry shortly.	429 provider_rate_limited	A geração do token upstream respondeu 429
Whizi could not start a realtime voice session.	502 voice_live_unavailable	Qualquer outra falha upstream na geração do token
Whizi received an invalid realtime voice token.	502 voice_live_unavailable	A geração teve sucesso, mas não retornou um nome de token
Realtime voice is not available in this build yet.	503 voice_not_configured	A base de API compartilhada está ausente, ou o domínio de voz não está habilitado para esta versão
Whizi received an invalid realtime voice session.	502 invalid_voice_live_response	O payload da sessão falhou na validação, incluindo uma URL de websocket que não começa com o host do provedor esperado
Request failed ({status}).	Varia	O recurso do cliente quando o corpo de um erro de voz não pode ser lido

As quatro primeiras linhas vêm da geração do token no worker da Whizi ou do provedor, a montante dele. Nenhuma configuração do cliente, mudança de navegador ou de plano resolve isso. Tente novamente em instantes, e se a mesma mensagem persistir, entre em contato com o suporte com a mensagem exata e o horário.

Falhas no próprio websocket:

Mensagem	Gatilho
Whizi could not reach the realtime voice service.	O websocket fechou antes da configuração ser concluída
The realtime voice connection was closed.	O websocket fechou depois da configuração ser concluída
The realtime voice connection failed.	Um evento de erro de websocket foi disparado

A sobreposição rotula uma sessão com falha com o estado Connection error. Um fechamento antes da configuração aponta para alcançabilidade (uma rede que bloqueia o websocket, por exemplo), e um fechamento depois da configuração aponta para uma interrupção no meio da sessão.

Os loops de nova tentativa têm seu próprio limite. Iniciar ou encerrar uma sessão de voz é limitado a 6 solicitações por minuto cada, então insistir no botão de início troca o problema que você tinha por um 429. Veja limites de taxa para as outras janelas às quais uma nova tentativa contribui.

A sessão terminou sozinha

Quatro finalizações são deliberadas, e cada uma tem sua própria mensagem.

Voice sessions are limited to 15 minutes. Start a new session to continue. Uma única sessão de voz é limitada a 15 minutos (900 segundos), independentemente de quanto da sua cota ainda resta. Essa mensagem aparece quando o temporizador atinge esse máximo completo, e iniciar uma nova sessão é o caminho pretendido.

This session used the last of your plan's voice minutes for this period. A chamada de início reserva segundos e retorna por quanto tempo esta sessão específica pode rodar, e esse número diminui quando os minutos restantes estão baixos. Quando o servidor encurta a sessão abaixo do máximo de 15 minutos, essa é a mensagem que você recebe no final, em vez da mensagem de limite.

Whizi ended the session after a couple of quiet minutes. Tap retry when you want to keep talking. O tempo limite de inatividade se esgotou sem fala. Essa é a mensagem a procurar se o seu sintoma é "nunca me ouviu": uma sessão que não captura nenhuma fala termina assim em vez de ficar aberta. Se você vir isso enquanto estava definitivamente falando, o problema está a montante do tempo limite, na seção de microfone acima.

The realtime voice session is ending. Start a new session to continue. O serviço upstream enviou um frame goAway, que é o provedor pedindo para a conexão ser encerrada. Inicie uma nova sessão.

O token de sessão é gerado com uma vida útil de 16 minutos, um minuto de folga além do limite de 15 minutos da sessão. Uma sessão não pode durar mais do que seu token, e o limite é sempre o que você atinge primeiro.

Lendo o erro por conta própria

Se você está olhando um registro de rede ou reportando um problema, o code no corpo do erro é a metade mais útil dele. Estes são os códigos que o modo de voz pode produzir: subscription_required, voice_limit_reached, voice_live_unavailable, provider_rate_limited, voice_not_configured, invalid_voice_live_response e rate_limit_reached.

Para o que acontece com o que você disse, a declaração de treinamento cobre voz explicitamente: a Whizi não usa seus prompts, arquivos, conversas, transcrições de voz ou conteúdo gerado para treinar modelos de IA de propriedade da Whizi, e não vende esse conteúdo como dado de treinamento. O detalhe completo está em o que a Whizi faz com seus dados.