El modo de voz de Whizi no funciona: cada error y su solución

La respuesta corta

El modo de voz falla por una de cuatro razones: la cuenta no ha iniciado sesión o no le quedan minutos de voz, el navegador bloqueó el micrófono, la conexión en tiempo real con el servicio de voz falló, o la sesión alcanzó uno de sus propios límites. El mensaje que muestra Whizi te dice cuál es, y cada mensaje corresponde exactamente a una condición en el código.

Busca el texto que estás viendo en esta tabla, y luego lee la sección correspondiente abajo para el detalle.

Lo que ves	De dónde viene	Qué hacer
Sign in to Whizi to use voice mode.	No hay token de sesión cuando se abre el overlay de voz	Inicia sesión y vuelve a abrir el modo de voz
Upgrade your subscription to talk with Whizi in voice mode.	Una cuenta gratuita intenta iniciar una sesión de voz	Suscríbete: las cuentas gratuitas tienen 0 minutos de voz
Your monthly voice minutes have been used up.	Se rechazó la reserva de voz del periodo	Espera a que se reinicie el periodo, o sube de plan
Microphone access is blocked. Allow it in your browser to use voice mode.	El navegador rechazó la solicitud de micrófono	Permite el micrófono para whizi.io e inténtalo de nuevo
This browser does not support realtime voice.	Falta getUserMedia o AudioContext	Usa un navegador que tenga ambos
Realtime voice is not configured yet. Please try again later.	La clave del proveedor de voz no está configurada en el servidor	No hay nada que puedas hacer: reintenta más tarde
The realtime voice connection failed.	Un error de websocket durante la sesión	Reintenta y revisa la red
Voice sessions are limited to 15 minutes. Start a new session to continue.	El temporizador de la sesión alcanzó el límite de 15 minutos	Inicia una nueva sesión

El servidor de Whizi solo genera un token de sesión de corta duración, y luego el navegador abre un websocket directamente con el proveedor de voz. Ningún audio pasa por el backend de Whizi. Por eso los fallos de micrófono son enteramente locales a tu navegador, mientras que las cadenas de la sección de conexión provienen de la generación del token en el servidor o del proveedor por encima de él.

El modo de voz no inicia: las restricciones de la cuenta

Tres rechazos ocurren antes de que se capture cualquier audio, y ninguno de ellos es un error.

Sign in to Whizi to use voice mode. El overlay de voz muestra este mensaje cuando no hay ningún token disponible. Una sesión cerrada o expirada lo produce. Inicia sesión y vuelve a abrir el modo de voz.

Upgrade your subscription to talk with Whizi in voice mode. Este es un HTTP 402 con el código subscription_required, devuelto cuando una cuenta gratuita intenta iniciar una sesión de voz. Las cuentas gratuitas tienen una asignación de 0 minutos de voz, así que no hay acceso parcial al que recurrir. El plan más económico con alguna asignación de voz es Starter a $15.99/mes, que incluye 10 minutos de voz en tiempo real al mes.

Your monthly voice minutes have been used up. y Your weekly voice minutes have been used up. Estos son HTTP 429 con el código voice_limit_reached, lanzados cuando se rechaza la reserva de voz del periodo. El sustantivo es "weekly" en un ciclo de facturación semanal y "monthly" en cualquier otro caso, así que cuál de los dos veas te dice en qué ciclo está tu plan.

Las asignaciones, por periodo de facturación mensual:

Plan	Minutos de voz al mes
Free	0
Starter	10
Pro	80
Powerhouse	500

Los periodos de facturación semanal toman una cuarta parte de la asignación mensual, redondeada hacia arriba: 3 minutos en Starter, 20 en Pro, 125 en Powerhouse.

El micrófono no inicia

Estos cuatro mensajes vienen todos del lado del navegador del modo de voz, antes o durante la captura. Como el audio nunca llega a los servidores de Whizi, nada relacionado con tu cuenta o tu plan los afecta.

This browser does not support realtime voice. Se muestra cuando getUserMedia o AudioContext no están disponibles. Es una comprobación de capacidad, no un problema de permisos, así que ninguna cantidad de permisos concedidos lo resolverá. Prueba con otro navegador.

Microphone access is blocked. Allow it in your browser to use voice mode. Se muestra cuando la solicitud de micrófono se rechaza con NotAllowedError o SecurityError. Concede el acceso al micrófono para el sitio e inicia la sesión de nuevo.

The microphone could not be started. El mensaje genérico para cualquier otro fallo de micrófono. Si el permiso está concedido y el navegador es capaz, este es el mensaje que apunta al propio dispositivo o a otra aplicación que esté reteniendo la entrada de audio.

Voice mode could not start. El mensaje alternativo que se usa cuando la secuencia de inicio falla sin ningún mensaje propio, así que no aporta ningún detalle sobre el que actuar. Revisa permisos, navegador y dispositivo, en ese orden.

