Base de Conhecimento no Portal Nyverra: artigos internos e KB pública

Toda equipe de suporte tem, escondido na cabeça de alguns, o conhecimento que resolve 80% dos chamados. A Base de Conhecimento existe para tirar esse conhecimento da memória individual e colocá-lo à disposição de todos — operadores e clientes.

Neste guia, você entende como funciona a KB do Portal Nyverra ITSM: a diferença entre artigos internos e a base pública, a estrutura de categorias, a busca com filtros (facets) e sugestão de título, o ciclo de feedback e os indicadores de qualidade que mostram o que revisar.

Interface do módulo no Portal Nyverra ITSM.

Por que KB: o efeito no indicador

Uma base bem cuidada produz três efeitos mensuráveis no service desk:

• Resolve no primeiro contato: o técnico responde rápido consultando o procedimento correto.
• Deflection: o cliente resolve sozinho na KB pública e nem abre o chamado.
• Padronização: todos seguem a mesma solução, reduzindo variação e erro.

O contrário também é verdadeiro: uma KB desatualizada afasta os usuários e vira custo. Por isso o módulo não é só “publicar artigo” — é gerir conhecimento.

Duas bases em uma

O Portal separa dois públicos no mesmo sistema de artigos:

Base	Quem acessa	Para quê
KB interna	Equipe autenticada (permissão KB_VIEW)	Procedimentos operacionais, runbooks, contexto técnico
KB pública	Visitante, sem login	Autoatendimento do cliente (passo a passo, “como faço X”)

Um mesmo acervo alimenta os dois: o artigo marcado como público aparece ao visitante; os demais ficam restritos à equipe.

Quem usa

Perfil	Uso
Qualquer usuário autenticado	Consultar a KB interna
Editor / administrador	Criar categorias e artigos em Gerenciar KB
Visitante	Consultar a KB pública (sem login)

Os recursos do módulo

Categorias e artigos

Os artigos se organizam por categorias (ex.: Rede, E-mail, Sistemas, Acessos). Artigos são de texto rico, com imagens, listas, tabelas e trechos de código. Um artigo bem estruturado tem título objetivo, contexto curto e a solução em passos — um assunto por artigo.

Busca com facets e sugestão de título

A busca vai além do texto livre: ela oferece facets (filtros por categoria e tags), ordenação por relevância e sugestão de título enquanto o usuário digita. Isso reduz a frustração do “não achei nada” — grande causa de chamados evitáveis.

Feedback do leitor

Cada artigo pode receber a marcação “útil / não útil” e comentários. O time responde ao feedback pela administração. O retorno do leitor é o termômetro mais honesto da qualidade do artigo.

Analytics e qualidade da busca

O Portal expõe métricas de acesso e uma visão de qualidade da busca (consultas sem resultado, termos problemáticos). Isso permite agir com dado: criar o artigo que falta, corrigir o título que ninguém encontra, ajustar sinônimos.

Publicação e visibilidade

Ao criar/editar, o editor define a visibilidade (interna ou pública). Se o processo da empresa exigir, o artigo pode passar por aprovação antes de ficar visível ao público. Artigo público só aparece ao visitante depois de publicado/aprovado.

Como usar: passo a passo

1. Estruture as categorias antes de escrever em volume (Refaça por domínio: Rede, E-mail, Aplicações, Acessos).
2. Escreva por tarefa: sintoma → causa → solução em passos.
3. Defina a visibilidade e submeta à aprovação quando necessário.
4. Vincule na resposta ao chamado: no trâmite, referencie ou cole o link do artigo.
5. Verifique no WhatsApp: bots podem sugerir artigos da KB durante a conversa, quando configurado.
6. Acompanhe feedback e analytics: revise o que tem nota baixa e o que gera busca sem resultado.

Regras de negócio

Regra	Explicação
Publicação	Artigo público só aparece após publicado/aprovado.
Permissão	Editar exige permissões de criação/edição; ver a lista interna exige KB_VIEW.
Busca	A qualidade depende do índice (Elasticsearch) — o admin reindexa se necessário.
Ciclo de vida	Artigos têm revisão; conhecimento obsoleto deve ser atualizado ou retirado.

Boas práticas

• Título com as palavras do cliente, não com jargão interno.
• Um artigo, uma tarefa. Evite o “super-artigo” que ninguém lê até o fim.
• Revise o que tem nota baixa e o que aparece em buscas sem resultado.
• Feche o ciclo do feedback: responda ao leitor e atualize o artigo.
• Aproveite o que a operação já escreve nos trâmites internos — muito bom conteúdo nasce ali.

Erros comuns

Situação	O que fazer
KB “fantasma”, sem atualização	Defina responsáveis e revisão periódica.
Artigo genérico (“o problema pode ser X ou Y”)	Escreva procedimento; o técnico precisa de passos, não de possibilidades.
Publicar tudo como interno	O que o cliente pode resolver sozinho deve ir para a KB pública.
Ignorar a busca sem resultado	É o mapa do que falta documentar.

Perguntas frequentes

O cliente vê a KB interna?
Não. Só os artigos marcados como públicos aparecem sem login.

Preciso aprovar artigo antes de publicar?
Depende do processo configurado; a aprovação garante qualidade antes da exposição do cliente.

A KB ajuda a reduzir chamados?
Sim — é a principal alavanca de deflection: o cliente resolve sozinho na base pública.

Automatize via API

A KB interna e a pública têm endpoints REST próprios (por exemplo, /api/kb/admin/articles, /api/kb/analytics e, no lado público, /api/public/kb/articles e /api/public/kb/articles/search). Referência em developer.nyverra.com.

Cenários de uso: a KB em ação

1. Autoatendimento que evita o chamado. O cliente busca “redefinir senha”, encontra o artigo público e resolve sozinho. O chamado que não chega é o mais barato de todos. Medir esse deflection é o que justifica o investimento contínuo na base.

2. Primeiro atendimento mais rápido. O técnico abre o artigo vinculado ao tipo de chamado, aplica o procedimento e encerra em minutos — em vez de redescobrir a solução. Artigos vinculados às categorias transformam conhecimento em tempo economizado.

3. Onboarding de equipe. Um novo operador consulta a KB e reduz a dependência dos veteranos. O conhecimento sai da cabeça de poucos e vira capacidade da equipe.

4. Suporte no WhatsApp. Bots podem sugerir artigos da KB durante a conversa, resolvendo sem abrir chamado.

Como medir a saúde da KB

Indicador	O que revela
Artigos por categoria (cobertura)	Onde falta conteúdo
Buscas sem resultado	O que documentar em seguida
% “útil” por artigo	Qualidade percebida
Tempo desde a última revisão	Conhecimento obsoleto
Visualizações de artigos públicos	Deflection em ação

Buscas sem resultado e notas baixas são o mapa do que revisar. Uma base saudável não é a maior — é a mais usada e confiável.

Governança do conhecimento

Conhecimento é ativo, e ativos precisam de dono. Defina responsáveis por domínio (Rede, E-mail, Sistemas), um ciclo de revisão e critérios claros de publicação (interno vs público, aprovação). Sem governança, a KB infla com artigos duplicados e desatualizados — e os usuários deixam de confiar nela, que é o pior cenário possível.

Conclusão

A Base de Conhecimento é o ativo que faz o service desk ficar mais inteligente a cada atendimento. Com categorias consistentes, busca eficaz, feedback tratado e uma KB pública de autoatendimento, o Portal Nyverra ITSM reduz chamados repetidos e profissionaliza a experiência do cliente.