Hilfecenter · Zugriff

Jedem Kunden die richtigen Antworten geben

Zeig Anleitungen genau den Menschen, für die sie gedacht sind. Nutze die Basis-Zielgruppen für Besucher und angemeldete Kunden oder erstelle Gruppen aus bestätigten Merkmalen wie Tarif und Rolle.

1. Bestätigte Kundenanmeldung verbinden

Ein Inhaber oder Admin richtet den Zugriff unter Kanäle → dein Kanal → Hilfecenter ein. Die Entwickler deiner Anwendung verbinden die Kundenidentität einmalig. Für Inhalte nur für Besucher kannst du Besucher wählen, ohne einen Anmeldeablauf zu bauen.

Öffne den Tab Live-Chat des Kanals. Verbinde eine Website, falls der Kanal noch keine hat, und such dann Sichere Besucheridentität.
Wähle Optionale Überprüfung oder Nachweis zur Identifizierung verlangen, wähle „Signaturgeheimnis erstellen“ und speichere es ausschließlich in deinem Backend. Ist bereits ein Geheimnis eingerichtet, wähle unter „Überprüfungsmodus“ entweder „Optional – überprüfen, wenn ein JWT vorhanden ist“ oder „Erforderlich für identify und Attribute“. Auch mit „Nachweis zur Identifizierung verlangen“ ist anonymer Chat weiter möglich; den Zugriff auf Inhalte steuert die Zielgruppe des Hilfecenters.
Sobald deine App einen Kunden authentifiziert hat, signiert dein Server ein kurzlebiges Identitätstoken (JWT) mit user_id, email, iat, exp und vertrauenswürdigen Merkmalen. Lies Tarif und Rolle aus deiner eigenen Datenbank. Unsignierte Browser-Attribute und Kontaktfelder können keinen Zugriff gewähren.
Übergib das JWT an das Widget und verbinde eine Anmeldeaktion für das Hilfecenter, damit Leser auch gehostete Seiten oder deine eigene Domain öffnen können. Den genauen Code findest du in der unten verlinkten Anleitung für Entwickler.

Bestätigte Identität erzeugen und senden

Für das Beispiel unten sind das die signierten Merkmale:

JSON · Merkmale im signierten JWT

{"plan":"pro","role":"admin"}

2. Zielgruppe „Pro-Kunden“ erstellen

Geh zurück zu Hilfecenter. Wähle unter Zielgruppen den Plus-Button Neue Zielgruppe oder Zielgruppe erstellen, wenn es deine erste Gruppe ist.
Gib als Name Pro-Kunden ein. Lass „Zutreffen müssen“ auf Alle Regeln stehen.
Gib bei Merkmal plan ein. Setz Bedingung auf ist einer von und Werttyp auf Text.
Gib unter „Werte · einer pro Zeile“ pro und business in getrennten Zeilen ein. Wähle Zielgruppe speichern.
Für eine Gruppe „Admins“ wiederholst du das mit Merkmal role, Bedingung ist, Werttyp Text und Wert admin.

So greifen Regeln: Bei „Alle Regeln“ muss jede Bedingung dieser Zielgruppe zutreffen, bei „Eine beliebige Regel“ mindestens eine. Du kannst bis zu 10 Regeln hinzufügen. Alle geerbten Zielgruppen müssen trotzdem zutreffen, auch wenn eine einzelne Zielgruppe „Eine beliebige Regel“ nutzt.

Bei Text wird zwischen Groß- und Kleinschreibung unterschieden. Die Zahl 5 ist etwas anderes als der Text „5“; wähle Zahl für Vergleiche wie „ist mindestens“. Fehlende Merkmale erfüllen nie einen Vergleich, auch nicht „ist nicht“. „hat einen Wert“ schließt null aus; „hat keinen Wert“ trifft auf fehlende Werte oder null zu. Merkmalsschlüssel beginnen mit einem Buchstaben und bestehen aus Buchstaben, Zahlen oder Unterstrichen, bis zu 64 Zeichen; reservierte Identitätsschlüssel wie email sind keine Merkmale.

