Automatiza capturas de pantalla en tu documentación

Fern puede iniciar sesión en el panel de control de tu producto y capturar capturas de pantalla anotadas para tu documentación mediante la integración Dashboard.

Navegará por tus páginas autenticadas, hará capturas de pantalla y añadirá anotaciones visuales, como flechas que señalan botones o elementos del menú.

Cómo funciona

Una vez conectado, Fern puede:

• Iniciar sesión automáticamente usando las instrucciones que proporciones

• Navegar a páginas o flujos específicos

• Capturar capturas de pantalla en momentos clave

• Añadir anotaciones visuales (flechas, resaltados)

Configuración de la integración Dashboard

Ve a la página de Integrations y localiza la tarjeta de la integración Dashboard. Haz clic en el botón Connect.

Proporciona tres datos:

• Nombre del Dashboard: Una etiqueta para identificar este panel de control (por ejemplo, "Our Admin Portal")

• URL del Dashboard: La URL completa donde Fern debe empezar (por ejemplo, "https://app.yourproduct.com")

• Instrucciones de inicio de sesión: Instrucciones paso a paso para iniciar sesión

Redacción de las instrucciones de inicio de sesión

Sé específico con las etiquetas de los botones y los nombres de los campos del formulario. Por ejemplo:

1. Click the "Sign In" button in the header
2. Enter email in the "Email Address" field: [email protected]
3. Enter password in the "Password" field: your-demo-password
4. Click the "Continue" button
5. If prompted for 2FA, click "Use backup code"
6. Enter backup code: 123456789

Editar capturas de pantalla después de insertarlas

Después de que Fern inserte capturas de pantalla en un artículo, puedes abrirlas en el editor de imágenes para recortar o añadir más anotaciones antes de publicar. Consulta Editar imágenes en el editor de artículos.

Uso de la integración

Pide a Fern que capture capturas de pantalla al crear o actualizar artículos:

• "Haz capturas de pantalla de la página de configuración de usuario en mi Admin Portal"

• "Documenta el flujo de creación de la clave de API con capturas de pantalla anotadas"

• "Actualiza el artículo de incorporación con capturas de pantalla nuevas del entorno de staging"

Verificar que la automatización funciona

Después de conectar tu panel de control, prueba la integración pidiendo a Fern que cree o actualice un artículo con capturas de pantalla:

Hey Fern, Create a "How to reset your password" article with screenshots from my dashboard

Revisa el borrador del artículo que crea Fern. Una prueba exitosa incluye:

• Las capturas de pantalla aparecen incrustadas en el borrador

• Las imágenes muestran las páginas correctas de tu panel de control

• Las anotaciones (flechas, resaltados) señalan los elementos relevantes

Solución de problemas

Error de inicio de sesión o se requiere iniciar sesión

Fern no pudo iniciar sesión usando tus instrucciones. Causas comunes:

• Etiquetas de botones poco específicas ("Haz clic en el botón de inicio de sesión" en lugar de "Haz clic en 'Sign In'")

• Nombres de campos faltantes ("Introduce el correo electrónico" en lugar de "Introduce el correo electrónico en el campo 'Email Address'")

• Credenciales incorrectas o cuenta de demostración caducada

Edita tu conexión y haz que las instrucciones de inicio de sesión sean más específicas. Usa el texto exacto de los botones y las etiquetas de los campos de tu panel de control.

Inicio de sesión mediante enlace mágico o correo electrónico

Si tu panel de control usa enlaces mágicos o verificación por correo electrónico, Ferndesk puede automatizar el flujo usando una dirección de correo electrónico generada. Consulta Capturas de pantalla de enlace mágico para ver las instrucciones de configuración.

Inicio de sesión con OAuth (Google, GitHub, etc.)

Los proveedores de OAuth de terceros no se pueden automatizar. Alternativas:

• Configura una cuenta de demostración con inicio de sesión por correo electrónico y contraseña

• Configura un entorno de staging que omita OAuth

• Captura las capturas de pantalla manualmente y adjúntalas a tus tareas de Fern

Gestión de conexiones

Conecta varios paneles de control (producción, staging, distintos productos) desde la página de Integrations. Para editar o eliminar una conexión, haz clic en "Manage connections" en la tarjeta de Dashboard.