Helpcentrum · Handleiding toegang

Geef elke klant de juiste antwoorden

Toon uitleg aan de mensen voor wie die bedoeld is. Gebruik basisdoelgroepen voor bezoekers en ingelogde klanten, of maak groepen op basis van geverifieerde kenmerken zoals abonnement en rol.

1. Koppel inloggen voor geverifieerde klanten

Een eigenaar of beheerder stelt de toegang in via Kanalen → je kanaal → Helpcentrum. De ontwikkelaar van je applicatie koppelt de klantidentiteit één keer. Voor content die alleen voor bezoekers is, kun je Bezoekers kiezen zonder een inlogflow te bouwen.

  1. Open het tabblad Livechat van het kanaal. Koppel een website als het kanaal er nog geen heeft en zoek daarna Veilige bezoekersidentiteit.
  2. Kies Optionele verificatie of Bewijs vereisen om te identificeren, kies Ondertekeningsgeheim genereren en bewaar het alleen op je backend. Is er al een geheim ingesteld, kies dan bij Verificatiemodus voor Optioneel — verifiëren als er een JWT is of Vereist voor identify en kenmerken. Ook met Bewijs vereisen om te identificeren kunnen bezoekers nog anoniem chatten; de doelgroep van het helpcentrum bepaalt de toegang tot content.
  3. Nadat je app een klant heeft ingelogd, ondertekent je server een kortlevend identiteitstoken (JWT) met user_id, email, iat, exp en betrouwbare kenmerken. Lees abonnement en rol uit je eigen database. Niet-ondertekende kenmerken uit de browser en contactvelden kunnen geen toegang geven.
  4. Geef de JWT door aan de widget en koppel een inlogactie voor het helpcentrum voor mensen die gehoste pagina's of je eigen domein openen. Gebruik de handleiding voor ontwikkelaars hieronder voor de exacte code.
Een geverifieerde identiteit genereren en versturen

Voor het voorbeeld hieronder zijn dit de ondertekende kenmerken:

JSON · kenmerken in de ondertekende JWT
{"plan":"pro","role":"admin"}

2. Maak een doelgroep Pro-klanten aan

  1. Ga terug naar Helpcentrum. Kies bij Doelgroepen voor Nieuwe doelgroep (de plusknop), of Een doelgroep aanmaken als dit je eerste groep is.
  2. Vul Pro-klanten in als Naam. Laat Voldoen aan op Alle regels staan.
  3. Vul bij Kenmerk plan in. Zet Voorwaarde op is een van en Type waarde op Tekst.
  4. Vul pro en business op aparte regels in bij Waarden · één per regel. Kies Doelgroep opslaan.
  5. Wil je een groep Beheerders aanmaken, herhaal dit dan met Kenmerk role, Voorwaarde is, Type waarde Tekst en Waarde admin.

Hoe regels werken: bij Alle regels moet aan elke voorwaarde in deze doelgroep worden voldaan; bij Eén regel aan minstens één. Je kunt maximaal 10 regels toevoegen. Aan alle overgenomen doelgroepen moet nog steeds worden voldaan, ook als een bepaalde doelgroep Eén regel gebruikt.

Tekst is hoofdlettergevoelig. Het getal 5 is iets anders dan de tekst „5”; kies Getal voor vergelijkingen zoals is minstens. Ontbrekende kenmerken voldoen nooit aan een vergelijking, ook niet aan is niet. Heeft een waarde sluit null uit; heeft geen waarde past bij ontbrekend of null. Kenmerksleutels beginnen met een letter en bestaan uit letters, cijfers of underscores, tot 64 tekens; gereserveerde identiteitssleutels zoals email zijn geen kenmerken.

3. Pas de doelgroep toe waar je hem nodig hebt

Eén artikel

Open het artikel, zet Wie kan dit lezen? op Geverifieerde klanten en kies daarna Pro-klanten bij Klantdoelgroep. Kies Publiceren voor een nieuw artikel of Wijzigingen opslaan voor een live artikel. Wordt de basistoegang overgenomen, dan is die alleen-lezen; je kunt nog wel een extra klantdoelgroep kiezen.

Een hele categorie

Kies het potloodje naast de categorie onder Categorieën. Kies Geverifieerde klanten en een Klantdoelgroep, en daarna Opslaan. Elk artikel in die categorie moet aan deze beperking voldoen én aan zijn eigen beperking.

Een privé-helpcentrum

  1. Kies bij Toegang tot helpcentrum voor Geverifieerde klanten. Laat Klantdoelgroep op Alle geverifieerde klanten staan, of kies Pro-klanten om het hele helpcentrum tot die groep te beperken.
  2. Vul de inlogpagina van je applicatie in als Inlog-URL voor klanten, bijvoorbeeld https://app.example.com/login. Dit is de inlogpagina van je app, niet de inlogpagina voor teamleden van Sonny.
  3. Na het inloggen moet je app de klant naar het authenticatie-endpoint van het helpcentrum sturen, met een nieuwe ondertekende JWT. Alleen de inlog-URL maakt deze koppeling niet compleet.
  4. Kies Toegang opslaan. Laat het helpcentrum Live staan, zodat klanten met toegang het kunnen openen.
Inloggen koppelen voor gehoste pagina's en eigen domeinen

