Escrever um artigo de base de conhecimento e escrever um bom artigo de base de conhecimento são coisas muito diferentes. A maior parte do conteúdo de ajuda é tecnicamente precisa, mas praticamente inutilizável — longa demais, soterrada sob contexto que os clientes não precisam, escrita na voz passiva de quem está se protegendo juridicamente. Os clientes leem a primeira frase, não encontram a resposta imediatamente e abrem um ticket.
Este guia é sobre escrever artigos que funcionam: claros, específicos e estruturados de forma que leve os clientes à resposta antes de desistirem.
Comece com a Pergunta Certa
Cada artigo deve ser construído em torno de uma pergunta ou tarefa específica. Antes de escrever uma única frase, declare essa pergunta claramente — mesmo que ela nunca apareça literalmente no artigo.
"Como um cliente redefine sua senha se tiver a autenticação de dois fatores ativada e não conseguir mais acessar seu aplicativo autenticador?"
Essa pergunta é diferente de "Como redefinir uma senha" — ela é mais específica e mais restrita. Um artigo separado e específico para esse caso de borda servirá melhor aos clientes do que um único e abrangente artigo "Senha e Segurança" que tenta cobrir tudo.
Na dúvida, restrinja o escopo. Você sempre pode criar links entre artigos. Não é fácil tornar um artigo longo e sem foco mais curto sem reescrevê-lo.
Use Títulos no Formato de Pergunta
Títulos escritos como perguntas correspondem à forma como os clientes pesquisam. Eles também estabelecem uma expectativa clara: o visitante sabe exatamente o que o artigo vai responder antes de clicar.
Menos eficaz:
- Redefinição de Senha
- Visão Geral do Faturamento
- Autenticação de Dois Fatores
Mais eficaz:
- Como redefinir minha senha?
- Como funciona o faturamento?
- Como ativar a autenticação de dois fatores?
Para perguntas com um sintoma conhecido, o próprio sintoma é um excelente título:
- Por que não estou recebendo o e-mail de verificação?
- Por que meu pagamento está sendo recusado?
- Por que não consigo ver a atividade dos membros da minha equipe?
Esses títulos correspondem exatamente ao que um cliente frustrado digita em um mecanismo de busca.
Responda a Pergunta no Primeiro Parágrafo
O primeiro parágrafo de um artigo de base de conhecimento não é o lugar para contexto, histórico ou ressalvas. É o lugar para a resposta — ou, no mínimo, uma declaração clara do que o artigo vai explicar e o caminho mais rápido para chegar lá.
Início lento:
A autenticação de dois fatores (2FA) é uma medida de segurança importante que adiciona uma camada adicional de proteção à sua conta, além da sua senha. Neste artigo, vamos orientá-lo pelo processo de ativação e uso do 2FA em sua conta.
Início rápido:
Para ativar a autenticação de dois fatores, vá para Configurações → Segurança e clique em Ativar 2FA. Escaneie o QR code com seu aplicativo autenticador (Google Authenticator, Authy ou qualquer aplicativo TOTP) e insira o código de 6 dígitos para confirmar.
A segunda versão responde à pergunta em duas frases. Tudo que vem a seguir — códigos de recuperação, solução de problemas, desativação do 2FA — vem depois que a resposta principal está estabelecida.
Escreva Etapas como Etapas Numeradas
Qualquer processo com mais de duas ações deve usar uma lista numerada, não prosa. As etapas numeradas são:
- Mais fáceis de seguir sem perder o fio
- Mais fáceis de escanear para encontrar onde você parou
- Menos sujeitas a interpretações equivocadas (a sequência é explícita)
Versão em prosa:
Para alterar seu endereço de e-mail, você precisará ir às configurações do seu perfil clicando no seu avatar no canto superior direito, depois selecionando Perfil. A partir daí, role até a seção de E-mail e clique em Editar. Insira seu novo endereço de e-mail e clique em Salvar. Você receberá um e-mail de confirmação no novo endereço.
Formato de etapas:
- Clique no seu avatar no canto superior direito e selecione Perfil
- Role até a seção E-mail e clique em Editar
- Insira seu novo endereço de e-mail
- Clique em Salvar
- Verifique seu novo endereço de e-mail para encontrar um link de confirmação e clique nele
A versão numerada é mais rápida de ler e mais difícil de seguir errado.
Coloque em Negrito os Elementos de Interface e as Ações
Ao se referir a elementos da interface — botões, itens de menu, nomes de campos, nomes de páginas — coloque-os em negrito. Esse sinal visual ajuda os clientes a escanear rapidamente para encontrar o elemento específico que precisam clicar ou procurar.
Clique em Salvar alterações para confirmar sua atualização.
Navegue até Configurações → Equipe → Convidar membro.
Não coloque frases inteiras em negrito ou faça ênfases aleatórias. Reserve o negrito para: rótulos de botões, itens de menu, nomes de campos e atalhos de teclado.
Use Capturas de Tela Estrategicamente — Não Decorativamente
As capturas de tela são valiosas quando o elemento de interface sendo descrito é difícil de encontrar ou quando o contexto visual ajuda. Não são valiosas quando inseridas automaticamente para fazer um artigo "parecer completo".
Quando usar uma captura de tela:
- O elemento de interface está em um local não óbvio
- Múltiplos elementos parecem semelhantes e diferenciá-los visualmente ajuda
- O resultado de uma ação (uma mensagem de confirmação, um estado alterado) é mais fácil de mostrar do que descrever
Quando pular a captura de tela:
- A etapa é "clique em Salvar" — nenhuma captura de tela é necessária
- A interface muda frequentemente e você não pode se comprometer a manter as capturas de tela atualizadas
Quando usar capturas de tela: marque o elemento relevante com uma seta, destaque ou numeração. Uma captura de tela de página inteira onde o visitante tem que encontrar o elemento relevante por conta própria não é melhor do que uma descrição em texto.
Escreva para Escaneamento, Não para Leitura
Os clientes não leem artigos de base de conhecimento — eles os escaneiam. Eles olham para títulos, texto em negrito e listas numeradas. Eles param quando encontram a seção relevante.
Escreva de acordo:
- Use títulos H2 e H3 liberalmente para dividir o artigo em seções
- Mantenha os parágrafos curtos — máximo de três a quatro frases
- Use marcadores para listas de itens ou opções
- Não enterre informações críticas no meio de um parágrafo longo
Cada título de seção deve descrever o que essa seção aborda. "Problemas comuns" é menos útil do que "O que fazer se você não receber o e-mail de confirmação".
Antecipe e Aborde Casos de Borda
Os melhores artigos de base de conhecimento respondem não apenas à pergunta principal, mas também às perguntas de acompanhamento que os clientes têm quando o processo padrão não funciona.
Após as etapas principais, adicione uma seção para:
- "E se [etapa X] não funcionar?"
- "Concluí essas etapas, mas [resultado esperado] não aconteceu"
- "Este processo parece diferente na minha tela"
Esses casos de borda representam as perguntas que se tornam tickets quando o artigo principal não os aborda. Adicionar uma breve seção de solução de problemas no final dos seus artigos procedurais pode aumentar significativamente sua taxa de autorressolução.
Adapte o Nível de Leitura ao Seu Público
A maioria dos artigos de base de conhecimento voltados para clientes deve ser escrita em um nível de leitura acessível a um público não técnico. Evite:
- Jargão específico do seu produto ou setor que um novo cliente não reconheceria
- Siglas sem explicação no primeiro uso
- Linguagem excessivamente formal ou jurídica
O teste: um cliente que se cadastrou ontem conseguiria entender este artigo sem contexto adicional? Se não, adicione o contexto ou simplifique a linguagem.
Artigos internos — escritos para agentes, não para clientes — podem usar linguagem mais técnica e presumir mais conhecimento do produto. Mantenha-os claramente separados dos artigos voltados ao público.
Termine com o Que Fazer a Seguir
Cada artigo deve terminar com:
- Um próximo passo natural: "Agora que o 2FA está ativado, você pode querer [baixar seus códigos de recuperação]."
- Um caminho de escalada: "Se ainda estiver tendo problemas, [entre em contato com nossa equipe de suporte] ou [inicie um chat ao vivo]."
Não deixe o visitante parado no final do artigo sem uma direção óbvia. Um artigo que termina abruptamente na última etapa é uma oportunidade perdida de aprofundar o engajamento com seu produto ou encaminhar um cliente sem resolução para a solução.
Como o Nura24 Apoia a Qualidade dos Artigos
O módulo de base de conhecimento do Nura24 inclui um editor de texto rico TipTap com suporte a listas numeradas, títulos, formatação em negrito, upload de imagens e linkagem interna de artigos. O feedback do artigo (útil / não útil) é coletado na página pública, e o recurso de análise de lacunas por IA sinaliza perguntas feitas no chat ao vivo e em tickets que nenhum artigo responde atualmente — apontando diretamente para onde novos conteúdos são mais necessários. Os artigos podem ser publicados publicamente ou mantidos internamente (visíveis apenas para agentes), suportando tanto o gerenciamento de conhecimento voltado para clientes quanto o interno no mesmo workspace.