Automatiser les captures d'écran dans votre documentation

Fern peut se connecter au tableau de bord de votre produit et capturer des captures d'écran annotées pour votre documentation à l'aide de l'intégration Dashboard.

Elle naviguera sur vos pages authentifiées, prendra des captures d'écran et ajoutera des annotations visuelles comme des flèches pointant vers des boutons ou des éléments de menu.

Comment ça marche

Une fois connectée, Fern peut :

• Se connecter automatiquement en utilisant les instructions fournies

• Naviguer vers des pages ou des flux spécifiques

• Capturer des captures d'écran à des moments clés

• Ajouter des annotations visuelles (flèches, mises en évidence)

Configuration de l'intégration Dashboard

Accédez à la page Intégrations et localisez la carte d'intégration Dashboard. Cliquez sur le bouton Connect.

Fournissez trois types d'informations :

• Nom du tableau de bord : Une étiquette pour identifier ce tableau de bord (par ex., « Notre portail d'administration »)

• URL du tableau de bord : L'URL complète où Fern doit commencer (par ex., « https://app.votreproduit.com »)

• Instructions de connexion : Instructions étape par étape pour se connecter

Rédiger des instructions de connexion

Soyez précis sur les libellés des boutons et les noms des champs de formulaire. Par exemple :

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

Utiliser l'intégration

Demandez à Fern de capturer des captures d'écran lors de la création ou de la mise à jour d'articles :

• « Prends des captures d'écran de la page des paramètres utilisateur dans mon portail d'administration »

• « Documente le flux de création de clé API avec des captures d'écran annotées »

• « Mets à jour l'article d'intégration avec de nouvelles captures d'écran de l'environnement de staging »

Vérifier que l'automatisation fonctionne

Après avoir connecté votre tableau de bord, testez l'intégration en demandant à Fern de créer ou de mettre à jour un article avec des captures d'écran :

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

Vérifiez le brouillon de l'article créé par Fern. Un test réussi inclut :

• Les captures d'écran apparaissent intégrées dans le brouillon

• Les images affichent les bonnes pages de votre tableau de bord

• Les annotations (flèches, mises en évidence) pointent vers les éléments pertinents

Dépannage

Échec de la connexion ou Connexion requise

Fern n'a pas pu se connecter en utilisant vos instructions. Causes communes :

• Libellés de boutons vagues (« Cliquez sur le bouton de connexion » au lieu de « Cliquez sur 'Se connecter' »)

• Noms de champs manquants (« Entrez l'e-mail » au lieu de « Entrez l'e-mail dans le champ 'Adresse e-mail' »)

• Identifiants incorrects ou compte de démonstration expiré

Modifiez votre connexion et rendez les instructions de connexion plus spécifiques. Utilisez le texte exact des boutons et les libellés des champs de votre tableau de bord.

Lien magique ou connexion par e-mail

Si votre tableau de bord utilise des liens magiques ou une vérification par e-mail, Ferndesk peut automatiser le flux en utilisant une adresse e-mail générée. Voir Captures d'écran par lien magique pour les instructions de configuration.

Connexion OAuth (Google, GitHub, etc.)

Les fournisseurs OAuth tiers ne peuvent pas être automatisés. Solutions de contournement :

• Configurez un compte de démonstration avec une connexion e-mail/mot de passe

• Configurez un environnement de staging qui contourne OAuth

• Capturez manuellement les captures d'écran et joignez-les à vos tâches Fern

Gestion des connexions

Connectez plusieurs tableaux de bord (production, staging, différents produits) à partir de la page Intégrations. Pour modifier ou supprimer une connexion, cliquez sur « Gérer les connexions » sur la carte Dashboard.