Para responsáveis de suporte técnico e de documentação
Base de conhecimento ou diagnóstico guiado: para que serve cada um
A maioria dos fabricantes já publica os manuais online, e os instaladores continuam a telefonar. Porque é que uma biblioteca de documentos corretos não é o mesmo que uma resposta, onde a base de conhecimento é a ferramenta certa e onde um percurso guiado funciona melhor.

A maioria dos fabricantes já colocou os manuais online, muitas vezes num portal bem organizado. Os instaladores continuam a telefonar. Não é porque os documentos estejam errados. Uma base de conhecimento responde à pergunta «onde está escrito?». Um instalador em obra está a fazer outra: «o que faço a seguir?».
Em resumo
- Uma base de conhecimento é uma biblioteca: foi feita para encontrar e ler. O diagnóstico guiado é uma conversa: foi feito para agir, um passo de cada vez.
- Num inquérito da Gartner, apenas 14% dos problemas de serviço foram totalmente resolvidos em self-service, e 36% dos muito simples. Em 43% das tentativas falhadas, os clientes não encontraram conteúdo relevante.
- Use uma base de conhecimento para material de referência. Use um percurso guiado quando a resposta depende do que o instalador vê e a ordem importa.
- Não são alternativas. Os guias são criados a partir dos mesmos documentos, que continuam a ser a fonte de verdade.
- dos problemas de serviço ao cliente foram totalmente resolvidos em self-service
- 14%
- Gartner, agosto de 2024
- das falhas de self-service: os clientes não encontraram conteúdo relevante
- 43%
- Gartner, agosto de 2024
Duas ferramentas para duas perguntas
Imagine um instalador diante de um controlador de porta que mostra um código de avaria. Com uma base de conhecimento, o trabalho de ir do código à solução é dele: pesquisar, escolher um documento, encontrar a página, perceber que variante tem e depois juntar os passos. Com um percurso guiado, a mesma documentação faz esse trabalho por ele, uma pergunta de cada vez.
A mesma avaria, dois caminhos até à solução
Ilustração
Base de conhecimento 6 passos, todos feitos pelo instalador
- PesquisarEscreve «E04» no portal
- EscolherDoze documentos mencionam-no
- AbrirUm manual de 86 páginas num telemóvel
- EncontrarA tabela de avarias na página 61
- DecidirQual das três variantes está instalada?
- AgirPassos na página 61, definições na página 34
Diagnóstico guiado 5 passos, o guia pergunta
- PerguntarEnvia «E04» numa mensagem
- ResponderToca em «Monofásico»
- AgirPasso 1 de 3, para essa variante
- AgirPasso 2, com o esquema
- ConcluídoResolvido, ou encaminhado para uma pessoa
Porque é que documentos corretos continuam a gerar chamadas
O self-service raramente falha por falta de informação. A Gartner inquiriu 5728 clientes em dezembro de 2023 e concluiu que apenas 14% dos problemas de serviço foram totalmente resolvidos em self-service. Mesmo nos problemas que os próprios clientes descreveram como muito simples, o valor foi de 36%. Em 43% das tentativas falhadas, não conseguiram encontrar conteúdo relevante para o seu problema. São clientes de vários setores, não instaladores, mas um instalador com um código de avaria está numa posição mais difícil, não mais fácil.
A maioria das tentativas de self-service acaba noutro lado
Percentagem de problemas totalmente resolvidos em self-service
Mesmo quando se encontra a página certa, raramente é lida na íntegra. A análise de navegação web real de Jakob Nielsen estimou que as pessoas leem no máximo 28% das palavras de uma página média, e mais provavelmente cerca de 20%. Um manual escrito para ser completo é extenso por natureza. Lido aos bocados, num telemóvel, com pouca luz, é fácil não ver a única linha que diz «apenas em modelos trifásicos».
O problema não é faltar a resposta. É o instalador ter de a montar.
Onde a base de conhecimento é a ferramenta certa
Nada disto faz da base de conhecimento um erro. Para material de referência é exatamente o indicado: uma ficha técnica, um certificado, uma lista de peças ou um desenho de montagem são coisas que as pessoas querem encontrar, consultar e guardar. A diferença está em duas coisas: se a resposta depende do que o instalador consegue ver e se a ordem dos passos importa.
Que ferramenta serve cada pergunta
Dois testes: a resposta depende do que o instalador vê, e a ordem importa?
Procedimento
Seguir pela ordem
Uma sequência de colocação em serviço para um produto
Qualquer um; um guia não perde o ponto
Diagnóstico
O que está mal e o que fazer a seguir?
Códigos de avaria, uma porta que para, um sensor que não desbloqueia
Guiado
Referência
Consultar
Dimensões, fichas técnicas, certificados, listas de peças
Base de conhecimento
Seleção
Qual se aplica ao meu caso?
O parâmetro para esta variante e esta utilização
Guiado
Classificadas assim, a maioria das perguntas que chegam à linha técnica de um fabricante fica do lado direito. São as perguntas em torno das quais este site foi construído: configuração de parâmetros, definição de fins de curso, cablagem, bandas de segurança e fotocélulas, colocação em serviço e códigos de avaria.
| Um instalador pergunta | Mais bem servido por |
|---|---|
| Existe declaração de conformidade para este modelo? | Base de conhecimento |
| Quais são as dimensões de montagem? | Base de conhecimento |
| Que parâmetro define o tempo de fecho automático na minha variante? | Guiado |
| Como defino os fins de curso de abertura e de fecho? | Guiado |
| Onde se liga a banda de segurança e como a testo? | Guiado |
| O visor mostra E04. E agora? | Guiado |
Não é uma ideia nova. A documentação aeroespacial trata há muito o diagnóstico de avarias como uma estrutura e não como texto corrido: a especificação S1000D para publicações técnicas tem uma estrutura própria para procedimentos de isolamento de avarias, que alguns sistemas de visualização apresentam como fluxogramas de isolamento de avarias. O que mudou é que essa estrutura pode agora chegar a um instalador através do telemóvel que já tem na mão.

