Screenshots in deiner Dokumentation automatisieren
Fern kann sich über die Dashboard-Integration in das Dashboard deines Produkts einloggen und kommentierte Screenshots für deine Dokumentation erstellen.
Sie navigiert durch deine authentifizierten Seiten, erstellt Screenshots und fügt visuelle Anmerkungen wie Pfeile hinzu, die auf Schaltflächen oder Menüpunkte zeigen.
So funktioniert es
Nach der Verbindung kann Fern:
Sich mithilfe deiner Anweisungen automatisch einloggen
Zu bestimmten Seiten oder Abläufen navigieren
Screenshots an wichtigen Stellen aufnehmen
Visuelle Anmerkungen (Pfeile, Hervorhebungen) hinzufügen
Verfügbarkeit der Tarife
Automatisierte Screenshots sind während der Beta-Phase derzeit in allen Tarifen verfügbar.
Die vollständige Tarifübersicht findest du unter Ferndesk Preise und Tarife.
Diese Integration befindet sich derzeit in der Beta-Phase.
Du benötigst ein Demo- oder Testkonto für dein Dashboard mit der entsprechenden Zugriffsberechtigung. Stelle sicher, dass du die genauen Login-Schritte kennst.
Einrichten der Dashboard-Integration
Navigiere zur Integrations-Seite und suche die Dashboard-Integrationskarte. Klicke auf die Schaltfläche „Connect“.
Gib drei Informationen an:
Dashboard-Name: Eine Bezeichnung zur Identifizierung dieses Dashboards (z. B. „Unser Admin-Portal“)
Dashboard-URL: Die vollständige URL, bei der Fern beginnen soll (z. B. „https://app.yourproduct.com“)
Login-Anweisungen: Schritt-für-Schritt-Anleitungen für die Anmeldung
Schreiben von Login-Anweisungen
Sei präzise bei Schaltflächenbeschriftungen und Formularfeldnamen. Zum Beispiel:
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: 123456789Je präziser du bist, desto zuverlässiger wird die Automatisierung sein.
Login-Zugangsdaten werden verschlüsselt und sicher gespeichert. Verwende ein dediziertes Demo- oder Testkonto anstelle eines persönlichen oder produktiven Admin-Kontos.
Verwendung der Integration
Frage Fern, beim Erstellen oder Aktualisieren von Artikeln Screenshots aufzunehmen:
„Erstelle Screenshots von der Seite für Benutzereinstellungen in meinem Admin-Portal“
„Dokumentiere den Prozess zur Erstellung von API-Schlüsseln mit kommentierten Screenshots“
„Aktualisiere den Onboarding-Artikel mit neuen Screenshots aus der Staging-Umgebung“
Überprüfung der Automatisierung
Nachdem du dein Dashboard verbunden hast, teste die Integration, indem du Fern bittest, einen Artikel mit Screenshots zu erstellen oder zu aktualisieren:
Hey Fern, Create a "How to reset your password" article with screenshots from my dashboardÜberprüfe den Artikelentwurf, den Fern erstellt. Ein erfolgreicher Test beinhaltet:
Screenshots erscheinen im Entwurf eingebettet
Bilder zeigen die korrekten Seiten deines Dashboards
Anmerkungen (Pfeile, Hervorhebungen) zeigen auf relevante Elemente
Beginne mit einfachen einseitigen Screenshots, bevor du Fern bittest, komplexe mehrstufige Abläufe zu dokumentieren.
Fehlerbehebung
Anmeldung fehlgeschlagen oder Anmeldung erforderlich
Fern konnte sich mit deinen Anweisungen nicht einloggen. Häufige Ursachen:
Vage Schaltflächenbeschriftungen („Klicke auf den Login-Button“ statt „Klicke auf ‚Anmelden‘“)
Fehlende Feldnamen („E-Mail eingeben“ statt „E-Mail in das Feld ‚E-Mail-Adresse‘ eingeben“)
Falsche Zugangsdaten oder abgelaufenes Demokonto
Bearbeite deine Verbindung und mache die Login-Anweisungen präziser. Verwende den exakten Text der Schaltflächen und Feldbezeichnungen aus deinem Dashboard.
Magic Link oder E-Mail-basierte Anmeldung
Wenn dein Dashboard Magic Links oder eine E-Mail-Verifizierung verwendet, kann Ferndesk den Ablauf mithilfe einer generierten E-Mail-Adresse automatisieren. Informationen zur Einrichtung findest du unter Magic-Link-Screenshots.
OAuth-Login (Google, GitHub, etc.)
Drittanbieter von OAuth können nicht automatisiert werden. Problemumgehungen:
Richte ein Demokonto mit E-Mail/Passwort-Anmeldung ein
Konfiguriere eine Staging-Umgebung, die OAuth umgeht
Erstelle Screenshots manuell und hänge sie an deine Fern-Aufgaben an
Verbindungen verwalten
Verbinde mehrere Dashboards (Produktion, Staging, verschiedene Produkte) auf der Integrations-Seite. Um eine Verbindung zu bearbeiten oder zu entfernen, klicke auf der Dashboard-Karte auf „Manage connections“.