Automatizar 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 utilizando la integración Dashboard.

Ella navegará por tus páginas autenticadas, tomará capturas de pantalla y añadirá anotaciones visuales como flechas apuntando a botones o elementos de menú.

Cómo funciona

Una vez conectada, Fern puede:

• Iniciar sesión automáticamente utilizando las instrucciones proporcionadas

• 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

Dirígete a la página de Integraciones y localiza la tarjeta de integración Dashboard. Haz clic en el botón Connect.

Proporciona tres datos de información:

• Dashboard Name: Una etiqueta para identificar este panel (p. ej., "Nuestro Portal de Administración")

• Dashboard URL: La URL completa donde Fern debe comenzar (p. ej., "https://app.tuproducto.com")

• Login Instructions: Instrucciones paso a paso para iniciar sesión

Escribir 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

Uso de la integración

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

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

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

• "Actualiza el artículo de incorporación con capturas de pantalla frescas de staging"

Verificar que la automatización funciona

Después de conectar tu panel, 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

• Las anotaciones (flechas, resaltados) apuntan a los elementos pertinentes

Solución de problemas

Fallo en el inicio de sesión o Inicio de sesión requerido

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

• Etiquetas de botones vagas ("Haz clic en el botón de login" en lugar de "Haz clic en 'Sign In'")

• Falta de nombres de campos ("Escribe el correo" en lugar de "Escribe el correo 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. Utiliza el texto exacto de los botones y las etiquetas de los campos de tu panel.

Magic link o inicio de sesión OAuth

Si tu panel utiliza magic links o OAuth de terceros (Google, GitHub), la automatización del navegador no puede acceder a flujos de inicio de sesión externos. Alternativas:

• Configura una cuenta de demostración con inicio de sesión mediante email/contraseña

• Configura un entorno de staging que omita el OAuth

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

Gestión de conexiones

Conecta múltiples paneles (producción, staging, diferentes productos) desde la página de Integraciones. Para editar o eliminar una conexión, haz clic en "Manage connections" en la tarjeta Dashboard.