Ferndesk
Versionshinweise

Launch-Woche: Mitwirkende, mehrere Widgets und eine Changelog-API

Am Launch-Tag haben wir versprochen, bis Mitternacht so viel wie menschenmöglich umzusetzen. Das haben wir in dieser Woche geschafft: eine sicherere Möglichkeit, mehr Teammitglieder an der Dokumentation schreiben zu lassen, ein Widget für jede Oberfläche Ihres Produkts und die ersten Schritte, damit Ihre eigenen Tools Ihren Changelog verwalten können.

  • ✍️ Rolle für Mitwirkende: Lassen Sie mehr Teammitglieder Entwürfe für Dokumente erstellen – jede Änderung wird geprüft, bevor sie live geht

  • 🧩 Mehrere Widgets: Ein Widget in Ihrer App, ein weiteres in Ihrem Entwicklerportal – jedes mit eigenen Inhalten

  • 🙋 Sie entscheiden, was passiert, wenn ein Besucher einen Menschen braucht: Leiten Sie die Anfrage weiter, fügen Sie Kontext hinzu oder übernehmen Sie die Übergabe direkt auf Ihrer Website

  • 🧹 Audits bringen Ordnung in Ihre Struktur: Fern erkennt unübersichtliche Sammlungen und ordnet sie neu

  • 📣 Changelog-API und Webhook: Erstellen Sie Einträge mit Ihren eigenen Tools und lösen Sie Release-E-Mails aus, sobald ein Eintrag live geht

  • 🔍 Warum Fern diese Änderung vorgenommen hat: Sehen Sie genau, welcher Satz durch einen Pull Request veraltet ist

Mitwirkende und Prüfanfragen

Laden Sie Teammitglieder als Mitwirkende ein. Sie können Artikel entwerfen und mit Fern zusammenarbeiten, aber statt sie zu veröffentlichen, wählen sie Zur Prüfung einreichen und fügen optional eine Notiz hinzu.

Inhaber und Administratoren erhalten eine E-Mail, und die Anfrage erscheint in der Seitenleiste unter Prüfanfragen. Gehen Sie alle Änderungen in der Anfrage durch, vergleichen Sie jeden Artikel mit der Live-Version und veröffentlichen Sie alles mit einem Klick. Die Veröffentlichung bezieht sich genau auf die geprüfte Version, sodass sich nichts unbemerkt ändert.

Mitwirkende können Artikel nicht zurückziehen, löschen oder verschieben, Sammlungen nicht bearbeiten und Workspace-Einstellungen nicht ändern. Für ihre API-Schlüssel und Verbindungen zu KI-Tools gelten dieselben Regeln. Jedes Mitglied, auch Mitwirkende, belegt einen Platz. Siehe Team.

Mehrere Widgets, jedes mit eigenen Inhalten

Sie können jetzt im Dashboard mehrere Widgets erstellen, benennen und verwalten – jedes mit eigenem Erscheinungsbild, eigenen Einstellungen und eigenem Installations-Snippet. Jede Widget-Karte zeigt eine Vorschau und die Aktivitäten der letzten 30 Tage.

Jedes Widget kann außerdem bestimmte Help-Center-Bereiche ausblenden. Ihr In-App-Widget kann sich auf Produkthilfe beschränken, während Ihr Entwicklerportal-Widget nur die API-Dokumentation anzeigt. Ausgeschlossene Bereiche erscheinen nicht im Durchsuchen-Tab, in der Suche, in Changelogs und in KI-Antworten dieses Widgets. Dadurch wird eingeschränkt, was ein Widget anzeigt, nicht der Zugriff darauf: Verwenden Sie dafür den Bereichszugriff. Wählen Sie die Bereiche unter Widget > Anpassen > Inhalte aus. Siehe Widget-Einstellungen konfigurieren.

Sie entscheiden, was passiert, wenn ein Besucher einen Menschen braucht

Wenn Fern keine Antwort geben kann oder ein Besucher um einen Menschen bittet, kann jetzt Ihre Website übernehmen. Das Widget löst die Ereignisse escalationOffered und escalationRequested aus. So können Sie eigene Optionen anzeigen (z. B. Antwortzeiten oder ein Upgrade des Tarifs), den Besucher zu einem anderen Chat-Tool weiterleiten oder die Anfrage vollständig übernehmen.