La conexión falla o se cae

Iniciar una sesión tiene dos pasos que pueden fallar por separado: el servidor genera un token, y luego el navegador abre un websocket. Las cadenas te dicen qué paso falló.

Fallos al generar el token:

Mensaje	Estado y código	Causa
Realtime voice is not configured yet. Please try again later.	503 voice_live_unavailable	La clave de la API del proveedor no está configurada en el worker
Realtime voice is temporarily rate-limited. Please retry shortly.	429 provider_rate_limited	El servicio upstream de generación de tokens respondió 429
Whizi could not start a realtime voice session.	502 voice_live_unavailable	Cualquier otro fallo upstream en la generación del token
Whizi received an invalid realtime voice token.	502 voice_live_unavailable	La generación tuvo éxito pero no devolvió ningún nombre de token
Realtime voice is not available in this build yet.	503 voice_not_configured	Falta la base de la API compartida, o el dominio de voz no está habilitado para esta build
Whizi received an invalid realtime voice session.	502 invalid_voice_live_response	La carga útil de la sesión no pasó la validación, incluida una URL de websocket que no empieza con el host esperado del proveedor
Request failed ({status}).	Varía	El resguardo del cliente cuando no se puede leer el cuerpo del error de voz

Las primeras cuatro filas vienen de la generación del token en el worker de Whizi o del proveedor por encima de él. Ningún ajuste del cliente, cambio de navegador o cambio de plan las resuelve. Reintenta en un momento, y si la misma cadena persiste, contacta con soporte con el mensaje exacto y la hora.

Fallos en el propio websocket:

Mensaje	Causa
Whizi could not reach the realtime voice service.	El websocket se cerró antes de completar la configuración
The realtime voice connection was closed.	El websocket se cerró después de completar la configuración
The realtime voice connection failed.	Se produjo un evento de error del websocket

El overlay etiqueta una sesión fallida con el estado Connection error. Un cierre antes de completar la configuración apunta a un problema de alcance (una red que bloquea el websocket, por ejemplo), y un cierre después de completar la configuración apunta a una interrupción a mitad de sesión.

Los bucles de reintento tienen su propio límite. Iniciar o terminar una sesión de voz está limitado a 6 solicitudes por minuto cada uno, así que insistir en el botón de inicio cambia el problema que tenías por un 429. Consulta límites de frecuencia para conocer las demás ventanas en las que influye un reintento.

La sesión terminó por sí sola

Cuatro finales son deliberados, y cada uno tiene su propio mensaje.

Voice sessions are limited to 15 minutes. Start a new session to continue. Una sola sesión de voz está limitada a 15 minutos (900 segundos) sin importar cuánto quede de tu asignación. Este mensaje aparece cuando el temporizador alcanza ese máximo completo, e iniciar una nueva sesión es el camino previsto.

This session used the last of your plan's voice minutes for this period. La llamada de inicio reserva segundos y devuelve cuánto puede durar esta sesión en particular, y esa cifra se reduce cuando te quedan pocos minutos. Cuando el servidor acortó la sesión por debajo del máximo de 15 minutos, este es el mensaje que obtienes al final en lugar del mensaje del límite.

Whizi ended the session after a couple of quiet minutes. Tap retry when you want to keep talking. El tiempo de espera de inactividad se agotó sin ningún habla. Este es el mensaje a buscar si tu síntoma es "nunca me escuchó": una sesión que no captura ningún habla termina así en lugar de quedarse abierta. Si ves esto mientras estabas hablando de verdad, el problema está antes del tiempo de espera, en la sección del micrófono de arriba.

The realtime voice session is ending. Start a new session to continue. El servicio upstream envió un frame goAway, que es el proveedor pidiendo que la conexión se cierre. Inicia una nueva sesión.

El token de sesión se genera con una vida útil de 16 minutos, un minuto de margen por encima del límite de 15 minutos de la sesión. Una sesión no puede durar más que su token, y el límite es siempre lo primero que alcanzas.

Cómo leer el error tú mismo

Si estás viendo una traza de red o reportando un problema, el code en el cuerpo del error es la mitad más útil de este. Estos son los códigos que puede producir el modo de voz: subscription_required, voice_limit_reached, voice_live_unavailable, provider_rate_limited, voice_not_configured, invalid_voice_live_response y rate_limit_reached.

En cuanto a qué ocurre con lo que dijiste, la declaración de entrenamiento cubre la voz explícitamente: Whizi no usa tus prompts, archivos, conversaciones, transcripciones de voz ni contenido generado para entrenar modelos de IA propios de Whizi, y no vende ese contenido como datos de entrenamiento. El detalle completo está en qué hace Whizi con tus datos.