Widget-Übersicht

Shayan TaslimAktualisiert

Das UserJot-Widget bündelt Feedback, deine Roadmap, Produktneuigkeiten, Hilfeartikel und Direktnachrichten in einem einzigen In-App-Launcher auf deiner Website.

Die in dieser Sammlung dokumentierte API ist stabil. Im Laufe der Zeit kommen neue Funktionen hinzu, ohne dass Methoden umbenannt oder bestehende Funktionen beeinträchtigt werden.

Was das Widget umfasst

Die untere Navigationsleiste passt sich automatisch an die in Ihrem Workspace aktivierten Funktionen an:

  • Startseite: Wird immer angezeigt. Zeigt aktuelle Updates, Hilfe-Links, Highlights zu laufenden Roadmap-Projekten (wenn Ihre Roadmap aktiviert ist) und Aktivitäten des aktuellen Benutzers.

  • Nachrichten: Wird angezeigt, wenn Conversations aktiviert ist. Direkter Chat zwischen Kunden, Juno und Ihrem Team.

  • Hilfe: Wird angezeigt, wenn Ihr Help Center live ist. Hilfeartikel direkt in der App suchen und lesen.

  • Feedback: Wird immer angezeigt. Feedback ansehen, suchen, dafür abstimmen, kommentieren und einreichen, ohne Ihre App zu verlassen (Roadmap ist außerdem unter Feedback und Startseite verfügbar oder lässt sich direkt mit uj.open({ to: 'roadmap' }) öffnen). Wenn ein Kunde eine neue Idee eingibt (mindestens 3 Zeichen), zeigt der Editor in Echtzeit eine Vorschlagskarte mit dem Hinweis Bereits im Board an, sofern es bereits eine passende Anfrage gibt.

  • Updates: Wird angezeigt, wenn Ihr öffentlicher Changelog aktiviert ist; auf dem Launcher erscheint ein Hinweis auf ungelesene Updates.

  • Benachrichtigungen: Wird bei identifizierten Benutzern als Glockensymbol in der Kopfzeile angezeigt und weist auf Aktivitäten zu Anfragen hin, denen sie folgen.

In Desktop-Ansichten (breiter als 760px) merkt sich das geöffnete Widget für 30 Minuten den geöffneten Zustand, den Bildschirm und die Scrollposition – auch nach dem Neuladen der Seite und beim Navigieren im selben Tab. Hilfeartikel und Changelog-Updates werden auf dem Desktop automatisch in einer breiteren Ansicht geöffnet. Unterhaltungsverläufe verfügen über eine Schaltfläche zum Erweitern.

Screenshots erfassen und annotieren

Kunden können beim Einreichen von Feedback im Widget bis zu 4 Bilder anhängen (PNG, JPEG oder WebP, jeweils bis zu 10 MB), indem sie Dateien auswählen, sie aus der Zwischenablage einfügen oder auf die Kameraschaltfläche klicken, um einen Screenshot aufzunehmen.

  • Erfassung mit Ausweichlösung: Beim Klicken auf die Screenshot-Schaltfläche wird die Erfassung des Browser-Tabs oder Bildschirms verwendet (getDisplayMedia). Ist die Bildschirmaufnahme nicht verfügbar, wird automatisch auf die DOM-Erfassung innerhalb der Seite zurückgegriffen (Widget-Oberflächen werden dabei automatisch ausgeblendet).

  • Integrierter Annotationseditor: Vor dem Anhängen können Kunden den Screenshot mit sechs Werkzeugen und Tastenkürzeln markieren: Auswählen (V), Stift (P), Pfeil (A), Rechteck (R), Text (T) und verpixeltes Schwärzen (B). Außerdem gibt es sechs Farben, Rückgängig sowie Entf / Rücktaste, um ausgewählte Formen zu entfernen.

  • Datenschutzmaskierung: Bei der DOM-Erfassung innerhalb der Seite maskiert UserJot automatisch Eingabefelder vom Typ password, email und tel, Eingabefelder mit token oder secret in ihrem name sowie Textbereiche mit dem Attribut data-userjot-sensitive. Fügen Sie data-userjot-capture-ignore hinzu, um ein DOM-Element von der Erfassung auszuschließen, oder data-userjot-capture-mask, um es automatisch zu schwärzen.

Berechtigungen, Bearbeitung und Moderation

  • Anonyme und identifizierte Benutzer: Anonyme Besucher können Feedback ansehen, neues Feedback einreichen, Gastunterhaltungen starten und auf Changelog-Updates reagieren. Um für Feedback abzustimmen, Kommentare zu verfassen und die Glocke für Benachrichtigungen im Widget anzusehen, ist ein identifizierter Benutzer erforderlich.

  • Eigene Inhalte bearbeiten und löschen: Kunden können eigene Beiträge und Kommentare direkt über das Menü ... bearbeiten (Titel und Text bei Beiträgen, Text bei Kommentaren) und löschen. Im Widget müssen Kunden zum Bearbeiten oder Löschen eigener Beiträge oder Kommentare eine signierte Identität haben (nicht signierte uj.identify-Sitzungen können keine Inhalte bearbeiten oder löschen).

  • Moderation: Für über das Widget eingereichtes Feedback gelten die Moderationseinstellungen Ihres Workspace. Eine Bestätigung zeigt an, dass das Feedback gespeichert wurde. Bevor es auf dem öffentlichen Board erscheint, muss es möglicherweise noch geprüft werden. Weitere Informationen finden Sie unter Inhalte moderieren.

Das Widget ermöglicht anonyme Beiträge in allen Tarifen, unabhängig von der Einstellung Gastbeiträge des öffentlichen Boards. Diese Einstellung gilt nur für das öffentliche Board. Da sich das Widget programmatisch steuern lässt, entscheiden Sie, wann es geladen oder angezeigt wird (zum Beispiel nur für angemeldete Benutzer). Zum Einreichen von Feedback ist keine Identifizierung erforderlich.

Was du damit umsetzen kannst

Das Widget funktioniert sofort mit einem einfachen Snippet zum Kopieren und Einfügen. Mit dem SDK kannst du es außerdem programmatisch steuern:

  • Öffne mit open() jeden beliebigen Bereich des Widgets über deine eigene Benutzeroberfläche.

  • Ersetze den Standard-Launcher durch deinen eigenen Button mit Live-Anzeige für ungelesene Nachrichten.

  • Identifiziere angemeldete Benutzer, optional serverseitig verifiziert mit signierter Identität (HS256-JWT).

  • Reagiere auf Widget-Ereignisse wie Öffnen, Schließen, Anwesenheit und Anzahl ungelesener Nachrichten.

  • Bette ganze Seiten direkt ein, statt den schwebenden Launcher zu verwenden.

  1. Installiere das Widget in wenigen Minuten.

  2. Identifiziere deine Benutzer, damit Feedback und Nachrichten den richtigen Konten zugeordnet werden.

  3. Füge signierte Identität hinzu, wenn du Benutzer serverseitig verifizieren möchtest, oder richte Automatische Anmeldung und Single Sign-on für deine öffentlichen Seiten ein.

  4. Lies mehr über Die Steuerung des Widgets, Das direkte Einbetten von Seiten und die SDK-Referenz.

Hat das Ihre Frage beantwortet?