Beperkingen tellen bij elkaar op. Vereist het helpcentrum Pro-klanten en een categorie Beheerders, dan vereisen de artikelen in die categorie allebei. Iedereen op een artikel heft de beperking van de categorie niet op. Bezoekers en geverifieerde klanten zijn basisdoelgroepen die elkaar uitsluiten.

4. Bekijk een voorbeeld en controleer daarna een echte klantsessie

  1. Zet bovenaan Helpcentrum Bekijken als op Bezoeker, Geverifieerde klant of Klant met kenmerken….
  2. Vul bij Klant met kenmerken… de voorbeeld-JSON van hierboven in. Gedimde rijen zijn verborgen voor die lezer; de telling houdt rekening met de publicatiestatus en alle overgenomen beperkingen. Met Alle artikelen ga je terug naar de volledige lijst voor schrijvers.
  3. Gebruik de tabel hieronder om een helpcentrum alleen voor Pro-klanten te testen, met een categorie alleen voor beheerders. Pas het voorbeeldabonnement en de rol aan om elk resultaat te controleren.
  4. Open een echte, uitgelogde browser en log daarna in als elke testklant. Controleer bladeren, zoeken, een directe artikel-URL en het tabblad Hulp in de widget. Een voorbeeld met kenmerken logt je niet in en verandert de toegang van een klant niet.
Verwachte toegang voor een helpcentrum alleen voor Pro-klanten en een categorie alleen voor beheerders
LezerHelpcentrumArtikel in beheerderscategorie
Uitgelogde bezoekerInlogpaginaVerborgen
Pro-klant, beheerderKan lezenKan lezen
Pro-klant, lidKan lezenVerborgen
Gratis klant, beheerderToegangsmeldingVerborgen

Artikelen zonder toegang worden weggelaten uit resultaten en directe URL's geven niet gevonden. Een privé-helpcentrum toont een inlogpagina of toegangsmelding in je eigen huisstijl in plaats van de content. De sitemap is leeg en indexeren is niet toegestaan; artikelen alleen voor bezoekers staan ook niet in openbare sitemaps. AI-antwoorden en AI Copilot gebruiken dezelfde regels voor de geverifieerde klantidentiteit van het gesprek.

URL's van geüploade afbeeldingen zijn openbaar. Een artikel beperken beschermt de afbeeldingen niet als iemand de URL van de afbeelding al heeft.

Een doelgroep wijzigen of verwijderen

Bewerk een doelgroep met het potloodje en kies Doelgroep opslaan. Gewijzigde regels gelden vanaf het volgende verzoek. Bijgewerkte klantkenmerken vereisen een nieuwe JWT of opnieuw inloggen op het helpcentrum; bestaande ondertekende lezerssessies houden hun kenmerken tot ze verlopen.

Wil je een benoemde beperking op één plek weghalen, kies dan Alle geverifieerde klanten (of Iedereen in de overgenomen doelgroep) bij Klantdoelgroep en sla op. Wil je die content openbaar maken, kies dan ook Iedereen bij Wie kan dit lezen? en controleer of de bovenliggende niveaus openbare toegang toestaan.

De verwijderknop van de doelgroep laat zien hoeveel artikelen, categorieën en helpcentra hem gebruiken. Verwijderen haalt de kenmerkregels van die groep weg; gekoppelde content blijft alleen voor geverifieerde klanten en behoudt andere overgenomen beperkingen. Klanten die eerder niet aan de verwijderde regel voldeden, kunnen nu toegang krijgen. Controleer die toewijzingen voordat je bevestigt.

Problemen met toegang oplossen

Een geverifieerde klant ziet de inlogpagina
Controleer de verificatiemodus op het tabblad Livechat van dit kanaal, de vervaltijd van de JWT, het ondertekeningsgeheim en de inlog-URL van het helpcentrum. Inloggen op het dashboard voor teamleden staat los van inloggen voor klanten.
De klant is ingelogd maar kan een antwoord niet lezen
Controleer elke overgenomen doelgroep en de exacte namen, typen en waarden van de ondertekende kenmerken. Een Pro-klant kan nog steeds niet voldoen aan de beheerdersregel van een categorie.
Wie kan dit lezen? is uitgeschakeld
Het helpcentrum of de categorie bepaalt de basisdoelgroep. Bewerk dat bovenliggende niveau om het te wijzigen; gebruik Klantdoelgroep om de toegang voor geverifieerde klanten verder te beperken.
Geen passende lezers verschijnt
Beperkingen alleen voor bezoekers en alleen voor geverifieerde klanten botsen met elkaar. Gebruik de overgenomen toegang als die wordt aangeboden, of corrigeer eerst de instellingen van het helpcentrum of de categorie.
Een gewijzigd abonnement heeft de toegang nog niet veranderd
Maak een nieuwe JWT aan met de bijgewerkte kenmerken en identificeer opnieuw in de widget. Log voor gehoste pagina's of pagina's op je eigen domein opnieuw in op het helpcentrum. Bestaande cookies houden hun ondertekende kenmerken tot ze verlopen.
Een artikel ontbreekt in de zoekresultaten of de widget
Controleer of het is gepubliceerd, het helpcentrum Live staat, Zoeken is ingeschakeld voor zoekresultaten en de lezer aan alle beperkingen voldoet. Een leeg tabblad Hulp wordt verborgen.

Gerelateerde handleidingen