Como criar um solucionador de problemas com perguntas e soluções?

Antes de começar

• Você precisa de permissão para gerenciar a central de ajuda.
• Escreva seus artigos de solução primeiro. Uma etapa de solução pode ter um link para um deles.
• A árvore é digitada em um campo avançado, como texto no formato JSON. Faça com calma e copie o exemplo abaixo.

Passo a passo

1. Abra Matérias e escolha Solucionadores de problemas. Isso abre a lista de solucionadores de problemas.
2. Escolha Novo.
3. Preencha Título. Opcional: Resumo e Plataforma, por exemplo, o dispositivo ou aplicativo sobre o qual é o problema.
4. Na caixa para o campo tree, digite a sua árvore. Ela está marcada como “avançado”. Use o exemplo abaixo.
5. Se a caixa exibir "That is not valid JSON, so it was not applied.", procure por uma vírgula ou aspas faltando.
6. Coloque a entrada na seção correta do hub e publique.

A estrutura de uma árvore

Uma árvore tem um start e uma lista de nodes. Existem três tipos de nó:

• Pergunta tem text e de 2 a 8 answers. Cada resposta tem um label e um next que indica outro nó.
• Corrigir tem text. Também pode ter um articleId, o número de um dos seus artigos publicados, ou uma url https.
• Contato finaliza o caminho no seu painel "Ainda precisa de ajuda?".

{
  "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." }
  ]
}

Regras que o site verifica quando você salva

• 1 a 50 nós.
• Os IDs dos nós usam letras minúsculas, números e traços, com até 40 caracteres, começando com uma letra ou número. Cada ID é usado uma única vez.
• Uma pergunta tem de 2 a 8 respostas, e cada resposta aponta para um nó existente.
• Todo nó pode ser acessado a partir de start.
• A árvore não pode ter repetições em ciclo. Se uma resposta levar de volta a uma pergunta anterior, você verá: "This troubleshooter loops back to an earlier step. Every path must end with a fix or contact step."
• A árvore pode ter até 32 KB.

Importante saber

• Cada solucionador de problemas publicado tem sua própria página no seu site.
• Métricas. Help insights mostra Onde os solucionadores terminaram, para que você possa ver quais soluções os leitores alcançam.
• Uma solução com um articleId inclui o link para o artigo apenas enquanto esse artigo estiver publicado.

Problemas comuns

• "This troubleshooter loops back to an earlier step." Uma resposta aponta para trás. Altere o next dela para um nó de solução ou de contato.
• Um erro ao salvar sobre a árvore. O erro cita fields.tree. Falta uma parte em um nó, como text ou um next válido. Compare com o exemplo.

Dúvidas frequentes

Artigos relacionados

• Centrais de ajuda
• Opções de contato
• Sugestões e dados de busca
• Central de ajuda e documentação