3. Zielgruppe dort anwenden, wo du sie brauchst

Ein einzelner Artikel

Öffne den Artikel, setz „Wer darf das lesen?“ auf „Bestätigte Kunden“ und wähle dann unter „Kunden-Zielgruppe“ die Zielgruppe Pro-Kunden. Wähle Veröffentlichen für einen neuen Artikel oder „Änderungen speichern“ für einen Live-Artikel. Ist der Basis-Zugriff geerbt, ist er schreibgeschützt; du kannst aber trotzdem eine zusätzliche Kunden-Zielgruppe wählen.

Eine ganze Kategorie

Wähle unter Kategorien den Stift neben der Kategorie. Wähle „Bestätigte Kunden“ und eine Kunden-Zielgruppe und klick auf Speichern. Jeder Artikel in dieser Kategorie muss diese Einschränkung zusätzlich zu seiner eigenen erfüllen.

Ein privates Hilfecenter

Wähle unter „Zugriff aufs Hilfecenter“ die Option Bestätigte Kunden. Lass „Kunden-Zielgruppe“ auf Alle bestätigten Kunden stehen oder wähle Pro-Kunden, um das ganze Hilfecenter auf diese Gruppe zu beschränken.
Gib die Anmeldeseite deiner Anwendung als Anmelde-URL für Kunden ein, zum Beispiel https://app.example.com/login. Das ist die Anmeldeseite deiner App, nicht die Mitarbeiter-Anmeldung von Sonny.
Nach der Anmeldung muss deine App den Kunden mit einem frisch signierten JWT an den Authentifizierungs-Endpunkt des Hilfecenters schicken. Die Anmelde-URL allein stellt diese Verbindung nicht her.
Wähle Zugriff speichern. Lass das Hilfecenter live, damit berechtigte Kunden es öffnen können.

Anmeldung für gehostete Seiten und eigene Domains verbinden

Einschränkungen addieren sich. Verlangt das Hilfecenter Pro-Kunden und eine Kategorie Admins, gelten für ihre Artikel beide Bedingungen. „Alle“ bei einem Artikel hebt die Kategorie nicht auf. Besucher und bestätigte Kunden sind Basis-Zielgruppen, die sich gegenseitig ausschließen.

4. Vorschau ansehen, dann eine echte Kundensitzung prüfen

Stell oben im Hilfecenter Ansehen als auf Besucher, Bestätigter Kunde oder Kunde mit Merkmalen….
Gib bei „Kunde mit Merkmalen…“ das Beispiel-JSON von oben ein. Abgeblendete Zeilen sind für diesen Leser verborgen; die Zählung berücksichtigt den Veröffentlichungsstatus und alle geerbten Einschränkungen. Mit „Alle Artikel“ kehrst du zur vollständigen Liste zum Bearbeiten zurück.
Teste mit der Tabelle unten ein Hilfecenter nur für Pro-Kunden mit einer Kategorie nur für Admins. Ändere Tarif und Rolle im Beispiel, um jedes Ergebnis zu prüfen.
Öffne einen wirklich abgemeldeten Browser und melde dich dann nacheinander mit jedem Testkunden an. Prüf das Stöbern, die Suche, eine direkte Artikel-URL und den Tab „Hilfe“ im Widget. Die Merkmal-Vorschau meldet dich nicht an und ändert nichts am Zugriff eines Kunden.

Erwarteter Zugriff für ein Hilfecenter nur für Pro-Kunden mit einer Kategorie nur für Admins
Leser	Hilfecenter	Artikel der Admin-Kategorie
Abgemeldeter Besucher	Anmeldeseite	Verborgen
Pro-Kunde, Admin	Darf lesen	Darf lesen
Pro-Kunde, Mitglied	Darf lesen	Verborgen
Free-Kunde, Admin	Zugriffshinweis	Verborgen

