Corregir cómo salen ciertas palabras

Cuatro listas para que salgan bien las palabras que sólo se dicen en tu casa: el nombre de un producto, unas siglas, el cargo de alguien. Y una para que ciertas frases no salgan nunca. Cuál se usa no es un detalle de estilo. Meter un término en la lista equivocada no da error y no avisa de nada: simplemente no hace nada. Por eso lo primero de esta página es cuál es cuál.

Cuáles son, y cuál hace qué

Dos actúan mientras se transcribe —cuando lo que se ha dicho se convierte en texto— y dos mientras se traduce.

Correcciones de transcripción (transcriptionReplacements) — arreglan lo que el reconocedor oyó mal. Si dice «kubernetis» donde alguien dijo «Kubernetes», va aquí.
Frases prohibidas (abuse) — se borran del texto, y actúan en los dos momentos. Es una lista de frases a secas, sin sustituto.
Correcciones de traducción (translationCorrections) — sustituyen el texto entero cuando coincide del todo.
Sustituciones de palabras (wordReplacements) — sustituyen un trozo dentro del texto que se publica: el traducido si hay traducción, y el transcrito si la sala sólo pone subtítulos. Es la que se usa para un cargo o unas siglas: «general director» → «CEO».

En qué idioma va cada término

Es lo que más se falla, y no se puede adivinar mirando la lista.

Las correcciones de transcripción van en el idioma que se habla. Es lo que oyó el micrófono, así que se escribe como suena en la sala.
Las sustituciones de palabras van en el idioma del texto que se publica, y eso depende de la sala: si hay traducción, el de destino —para que en inglés ponga «CEO» donde pone «general director», escribes general director, no «director general»—; y si la sala sólo subtitula, el que se habla, porque ahí lo que se publica es lo que se dijo.
Las correcciones de traducción van siempre en el idioma de destino, y por tanto sólo hacen algo si la sala traduce. En una sala de sólo subtítulos no hay destino, así que esa lista se queda sin actuar — se guarda y no pasa nada.

Y una trampa que conviene saber: las sustituciones de palabras ignoran los acentos al buscar y las correcciones de transcripción no. Si el reconocedor puede escribir una palabra sin su tilde, mándala de las dos formas.

En una sala que sólo subtitula, dos de las cuatro se parecen mucho y no son lo mismo: las correcciones de transcripción son para lo que el reconocedor oyó mal, y las sustituciones de palabras para cómo se escribe algo en tu casa —un cargo, unas siglas, el nombre de un producto—. Las dos actúan sobre el mismo texto ahí, pero la segunda ignora los acentos y la primera no, así que meter un término en la otra lista cambia si funciona o no.

Los tres pisos: la cuenta, el sitio y la sala

Las listas se pueden poner en tres alturas. La cuenta es la de arriba; debajo cada sitio; y debajo cada sala. Cada piso de abajo puede hacer tres cosas, y no dos:

heredar — no escribe nada y le llega lo de arriba;
heredar y retocar — lo suyo va encima de lo que hereda;
empezar de cero — ignora lo de arriba y usa sólo lo suyo.

La tercera existe porque sin ella un piso sólo podría añadir: un término heredado no se quita escribiendo otro distinto, así que no habría forma de decir «esta sala no se parece en nada al resto». En un choque gana el más concreto. Si la cuenta dice sir → Lord y la sala dice sir → Sir, en esa sala vale Sir. Las frases prohibidas son la excepción: no se pisan, se suman sin repetir, porque borrar dos veces la misma frase la borra una. Y ojo con esto, que es lo que sorprende: empezar de cero corta la cadena por encima, no por debajo. Un sitio que empieza de cero le tapa la cuenta a todas sus salas, y una sala que empieza de cero está sola haga lo que haga su sitio.

Dónde se tocan

Ninguna está en el menú, y es a propósito: cada una vive donde ya se administra esa cosa.

Las de la cuenta, en Sitios, en la tarjeta de arriba, al lado de «Marca de la cuenta».
Las de un sitio, en Salas y equipo, debajo de «Marca de este sitio».
Las de una sala, en esa misma pantalla, en la fila de su sala.

La pantalla es la misma para las tres: lo único que cambia es el interruptor de heredar, que la cuenta no tiene porque no hereda de nadie. Cada lista se puede escribir a mano —una fila por término, con su idioma— o importar un JSON, y cada una tiene su propio importador: el fichero que suele tener alguien es «mis frases prohibidas», no las cuatro juntas.

Qué se rechaza y qué sólo se avisa

Se rechaza, sin guardar nada:

que no sea el formato que lee el motor — un nombre de lista mal escrito se guardaría, se mandaría y no haría nada;
pasarse de cualquiera de los topes, diciendo de cuál y por cuánto;
un idioma que el motor no tiene. No es un aviso: esas entradas se compararían contra un texto en un idioma que no llega nunca. Se dice qué campo falla y se devuelven todos a la vez, para poder marcarlos de una vez.

Se avisa, sin bloquear, porque son cosas que puedes haber querido: un acento en la lista que no ignora acentos, el mismo término en dos listas, sustituir algo por sí mismo, un sustituto vacío —que borra el término—, una entrada que parece una fila entera de una hoja de cálculo, o una lista que va por encima de nueve décimos de su tope.

Los topes

Por lista: 3.000 frases prohibidas, 1.000 correcciones de transcripción, 1.000 correcciones de traducción y 500 sustituciones de palabras. Y cuatro generales: 2 MiB el JSON entero, 200 caracteres por entrada —caracteres, no bytes: diez eñes son diez—, 25 idiomas distintos y 3.000 entradas por idioma.

Y por API, para quien no usa el panel

Quien crea sus salas desde su propio software tiene las mismas listas por HTTP, en los tres pisos. Están en la referencia de la API, en el grupo Words, con la forma de cada respuesta y lo que se devuelve cuando algo no cuadra. Si es la primera vez, empieza por La API. Dos cosas que conviene saber antes de escribir el guion: una escritura reemplaza la lista entera —para añadir un término se lee primero y se escribe todo—, y el interruptor de heredar es obligatorio en un sitio y en una sala: no se da por supuesto, porque un guion que se olvidara del campo convertiría «empieza de cero» en «hereda» sin que nadie tocara nada. La otra diferencia con el panel es que por API los avisos no bloquean: en la pantalla hay a quien preguntar y en un guion no, y negarse por un término repetido rompería una subida de madrugada.