El dictado tiene dos partes: (1) el código, que tu sistema de despliegue envía al dominio (sin acción manual), y (2) la infraestructura del servidor (relay WebSocket + proxy), que se hace una sola vez por dominio con un comando. Sigue estos pasos.

1 Desplegar el código (automático)

Tu sistema de despliegue envía los archivos al dominio. Verifica que el deploy incluya los componentes del dictado:

• dictado/ (movil.php, js/dictadoMovil.js, js/procesar/generarPaseDictado.php, provisionar_relay.sh)
• fichaClinica/js/dictado.js y fichaClinica/assets/css/dictado.css
• Los <script>/<link> en ficha.php y esta pestaña en configuraciones/
• Rutas en .htaccess: dictado-pase y dictado-movil

2 Provisionar el servidor (SSH, como root — una vez por dominio)

Reemplaza <cuenta> (usuario cPanel), <ruta-app> y <dominio>:

sudo bash /home/<cuenta>/public_html/<ruta-app>/dictado/provisionar_relay.sh <cuenta> <dominio>

Hace todo solo: elige un puerto libre, copia el relay, genera el secreto (pass.key), crea el servicio systemd ws-dictado@<cuenta>, configura el proxy /ws/ en Apache y verifica el handshake (debe imprimir HTTP 101). Es idempotente: re-ejecutarlo no pisa el secreto existente.

3 Activar en esta pantalla

Marca Activar dictado por voz, elige modo Ambos, pulsa Guardar y comprueba con “Probar (celular / QR)”.

Verificar / solucionar

Comprobar el WebSocket (debe responder 101):

curl -s -o /dev/null -w "%{http_code}\n" -H "Connection: Upgrade" -H "Upgrade: websocket" -H "Sec-WebSocket-Version: 13" -H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" https://<dominio>/ws/

• Estado del relay: sudo systemctl status ws-dictado@<cuenta>
• Logs del relay: sudo journalctl -u ws-dictado@<cuenta> -n 50
• Apache: sudo apachectl configtest  y  sudo systemctl reload httpd

El modo “Solo micrófono del computador” funciona sin servidor (no requiere el paso 2). El VPS usa Apache/EA4 con mod_proxy_wstunnel. Detalle completo y método manual en configuraciones/DICTADO_PROVISIONING.md.