Cómo publicar un changelog en Heedback
· 7 min de lectura · Heedback Team
Tus usuarios quieren saber qué está cambiando. Ya sea una nueva función, una corrección de errores o una mejora de rendimiento, un changelog bien mantenido genera confianza y mantiene a tu comunidad comprometida. El changelog de Heedback te permite publicar notas de lanzamiento cuidadas, categorizar entradas con etiquetas, soportar múltiples idiomas y notificar automáticamente a los suscriptores.
Esta guía te acompaña en la creación de tu primera entrada de changelog y la configuración de un flujo de publicación continuo.
Requisitos previos
Antes de publicar entradas de changelog, asegúrate de que:
- Tienes una organización activa en Heedback con un plan Pro.
- Tu cuenta tiene permisos de administrador o propietario.
- Has configurado los ajustes de tu portal en Configuración > Portal (el changelog se publica en tu portal público).
- Opcionalmente, configura los idiomas soportados en Configuración > Idiomas si planeas publicar entradas multilingües.
Crear una entrada de changelog
- Ve a Changelog en la barra lateral izquierda de tu panel.
- Haz clic en Nueva entrada en la esquina superior derecha.
- Completa los detalles de la entrada:
- Título: Un resumen conciso de la actualización. “Modo oscuro para el panel” es mejor que “Actualización de UI v3.2.1.”
- Cuerpo: Escribe la nota de lanzamiento completa usando el editor de texto enriquecido. Explica qué cambió, por qué importa y si el usuario necesita tomar alguna acción.
- Fecha: Por defecto es hoy. Retrocede la fecha si estás documentando un lanzamiento pasado.
- Haz clic en Publicar para que la entrada esté disponible en tu portal, o Guardar como borrador para continuar editando más tarde.
Los borradores son visibles solo para tu equipo. Las entradas publicadas aparecen inmediatamente en tu portal público y en el bloque de Changelog del widget (si está habilitado en el App Builder).
Uso de etiquetas para categorizar entradas
Las etiquetas ayudan a los usuarios a escanear tu changelog rápidamente y encontrar lo que les es relevante:
- Nuevo: Para funciones o capacidades completamente nuevas.
- Mejora: Para mejoras en funciones existentes.
- Corrección: Para correcciones de errores y problemas resueltos.
Para asignar etiquetas:
- Abre una entrada de changelog (nueva o existente).
- En el panel lateral, haz clic en Etiquetas y selecciona una o más.
- Las etiquetas aparecen como insignias de color junto al título de la entrada en el portal.
Puedes crear etiquetas personalizadas en Changelog > Etiquetas si las predeterminadas no se ajustan a tu flujo de trabajo. Por ejemplo, podrías añadir “Beta”, “Seguridad” o “Cambio importante.”
Redactar entradas multilingües
Si tu producto atiende a usuarios en diferentes regiones, Heedback te permite publicar entradas de changelog en múltiples idiomas:
- Abre una entrada de changelog y busca las pestañas de idioma en la parte superior del editor.
- Cada pestaña representa uno de los idiomas soportados de tu organización. Escribe el título y el cuerpo en cada idioma.
- El portal muestra automáticamente el idioma correcto según la preferencia de idioma del visitante.
No necesitas traducir cada entrada a todos los idiomas. Si falta una traducción, el portal recurre al idioma predeterminado. Pero para lanzamientos importantes, traducir el anuncio demuestra a tus usuarios internacionales que no son una ocurrencia tardía.
Gestión de suscriptores
El changelog de Heedback soporta suscriptores por correo electrónico — usuarios que quieren ser notificados cuando publicas algo nuevo:
- Ve a Changelog > Suscriptores para ver tu lista de suscriptores.
- Los usuarios pueden suscribirse a través del portal público o el bloque de Changelog del widget.
- Cuando publicas una nueva entrada, los suscriptores son notificados por correo electrónico automáticamente.
También puedes añadir suscriptores manualmente por dirección de correo electrónico, lo cual es útil para incorporar beta testers o cuentas clave que quieren acceso anticipado a las notas de lanzamiento.
Conectar el changelog con los tableros de funciones
Un flujo de trabajo poderoso es vincular las entradas del changelog con publicaciones del tablero de funciones:
- Al crear o editar una entrada de changelog, usa la opción Publicaciones vinculadas para conectarla con una o más publicaciones del tablero de funciones.
- Los usuarios que votaron en esas publicaciones verán que su solicitud fue implementada — cerrando el ciclo de feedback.
- En el portal, las publicaciones vinculadas muestran un estado “Lanzado”, reforzando que escuchas el feedback de los usuarios.
Esta conexión transforma tu changelog de un canal de difusión en una conversación bidireccional con tus usuarios.
Consejos y buenas prácticas
- Publica de forma consistente. Una cadencia semanal o quincenal es ideal. Los usuarios pierden interés en changelogs que se actualizan una vez al trimestre, y las actualizaciones diarias generan ruido.
- Escribe para los usuarios, no para los desarrolladores. “Se mejoró el caché de respuestas de la API” no significa nada para la mayoría de los clientes. “El panel carga 2 veces más rápido” sí.
- Incluye elementos visuales. Una captura de pantalla o un GIF corto de una nueva función hace que la entrada sea más atractiva y reduce la confusión.
- Celebra las correcciones también. Los usuarios aprecian saber que un error que reportaron está resuelto. Genera confianza más rápido que las nuevas funciones por sí solas.
- Usa borradores para revisión del equipo. Redacta la entrada, guárdala como borrador, comparte el enlace con tu equipo para feedback y luego publica cuando todos estén alineados.
Funciones relacionadas
- Tableros de funciones: Vincula funciones lanzadas a entradas de changelog y cierra el ciclo con los votantes.
- Hoja de ruta pública: Muestra a los usuarios lo que viene — el changelog muestra lo que ya se lanzó.
- Portal de clientes: El changelog vive en tu portal, junto con tu base de conocimiento y tableros de feedback.
- Widget: Activa el bloque de Changelog en el App Builder para mostrar actualizaciones directamente dentro de tu producto.