Não é uma coisa ou outra
A forma útil de pensar nas duas é como um único conjunto de documentação usado de duas maneiras. Os manuais, boletins e desenhos ficam na base de conhecimento, onde são mantidos e onde as pessoas os vão ler. Os percursos guiados são criados a partir deles para as perguntas que exigem fazer e não ler, e cada passo pode remeter para a página de onde veio.
Um conjunto de documentos, usado de duas maneiras
Há uma segunda vantagem. Uma base de conhecimento consegue dizer que páginas foram abertas, mas não se o leitor encontrou o que precisava. Um guia sabe onde cada instalador parou, o que escolheu e que perguntas teve de encaminhar para uma pessoa, o que é uma lista precisa dos pontos em que a documentação não é clara.
A Lingo cria percursos guiados a partir dos manuais e boletins do próprio fabricante, e a equipa técnica aprova cada um antes de os instaladores o verem. Leia como a Lingo transforma um manual num guia, ou veja como se aplica a códigos de avaria e à configuração de parâmetros.
Fontes
- Gartner survey finds only 14% of customer service issues are fully resolved in self-serviceGartner, 19 de agosto de 2024. Inquérito a 5728 clientes, dezembro de 2023. Clientes de vários setores.
- How little do users read?Jakob Nielsen, Nielsen Norman Group, 5 de maio de 2008. Análise de dados de navegação de Weinreich, Obendorf, Herder e Mayer, ACM Transactions on the Web, 2008. 28% é um limite máximo.
- S1000D data module typesDocumentação do Adobe FrameMaker, consultado em outubro de 2026. O módulo de dados de avarias e os fluxogramas de isolamento de avarias.
Perguntas que nos fazem
Qual é a diferença entre uma base de conhecimento e o diagnóstico guiado?
Uma base de conhecimento é uma biblioteca: guarda os documentos corretos e permite pesquisá-los e lê-los. O diagnóstico guiado é uma conversa: faz uma pergunta de cada vez sobre o que o instalador consegue ver e dá o passo documentado seguinte para essa resposta. A primeira foi feita para encontrar informação; o segundo, para agir com base nela.
Porque é que os instaladores continuam a telefonar se os manuais estão online?
Porque encontrar a página certa, para a variante certa, num telemóvel, em obra, é mais lento do que telefonar. Num inquérito da Gartner a 5728 clientes, publicado em agosto de 2024, apenas 14% dos problemas de serviço foram totalmente resolvidos em self-service, e em 43% dos casos os clientes não conseguiram encontrar conteúdo relevante para o seu problema.
O diagnóstico guiado substitui a base de conhecimento?
Não. Os guias são criados a partir dos mesmos manuais e boletins, por isso a documentação continua a ser a fonte de verdade. O material de referência, como fichas técnicas, certificados e listas de peças, continua a ficar melhor numa biblioteca que as pessoas possam percorrer e pesquisar.
Que perguntas de suporte se adequam melhor ao diagnóstico guiado?
Perguntas em que a resposta depende do que o instalador está a ver e a ordem dos passos importa: códigos de avaria, colocação em serviço, definição de parâmetros para uma variante específica, cablagem e verificação de dispositivos de segurança.


