Hoe maak ik een interactieve probleemoplosser?

Voordat je begint

• Je hebt rechten nodig om het helpcentrum te beheren.
• Schrijf eerst je artikelen met oplossingen. Een oplossingsstap kan hier direct naar linken.
• Je typt de beslisboom in een geavanceerd veld als tekst in JSON-formaat. Neem de tijd en gebruik het onderstaande voorbeeld als basis.

Stappenplan

1. Open Verhalen en kies Probleemoplossers. Dit opent het overzicht van probleemoplossers.
2. Kies Nieuw.
3. Vul Titel in. Optioneel: Samenvatting en Platform, bijvoorbeeld het apparaat of de app waar het probleem over gaat.
4. Typ in het vak voor het veld tree je beslisboom. Dit veld staat gemarkeerd als "geavanceerd". Gebruik het voorbeeld hieronder.
5. Geeft het vak de melding "That is not valid JSON, so it was not applied."? Controleer dan of er een komma of aanhalingsteken ontbreekt.
6. Plaats het item in de juiste sectie van je helpcentrum en publiceer het.

De structuur van een beslisboom

Een beslisboom bestaat uit een start en een lijst met nodes. Er zijn drie soorten stappen (nodes):

• Vraag bevat text en 2 tot 8 answers. Elk antwoord heeft een label en een next die verwijst naar een volgende stap.
• Oplossen bevat text. Dit kan ook een articleId bevatten (het nummer van een gepubliceerd artikel) of een https-url.
• CONTACT sluit de stappen af bij je paneel "Nog steeds hulp nodig?".

{
  "start": "q1",
  "nodes": [
    { "id": "q1", "kind": "QUESTION", "text": "Do you remember your password?",
      "answers": [ { "label": "Yes", "next": "q2" }, { "label": "No", "next": "f-reset" } ] },
    { "id": "q2", "kind": "QUESTION", "text": "Is two-step sign-in on?",
      "answers": [ { "label": "Yes", "next": "f-code" }, { "label": "No", "next": "c1" } ] },
    { "id": "f-reset", "kind": "FIX", "text": "Reset your password from the sign-in page.", "articleId": 1007 },
    { "id": "f-code", "kind": "FIX", "text": "Check your phone's clock and use a backup code." },
    { "id": "c1", "kind": "CONTACT", "text": "We can help you personally." }
  ]
}

Regels die de site controleert bij het opslaan

• 1 tot 50 stappen (nodes).
• Elk stap-id gebruikt kleine letters, cijfers en koppeltekens, maximaal 40 tekens, en begint met een letter of cijfer. Elk id mag maar één keer voorkomen.
• Een vraag heeft 2 tot 8 antwoorden, en elk antwoord verwijst naar een stap die daadwerkelijk bestaat.
• Elke stap moet bereikbaar zijn vanaf start.
• De boom mag geen lus vormen. Verwijst een antwoord terug naar een eerdere vraag, dan zie je: "This troubleshooter loops back to an earlier step. Every path must end with a fix or contact step."
• De boom mag maximaal 32 KB groot zijn.

Goed om te weten

• Elke gepubliceerde probleemoplosser krijgt een eigen pagina op je website.
• Inzichten. In Help-inzichten vind je Waar probleemoplossers eindigden, zodat je precies ziet welke oplossingen lezers bereiken.
• Een oplossing met een articleId linkt alleen naar het artikel zolang dat artikel gepubliceerd staat.

Veelvoorkomende problemen

• "This troubleshooter loops back to an earlier step." Een antwoord verwijst terug. Pas de next aan naar een oplossings- of contactstap.
• Foutmelding over de boom bij het opslaan. De melding noemt fields.tree. Er ontbreekt een onderdeel in een stap, zoals text of een geldige next. Vergelijk het met het voorbeeld.

Vragen

Gerelateerd

• Help-hubs
• Contactopties
• Zoekinzichten en suggesties
• Helpcentrum en documentatie