Sie können unter Einstellungen > KI-Assistent auch Übergabeauslöser einrichten. Fern beantwortet weiterhin Fragen, die von Ihren Dokumenten abgedeckt werden, und versieht die Übergabe anschließend mit einem Tag, damit Ihre Website sie an die richtige Stelle weiterleiten kann. Ohne Handler oder Auslöser ändert sich nichts. Siehe Verhalten bei KI-Eskalation und Übergabe und die SDK-Referenz.

Audits bringen jetzt Ordnung in Ihre Struktur

Help-Center werden mit der Zeit unübersichtlich: zwei Sammlungen decken dasselbe Thema ab, Ordner sind vier Ebenen tief verschachtelt. Jedes Audit prüft jetzt die Organisation Ihrer Bereiche und Sammlungen (bei Help-Centern mit mindestens 10 Artikeln, die nicht von einer anderen Plattform synchronisiert werden) und schlägt bis zu drei konkrete Korrekturen vor, etwa „Zahlungen mit der Sammlung Abrechnung zusammenführen“. Jeder Fund zeigt genau, welche Verschiebungen geplant sind. Wenn Sie ihn zuweisen, ordnet Fern Ihre Sammlungen neu.

Bei einer übersichtlichen Struktur gibt es keine Funde und damit auch keine unnötige Arbeit. Fern verschiebt niemals Inhalte zwischen Bereichen oder Zielgruppen und ändert niemals Changelogs. Siehe So prüft Fern Ihr Help-Center.

Changelog-API und Webhook

Changelogs sind jetzt Teil der öffentlichen API. Listen Sie Changelogs und Einträge auf, erstellen Sie Entwürfe mit Ihren eigenen Tools (oder Ihrem eigenen KI-Agenten), bearbeiten Sie sie und veröffentlichen Sie sie. Siehe Changelog-Eintrag erstellen.

Der neue Webhook changelog_entry.published wird einmal ausgelöst, wenn ein Eintrag live geht, und enthält Titel, Link, Datum, Tags und Textkörper in HTML und Markdown. Bei späteren Bearbeitungen wird er nicht erneut ausgelöst, sodass Sie damit bedenkenlos Release-E-Mails versenden können. Siehe Changelog-Eintrag veröffentlicht.

Warum Fern diese Änderung vorgenommen hat

Bevor Sie eine Dokumentationsaktualisierung zu einem zusammengeführten Pull Request freigeben, öffnen Sie Warum Fern diese Änderung vorgenommen hat. Sie sehen, was sich in Ihrem Produkt geändert hat (neu, geändert, verschoben, umbenannt, entfernt oder behoben), wie sicher sich Fern ist, den genauen Satz in jedem Artikel, der durch den Pull Request veraltet ist, und alles, was sie nicht bestätigen konnte.

Bei jeder Codeänderung wird außerdem angezeigt, wer den Pull Request eröffnet hat. So erkennen Teammitglieder auf einen Blick ihre eigene Arbeit, und Sie können Threads nach GitHub-Benutzernamen durchsuchen. Siehe Automatische PR-Entwürfe.

Weitere Verbesserungen

  • Einbettungen passen ihre Größe richtig an: Benutzerdefinierte HTML-Einbettungen, die den Bildschirm ausfüllen, etwa API-Explorer, erhalten ungefähr eine Bildschirmhöhe, statt zu einer riesigen leeren Fläche anzuwachsen.

  • Eine bessere 404-Seite: Sie haben sich auf ferndesk.com verirrt? Helfen Sie Fern dabei, ein veraltetes Help-Center zu korrigieren, wenn Sie schon einmal da sind.

Fehlerbehebungen

  • Der Bildeditor öffnet jetzt wieder alle Bilder, auch solche, die von Plattformen ohne korrekten Dateityp importiert wurden.

  • Nachrichten aus dem Kontaktformular behalten ihre Zeilenumbrüche, wenn sie in Ihrem Posteingang ankommen.

  • Die Fern-Aufgabenseite wird nicht mehr schon in den ersten Sekunden einer Aufgabe oder direkt nach einem Klick auf „Stopp“ nicht mehr aktualisiert.

Gut zu wissen

  • Zusammengeführte Sammlungen werden noch nicht weitergeleitet: Wenn Fern bei einem Audit Sammlungen zusammenführt, funktioniert die URL der alten Sammlung nicht mehr. Richten Sie dafür unter Weiterleitungen für das Help-Center eine Weiterleitung ein, falls die Sammlung von anderer Stelle verlinkt wurde.