Je eerste helpcenter lanceren

Een docs-site is een gehost helpcenter dat is gemaakt van de artikelen in je werkruimte, met zoekfunctie, een AI-assistent en feedback van lezers. Dit artikel helpt je van je eerste artikelen naar een live site op je eigen adres. Elke stap linkt naar het artikel met de details.

Voordat je begint#

• Jouw rol: eigenaren en beheerders van werkruimtes kunnen docs-sites aanmaken en configureren. Content Creators kunnen pagina's toevoegen en Editors kunnen publiceren. Zie wie wat kan doen.
• Jouw abonnement: docs-sites zijn beschikbaar op elk abonnement, inclusief Free. Free en Starter bevatten 1 site; Pro bevat 2–5, afhankelijk van het aantal seats. Zie Plannen en limieten voor docs-sites.
• Free-abonnement: voor publiceren is een geverifieerd e-mailadres vereist.

Stap voor stap bouwen#

1. Schrijf je eerste artikelen#

   Een site toont artikelen, dus begin met een paar. Klik op Aanmaken, open het tabblad Artikel en kies een soort: How-to-artikel, Probleemoplossing, Standaardwerkinstructie, Blogpost of Productupdate. Voeg één opname toe, vanuit de desktop-app, de Chrome-extensie, een upload, je bibliotheek of Opnemen met AI, en klik op Artikel genereren. Een artikel kost meestal 5–15 credits. Zie Een opname omzetten in een artikel.

   Heb je al ergens anders een helpcenter? Je kunt dit importeren wanneer je de site aanmaakt (volgende stap).

2. De docs-site aanmaken#

   Klik op Docs-sites in de zijbalk en vervolgens op Nieuwe docs-site. De wizard heeft drie stappen:

   1. Geef je site een naam: typ een Site-naam en controleer het gratis Adres, dat eindigt op .clevera.help. Kies de Taal van de site.
   2. Wat komt erop?: kies Uit een collectie (elke map wordt een sectie), Kies content, Leeg starten of Importeren vanuit een andere tool.
   3. Maak het eigen: voeg een Logo, een Merkkleur, een Lettertype en de Standaardweergave toe.

   Klik op Site aanmaken. Wanneer je start met content, wordt de site direct gepubliceerd op het gratis adres en geopend op Overzicht, met een Aan de slag-checklist. Zie Een docs-site aanmaken.

3. Pagina's toevoegen en ordenen#

   Open Pagina's in de zijbalk van de site om secties toe te voegen, artikelen uit je bibliotheek toe te voegen, nieuwe pagina's te schrijven en de volgorde in te stellen. De checklist vraagt om ten minste 5 pagina's. Zie Pagina's toevoegen en ordenen.

4. De uitstraling instellen#

   Open Weergave om het logo, de merkkleur, de site-stijl, lettertypes en de header van je startpagina te wijzigen. Een live voorbeeld toont elke wijziging. Stel de menu's in de header en footer in via Navigatie. Zie De uitstraling van een docs-site aanpassen en De header en footer van een docs-site instellen.

5. Vraag AI inschakelen#

   De assistent staat uit op een nieuwe site. Ga naar Instellingen → AI-assistent, schakel Toon de assistent in, kies wat er gebeurt Wanneer het geen antwoord kan geven en klik op Opslaan. Het beantwoordt vragen alleen op basis van je gepubliceerde pagina's en vermeldt de bronnen. Antwoorden kosten geen credits; je abonnement bevat een maandelijks aantal antwoorden (300 op Free). Zie De docs-site assistent instellen.

6. Kiezen wie het kan lezen#

   Elke site is standaard openbaar. Om deze privé te maken, ga je naar Instellingen → Toegang en kies je Wachtwoord of Aanmelden bij werkruimte. Privésites vereisen een Pro-abonnement of hoger. Zie Beheren wie een docs-site kan lezen.

7. Publiceren#

   Klik op Publiceren in de header van de site, controleer de lijst met wijzigingen en bevestig (de knop heet bijvoorbeeld 3 wijzigingen publiceren). Lezers zien de nieuwe versie binnen enkele seconden en elke versie wordt bewaard in Publiceren, zodat je wijzigingen ongedaan kunt maken. Automatisch publiceren staat aan voor nieuwe sites: zodra de site live is, worden opgeslagen wijzigingen na ongeveer twee minuten live gezet zonder dat je ze handmatig hoeft te publiceren. Zie Een docs-site publiceren.

8. Je eigen domein verbinden#

   Voor eigen domeinen is een Starter-abonnement of hoger vereist. Open Domein, voer een subdomein in zoals help.example.com en klik op Verbinden. Voeg het CNAME-record dat Clevera toont toe bij je domeinprovider en klik vervolgens op Nu controleren. Het certificaat duurt meestal 5–30 minuten; wanneer de status Live is, wordt het gratis adres omgeleid naar je domein. Root-domeinen zoals example.com kunnen niet worden verbonden. Zie Een eigen domein verbinden met een docs-site.

Laat de Automatische piloot het bouwen#

Bij Pro en hoger kan de Automatische piloot het helpcentrum voor je bouwen en onderhouden. Klik op Automatische piloot in de zijbalk om te beginnen; zie Toegang krijgen tot de Automatische piloot. Alleen de eigenaar van de werkruimte of een beheerder kan het bouwrecept gebruiken.

Een helpcenter bouwen vanuit je app#

Klik in Automatische piloot op het recept Een helpcenter bouwen vanuit mijn app, of typ "Bouw een helpcenter voor mij" in Wat moet de Automatische piloot doen?. De Clevera-agent toont een instellingskaart. Klik op Details invullen, voeg je Website en App-adres toe, kies een aanmeldmethode en selecteer de talen van de site.

Kies onder Bestaand helpcenter voor Opnieuw beginnen, of Importeren en kies Intercom, Zendesk, Help Scout, GitBook, ReadMe, Mintlify, Document360, Docusaurus of Een andere docs-site. De import leest alleen openbare pagina's en is gratis. Notion en Confluence worden geïmporteerd vanuit de instellingen van de site zodra deze bestaat.

De taak verloopt in vier stappen: Merk, Site en video's, Artikelen en Controleren en publiceren. Plannen is gratis. Je ziet het plan en de bijbehorende credits voor elke stap, en er gebeurt niets totdat je op Uitvoeren klikt. Een standaard build kost 240–560 credits en duurt 1–3 uur. Clevera publiceert de site nooit voor je: in de laatste stap kies je de artikelen en klik je op Publiceren. Zie Een helpcenter bouwen vanuit je app met de Automatische piloot.

Houd het actueel wanneer je nieuwe versies uitbrengt#

Zodra de site bestaat, houdt het recept Houd mijn helpcenter up-to-date wanneer we nieuwe versies uitbrengen de releases of samengevoegde wijzigingen van een repository, een changelog-pagina of één wijziging die je beschrijft in de gaten. Elke keer dat er iets verandert, controleert Clevera de betreffende video's en artikelen en plant de correcties. Elke uitvoering wacht op jouw beoordeling; een standaard uitvoering kost 10–150 credits. Zie Houd je helpcenter up-to-date wanneer je nieuwe versies uitbrengt.

Gerelateerd#