Semana del lanzamiento: colaboradores, varios widgets y una API de registro de cambios
El día del lanzamiento prometimos publicar todo lo humanamente posible antes de la medianoche. Esto es lo que logramos sacar esa semana: una forma más segura de permitir que más personas de tu equipo redacten documentación, un widget para cada superficie de tu producto y los primeros pasos para que tus propias herramientas gestionen el registro de cambios.
✍️ Rol de colaborador: Permite que más compañeros redacten documentación y revisa cada cambio antes de que se publique
🧩 Varios widgets: Un widget en tu aplicación, otro en tu portal para desarrolladores, cada uno con su propio contenido
🙋 Tú decides qué ocurre cuando un visitante necesita hablar con alguien: Redirígelo, añade contexto o encárgate de la transferencia desde tu propio sitio
🧹 Las auditorías ordenan tu estructura: Fern detecta colecciones desordenadas y las reorganiza por ti
📣 API y webhook del registro de cambios: Crea entradas desde tus propias herramientas y activa correos electrónicos de lanzamiento cuando se publique una entrada
🔍 Por qué Fern hizo este cambio: Consulta exactamente qué frase quedó desactualizada por una solicitud de incorporación de cambios
Colaboradores y solicitudes de revisión
Invita a tus compañeros como Colaboradores. Pueden redactar artículos y trabajar con Fern, pero, en lugar de publicarlos, seleccionan Enviar para revisión y añaden una nota opcional.
Los propietarios y administradores reciben un correo electrónico, y la solicitud aparece en Solicitudes de revisión, en la barra lateral. Revisa cada cambio de la solicitud, compara cada artículo con la versión publicada y publícalo con un clic. La publicación se basa exactamente en la versión que revisaste, así que nada cambia sin que te des cuenta.
Los colaboradores no pueden despublicar, eliminar ni mover artículos, editar colecciones ni cambiar la configuración del espacio de trabajo. Sus claves de API y conexiones con herramientas de IA siguen las mismas reglas. Todos los miembros, incluidos los colaboradores, ocupan un asiento. Consulta Equipo.
Varios widgets, cada uno con su propio contenido
Ahora puedes crear, nombrar y administrar varios widgets desde el panel, cada uno con su propio aspecto, configuración y fragmento de instalación. Cada tarjeta de widget muestra una vista previa y su actividad de los últimos 30 días.
También puedes excluir secciones del centro de ayuda de cada widget. El widget integrado en la aplicación puede centrarse en la ayuda del producto, mientras que el del portal para desarrolladores puede limitarse a la documentación de la API. Las secciones excluidas no aparecen en la pestaña de exploración, las búsquedas, los registros de cambios ni las respuestas de IA de ese widget. Esto limita lo que muestra un widget, pero no restringe el acceso: para eso, usa el acceso por secciones. Selecciónalas en Widget > Personalizar > Contenido. Consulta Configurar los ajustes del widget.
Tú decides qué ocurre cuando un visitante necesita hablar con alguien
Si Fern no puede responder o un visitante solicita hablar con una persona, tu sitio ahora puede intervenir. El widget activa los eventos escalationOffered y escalationRequested, para que puedas mostrar tus propias opciones (como los tiempos de respuesta o una mejora de plan), enviar al visitante a otra herramienta de chat o encargarte de todo.
También puedes configurar desencadenantes de transferencia en Configuración > Asistente de IA. Fern sigue respondiendo sobre lo que cubre tu documentación y luego etiqueta la transferencia para que tu sitio la dirija al lugar adecuado. Si no hay ningún controlador ni desencadenante, nada cambia. Consulta Escalamiento a una persona y comportamiento de transferencia de la IA y la referencia del SDK.
Las auditorías ahora ordenan tu estructura
Los centros de ayuda se desordenan a medida que crecen: dos colecciones que cubren lo mismo, carpetas anidadas a cuatro niveles de profundidad. Ahora, cada auditoría revisa la organización de tus secciones y colecciones (en centros de ayuda con al menos 10 artículos que no estén sincronizados desde otra plataforma) y sugiere hasta tres soluciones claras, como «Combinar Pagos con la colección Facturación». Cada hallazgo muestra exactamente los cambios previstos y, al asignarlo, Fern reorganiza tus colecciones por ti.
Una estructura bien organizada no genera hallazgos, así que no hay tareas innecesarias. Fern nunca mueve contenido entre secciones o públicos, ni modifica los registros de cambios. Consulta Cómo audita Fern tu centro de ayuda.
API y webhook del registro de cambios
Los registros de cambios ahora forman parte de la API pública. Consulta los registros de cambios y sus entradas, crea borradores de entradas con tus propias herramientas (o tu propio agente de IA), edítalos y publícalos. Consulta Crear una entrada del registro de cambios.
El nuevo webhook changelog_entry.published se activa una vez cuando se publica una entrada e incluye su título, enlace, fecha, etiquetas y contenido en HTML y Markdown. No vuelve a activarse con ediciones posteriores, así que puedes usarlo sin problema para enviar correos electrónicos de lanzamiento. Consulta Entrada del registro de cambios publicada.
Por qué Fern hizo este cambio
Antes de aprobar una actualización de la documentación a partir de una solicitud de incorporación de cambios fusionada, abre Por qué Fern hizo este cambio. Verás qué cambió en tu producto (novedades, cambios, elementos movidos, renombrados, eliminados o corregidos), qué grado de confianza tiene Fern, la frase exacta de cada artículo que quedó desactualizada por la solicitud de incorporación de cambios y cualquier cosa que no pudo confirmar.
Cada cambio de código también muestra quién abrió la solicitud de incorporación de cambios, para que los compañeros puedan identificar de un vistazo su propio trabajo y puedas buscar conversaciones por nombre de usuario de GitHub. Consulta Borradores automáticos de solicitudes de incorporación de cambios.
Otras mejoras
Los elementos incrustados ajustan su tamaño correctamente: Los elementos incrustados de HTML personalizado que ocupan toda la pantalla, como los exploradores de API, ahora tienen aproximadamente la altura de una pantalla, en lugar de dejar un enorme espacio vacío.
Una página 404 mejorada: ¿Te has perdido en ferndesk.com? Aprovecha para ayudar a Fern a corregir un centro de ayuda desactualizado.
Correcciones
El editor de imágenes vuelve a abrir todas las imágenes, incluidas las importadas desde plataformas que las envían sin un tipo de archivo válido.
Los mensajes del formulario de contacto conservan los saltos de línea cuando llegan a tu bandeja de entrada.
La página de tareas de Fern ya no deja de actualizarse durante los primeros segundos de una tarea ni justo después de pulsar Detener.
Información útil
Las colecciones fusionadas aún no redirigen: Cuando Fern fusiona colecciones durante una auditoría, la URL de la colección anterior deja de funcionar. Si se había enlazado desde otro sitio, añade una redirección en redirecciones del centro de ayuda.