Gesperrte Artikel fehlen in den Ergebnissen, und direkte URLs liefern „nicht gefunden“. Ein privates Hilfecenter zeigt statt seiner Inhalte eine gebrandete Anmeldeseite oder einen Zugriffshinweis. Seine Sitemap ist leer und die Indexierung ist untersagt; Artikel nur für Besucher sind ebenfalls nicht in öffentlichen Sitemaps enthalten. KI-Antworten und die Copilot-Suche nutzen dieselben Regeln für die bestätigte Kundenidentität der Unterhaltung.

URLs hochgeladener Bilder sind öffentlich. Einen Artikel einzuschränken schützt seine Bilder nicht, wenn jemand die Bild-URL bereits hat.

Zielgruppe ändern oder entfernen

Bearbeite eine Zielgruppe über ihren Stift-Button und wähle „Zielgruppe speichern“. Regeländerungen gelten ab der nächsten Anfrage. Geänderte Kundenmerkmale erfordern ein neues JWT oder eine neue Anmeldung im Hilfecenter; bestehende signierte Lesersitzungen behalten ihre Merkmale bis zum Ablauf.

Um eine benannte Einschränkung an einer Stelle zu entfernen, wähle unter „Kunden-Zielgruppe“ die Option „Alle bestätigten Kunden“ (oder „Alle in der geerbten Zielgruppe“) und speichere. Soll der Inhalt öffentlich werden, wähle zusätzlich „Alle“ unter „Wer darf das lesen?“ und prüf, ob die übergeordneten Ebenen öffentlichen Zugriff erlauben.

Der Löschen-Button einer Zielgruppe zeigt, wie viele Artikel, Kategorien und Hilfecenter sie verwenden. Beim Löschen fallen die Merkmalsregeln dieser Gruppe weg; verknüpfte Inhalte bleiben auf bestätigte Kunden beschränkt und behalten alle anderen geerbten Einschränkungen. Kunden, die an der gelöschten Regel gescheitert sind, erhalten danach möglicherweise Zugriff. Prüf diese Zuordnungen, bevor du bestätigst.

Fehlerbehebung beim Zugriff

Ein bestätigter Kunde sieht die Anmeldeseite: Prüf den Überprüfungsmodus im Tab „Live-Chat“ dieses Kanals, den Ablauf des JWT, das Signaturgeheimnis und die Anmelde-URL des Hilfecenters. Die Anmeldung im Dashboard für Mitarbeitende ist von der Kundenanmeldung getrennt.
Der Kunde ist angemeldet, kann eine Antwort aber nicht lesen: Prüf jede geerbte Zielgruppe und die genauen Namen, Typen und Werte der signierten Merkmale. Auch ein Pro-Kunde kann an der Admin-Regel einer Kategorie scheitern.
„Wer darf das lesen?“ ist deaktiviert: Das Hilfecenter oder die Kategorie legt die Basis-Zielgruppe fest. Bearbeite die übergeordnete Ebene, um sie zu ändern; mit „Kunden-Zielgruppe“ grenzt du den Zugriff für bestätigte Kunden weiter ein.
„Keine passenden Leser“ wird angezeigt: Einschränkungen nur für Besucher und nur für bestätigte Kunden widersprechen sich. Nutze den geerbten Zugriff, wenn er angeboten wird, oder korrigiere zuerst die Einstellungen von Hilfecenter oder Kategorie.
Ein geänderter Tarif hat den Zugriff noch nicht geändert: Erzeuge ein neues JWT mit den aktualisierten Merkmalen und identifiziere den Kunden im Widget erneut. Bei gehosteten Seiten oder eigenen Domains muss die Anmeldung im Hilfecenter erneut erfolgen. Bestehende Cookies behalten ihre signierten Merkmale bis zum Ablauf.
Ein Artikel fehlt in der Suche oder im Widget: Prüf, ob er veröffentlicht ist, das Hilfecenter live ist, die Suche für Suchergebnisse aktiviert ist und der Leser alle Einschränkungen erfüllt. Ein leerer Tab „Hilfe“ wird ausgeblendet.