
«v2.14.3: fix en el parser de webhooks, refactor del módulo de facturación, bump de dependencias.» Así son muchas notas de versión de SaaS. Las escribe quien hizo el cambio para quien hizo el cambio, y el cliente que las lee no saca nada en claro: ¿ya funciona lo que le fallaba? ¿Hay algo nuevo que le sirva?
Las notas de versión son de lo poco que un SaaS cuenta a todos sus clientes con regularidad. Bien escritas, enseñan que el producto avanza, ahorran preguntas y sirven para avisar a quien pidió algo o reportó un fallo. Mal escritas, nadie las lee.
¿Cómo se escriben unas buenas notas de versión?
Explicando qué cambia para el cliente. Cada entrada dice qué puede hacer ahora o qué problema ya no tendrá, en una o dos frases, con una captura o un enlace si ayuda. Se agrupan en novedades, mejoras y correcciones, llevan fecha y se publican en un changelog fácil de encontrar. Lo importante se avisa también dentro del producto o por correo, y a los clientes que pidieron algo o reportaron un fallo se les escribe personalmente.
Qué cambia para el cliente
Cada entrada tiene que responder a «¿y a mí qué?».
| Mal | Bien |
|---|---|
| Refactor del módulo de exportación | Las exportaciones grandes ahora tardan segundos en vez de minutos |
| Fix en el parser de webhooks | Los webhooks con caracteres especiales ya no fallan |
| Nuevo endpoint /invoices/bulk | Ahora puedes crear varias facturas a la vez desde la API |
| Mejoras de rendimiento | El panel principal carga el doble de rápido con muchos proyectos |
Si un cambio no cambia nada para el cliente, como una dependencia actualizada o una limpieza interna, no va en las notas de versión.
Qué incluir
- Novedades: funciones nuevas, con una captura o un vídeo corto si se ven en pantalla.
- Mejoras: cosas que ya existían y ahora funcionan mejor.
- Correcciones: fallos que los clientes podían notar.
- Cambios que piden algo al cliente: algo que deja de funcionar o una configuración que hay que revisar. Estos van arriba y destacados.
Cada entrada lleva:
- Un título que diga el beneficio.
- Una o dos frases con lo necesario para entenderlo.
- Dónde encontrarlo, o un enlace a la ayuda.
- Para quién es, si no es para todos: «disponible en el plan Pro».
Ejemplo de una entrada
Duplica un proyecto con todas sus tareas
Ahora puedes copiar un proyecto entero, con sus tareas, responsables y plantillas, desde el menú del proyecto → Duplicar. Útil si repites el mismo trabajo para cada cliente. Disponible en todos los planes.
Y una corrección:
Las facturas con descuento del 100 % ya se guardan bien
Antes, aplicar un descuento del 100 % daba un error al guardar. Ya está corregido; si usabas el 99,99 % para salir del paso, ya no hace falta.
Dónde publicarlas
- En una página de changelog pública, con fecha y lo último arriba. Sirve también a quien está evaluando el producto, como prueba de que avanza.
- Dentro del producto, para lo importante: un aviso discreto o un punto en el menú.
- Por correo, con un resumen mensual o trimestral, nunca un correo por cada cambio.
Cuánto hay que comunicar cada cambio:
| Cambio | Changelog | En el producto | Correo |
|---|---|---|---|
| Corrección menor | Sí | No | No |
| Mejora notable | Sí | A veces | En el resumen |
| Novedad importante | Sí | Sí | Sí |
| Cambio que exige acción | Sí | Sí | Sí, con antelación |
Avisar a quien lo pidió
Las notas de versión son el momento de cerrar dos cosas que casi siempre quedan pendientes:
- Las peticiones de funcionalidades: si alguien pidió duplicar proyectos hace tres meses, se merece un mensaje personal cuando sale. Más en cómo gestionar las peticiones de funcionalidades.
- Los fallos reportados: quien reportó un fallo y recibe un «ya está arreglado, gracias por avisar» volverá a avisar la próxima vez. Cómo recogerlos bien está en cómo conseguir reportes de bugs útiles.
Para hacerlo, las peticiones y los fallos tienen que estar registrados con los clientes que los pidieron. Con eso, avisar lleva minutos.
Notas de versión y soporte
Una nota de versión clara ahorra preguntas: el «¿por qué ha cambiado este botón?» queda respondido antes de que nadie lo pregunte. Pero soporte tiene que conocer los cambios antes de que salgan, y no enterarse por los clientes. Si atiende un agente de IA, la documentación que consulta tiene que estar al día el mismo día: un agente que explica cómo se hacía algo antes del cambio confunde más que ayuda.
En Intake, un flujo puede enseñar un aviso en el chat cuando el cliente visita una página concreta, de modo que la novedad se anuncia en la pantalla a la que afecta y no en todas. Más en mensajes.
Errores frecuentes
- Escribir para el equipo técnico en vez de para el cliente.
- Mezclar lo interno con lo que ve el cliente.
- No avisar de los cambios que rompen algo hasta que lo rompen.
- Mandar un correo por cada cambio, que acaba ignorado o en spam.
- No actualizar la documentación a la vez.
Preguntas frecuentes
¿Qué son las notas de versión?
El registro de lo que cambia en cada versión de un producto, escrito para sus usuarios: novedades, mejoras y correcciones.
¿Qué diferencia hay entre changelog y notas de versión?
En la práctica se usan como sinónimos. A veces el changelog es el registro completo y técnico, y las notas de versión son la versión para clientes.
¿Cada cuánto hay que publicarlas?
Cada vez que algo cambia para el cliente, con un resumen por correo cada mes o cada trimestre.
¿Hay que incluir las correcciones de fallos?
Las que los clientes podían notar, sí. Son de las entradas que más se agradecen.
¿Cómo aviso de un cambio que obliga al cliente a hacer algo?
Con antelación, destacado en el changelog, dentro del producto y por correo, explicando qué tiene que hacer y hasta cuándo.
Para seguir
Siguiente pasoPlantillas para comunicar cambios a clientesLa nota de versión, el aviso de un cambio que rompe algo y el correo de subida de precio.Las novedades, por correo
Solo las novedades, con la baja en cada correo. Más detalle en la política de privacidad.


