Existe um tipo de falha que nenhum dashboard detecta. Um usuário está no meio de uma configuração, encontra um campo cujo significado não é óbvio e para. Ele não abre um ticket. Não abre sua central de ajuda. Não faz uma busca. Deixa a aba aberta, promete a si mesmo que vai voltar depois e nunca volta.
A ajuda contextual é a resposta para exatamente esse momento: uma assistência que aparece onde a dúvida acontece, no momento em que ela acontece, sobre aquilo que o usuário está olhando. É o oposto do modelo tradicional, que pede a uma pessoa travada que pare o que está fazendo, descubra que nome dar ao problema, vá para outro lugar e procure por ele.
Este guia explica o que significa ajuda contextual, como ela se diferencia da documentação e do suporte, os três tipos de contexto que devem acioná-la, os sete padrões que os times realmente publicam, como decidir o que merece ajuda e como saber se ela funcionou.
Principais conclusões
- A ajuda contextual é definida pelo lugar, não pelo conteúdo. A mesma frase é documentação numa central de ajuda e ajuda contextual ao lado do campo que ela explica.
- Três coisas criam contexto: onde o usuário está, em que estado está a conta dele e o que ele acabou de fazer. Uma boa ajuda contextual leva os três em conta.
- A melhor ajuda contextual fica invisível até ser necessária. Dicas permanentes viram parte da paisagem; a ajuda sob demanda continua útil.
- Sua fila de tickets é o backlog. Cada pergunta repetida é uma ajuda que faltou, a uma tela de distância de onde era necessária.
- Nunca faça dela a única cópia da informação. A ajuda contextual complementa a documentação; não a substitui.
- Meça o comportamento, não as impressões. Se o usuário concluiu a tarefa é o único resultado que importa.
O que é ajuda contextual? (Significado e definição)
Ajuda contextual, em uma definição
Ajuda contextual é a orientação entregue dentro do produto, no momento da necessidade, limitada ao que o usuário está fazendo agora. Em vez de ficar numa central de ajuda separada esperando ser buscada, ela fica presa a uma tela, um campo, um estado ou uma ação, e aparece quando esse contexto está ativo. A característica que a define é a relevância pela posição: o usuário não precisa descrever o problema para encontrar a resposta, porque a resposta já está ao lado do problema.
Essa definição faz mais trabalho do que parece. A maior parte da "ajuda" em software é genérica: explica um recurso para ninguém em particular, em nenhum momento em particular. A ajuda contextual é indexada pela situação. Uma frase que explica o que é a chave secreta de um webhook vira ajuda contextual no instante em que aparece ao lado do campo dessa chave, na tela em que você está colando uma, e não antes.
Por que o momento importa mais do que o texto. Uma pessoa travada está gastando a atenção na tarefa, não em aprender. Uma ajuda que chega enquanto ela ainda tem o problema na cabeça quase não custa nada para ler. A mesma ajuda, encontrada dez minutos depois numa busca, custa uma troca de contexto, e a essa altura a maioria das pessoas já desistiu e foi fazer outra coisa.
Ajuda contextual vs. documentação vs. suporte
Os três se complementam, não competem entre si, e confundi-los é como os times acabam com uma base de conhecimento linda que ninguém lê. Cada um responde a um tipo diferente de pergunta, a um custo diferente.
| Ajuda contextual | Documentação | Suporte | |
|---|---|---|---|
| Onde fica | Dentro da tela, ao lado do elemento | Uma base de conhecimento ou site de documentação | Uma pessoa, uma fila ou um chat |
| Quem inicia | O produto, ou um clique do usuário | O usuário, buscando | O usuário, perguntando |
| Melhor para | Microdúvidas: o que significa este campo, o que acontece se eu clicar aqui | Profundidade: procedimentos completos, referência, casos extremos | Ambiguidade: problemas específicos da conta, decisões que exigem julgamento |
| Custo para o usuário | Quase zero, sem troca de contexto | Uma busca e uma troca de aba | De minutos a horas de espera |
| Custo para você | Tempo de design e disciplina com o volume | Redação e manutenção | Equipe, por conversa |
| Falha quando | Há ajuda demais, ou ela é a única cópia | Ninguém pensa em procurar | A mesma pergunta chega cem vezes |
A relação saudável entre os três é um funil que corre na direção certa: a ajuda contextual absorve as microperguntas, a documentação absorve as perguntas de procedimento e o suporte cuida do que realmente precisa de uma pessoa. Quando falta ajuda contextual, tudo escorre ladeira abaixo até a fila, que é o padrão que o nosso guia de suporte in-app e deflexão de tickets aborda pelo lado do suporte.
Lugar, estado e momento. A maioria dos produtos só usa o primeiro.
Os três tipos de contexto
"Contextual" costuma ser entendido como "na tela certa", o que é só um terço da ideia. Existem três sinais independentes, e a diferença entre uma ajuda contextual aceitável e uma realmente boa está em quantos deles você usa.
A tela, o painel, o campo. O sinal mais fácil e o que todo produto já tem. Responde: o que é isto na minha frente?
Workspace vazio, trial acabando, nenhuma integração conectada, limite do plano atingido, primeira sessão ou quinquagésima. Responde: o que eu deveria fazer agora, considerando onde estou?
Um erro foi retornado, uma validação falhou, uma pausa longa num campo, a terceira tentativa da mesma ação. Responde: parece que você travou exatamente nisto.
"Você está na tela de importação (lugar), ainda não tem dados (estado) e seu último upload foi recusado (momento)." Essa combinação justifica uma interrupção. O lugar sozinho raramente justifica.
Estado e momento são o que separa a ajuda contextual da decoração. Uma dica que aparece na tela de cobrança para todo mundo, para sempre, não é contextual; é uma placa permanente, e placas permanentes deixam de ser lidas em uma semana. A mesma dica, mostrada só para contas que nunca cadastraram uma forma de pagamento, é ajuda. Nosso guia de gatilhos de onboarding explica a mecânica de disparar pelo estado e pelo comportamento, e não pelo carregamento da página.
Sete padrões de ajuda contextual que funcionam
Quase toda implementação é um destes sete, ordenados mais ou menos do menos ao mais intrusivo. A ordem importa: escolha o padrão mais discreto que consiga transmitir a mensagem.
-
1. Texto de dica inline
Uma linha fixa abaixo de um campo explicando o formato ou a consequência. Sempre visível, ocupa uma linha de espaço vertical e nunca precisa ser descoberta. Use sempre que a resposta for curta e todo mundo precisar dela.
-
2. Ícone de ajuda sob demanda
Um ponto de interrogação ao lado de um rótulo que revela uma explicação mais longa ao clicar ou focar. Mantém a interface limpa e deixa a profundidade disponível. Veja nosso guia de tooltips para as regras de acessibilidade que esse padrão precisa seguir.
-
3. Estados vazios instrutivos
A superfície mais subutilizada do software. Uma tela sem dados é uma tela sem nada disputando a atenção, perfeita para explicar o que deveria estar ali e como colocar isso lá. Nosso guia de estados vazios mostra a anatomia.
-
4. Orientação junto ao erro
Uma mensagem de erro que diz o que deu errado, por quê e o que fazer em seguida, com um link para o artigo relevante em vez de um código de erro. É o momento de ajuda com maior intenção em todo o produto e, em geral, o mais mal atendido.
-
5. Hotspots em recursos novos ou escondidos
Um marcador discreto em algo que vale a pena notar, que se explica quando clicado. Atrair em vez de empurrar. O guia de hotspots mostra a partir de quantos fica demais.
-
6. Um painel de recursos que sabe em que página está
Um widget de ajuda in-app cujos três artigos principais mudam conforme a tela. É a ponte entre a ajuda contextual e a sua central de ajuda: o mesmo conteúdo, exibido pela posição e não pela busca.
-
7. Um walkthrough contextual curto
Dois ou três passos, iniciados no ponto da dúvida, que fazem a tarefa junto com o usuário. Reserve-o para tarefas que realmente têm várias etapas; um walkthrough para um único campo é puro teatro.
Três superfícies, uma tela. A disciplina está em escolher qual delas cada pergunta merece.
O problema do volume. A ajuda contextual tem um modo de falha que a documentação não tem: ela compete com a interface que está ajudando. Cada dica, ícone e marcador consome um pouco da atenção do usuário, precise ele ou não. Uma tela com nove elementos de ajuda na prática não tem nenhum, porque o usuário aprendeu a filtrar toda essa categoria visual. Na dúvida, remova um.
Como decidir o que merece ajuda contextual
O instinto é explicar tudo o que parece complicado. O método melhor é deixar as evidências escolherem, porque o que confunde os usuários quase nunca é o que preocupa o time. Três fontes, em ordem de utilidade:
1. O ticket que se repete
Pegue as últimas centenas de conversas de suporte e agrupe-as pela tela em que o usuário estava. Tudo o que foi perguntado mais do que algumas vezes a partir da mesma tela é um item de ajuda contextual com resposta pronta: você já tem o texto, nas respostas dos seus próprios atendentes.
2. A busca no produto que não retorna nada
Se o seu widget de ajuda tem uma caixa de busca, as consultas sem resultado são uma lista de coisas que os usuários esperavam encontrar. Se a busca da sua central de ajuda é separada, veja em qual artigo as pessoas caem logo depois de visitar uma determinada tela: esse par é um espaço de ajuda contextual esperando para ser preenchido.
3. A etapa em que o funil entorta
Uma etapa com abandono fora do normal, tempo longo na etapa ou muitas tentativas repetidas é um sinal de confusão, mesmo quando ninguém reclama. Nosso guia de funil de onboarding mostra como encontrar essas etapas, e o guia de fricção ensina a separar a fricção útil da acidental.
Ordene o que sair daí por volume × gravidade, pegue os cinco primeiros e ignore o resto até esses cinco estarem no ar. A ajuda contextual é uma das poucas áreas em que um conjunto pequeno e bem posicionado vence a cobertura completa todas as vezes.
Como criar ajuda contextual em seis passos
- Escolha uma dúvida com evidências por trás.
- Escreva a resposta em duas frases, com as palavras do usuário.
- Escolha o padrão mais discreto que consiga transmiti-la.
- Limite o gatilho a lugar, estado e momento, não só à URL.
- Ofereça uma saída e um caminho para se aprofundar.
- Acompanhe o comportamento que ela deveria mudar e então mantenha ou remova.
1. Comece por uma dúvida, não por uma auditoria de conteúdo
Pegue um único item da lista ordenada. Resista à vontade de projetar um "sistema de ajuda": sistemas são projetados e nunca publicados, enquanto uma dica num campo vai ao ar esta semana e começa a dar retorno imediatamente.
2. Escreva a resposta antes de escolher o padrão
Duas frases: o que é isto e o que fazer. Se precisar de cinco frases, o problema provavelmente está na interface e não na explicação, e um texto de ajuda está prestes a virar um curativo permanente sobre um bug de design. Nosso guia de microcopy de UX trata do tom.
3. Escolha o padrão mais discreto que sirva
Curto e universal → dica inline. Mais longo e ocasional → ícone de ajuda. A tela está vazia → estado vazio. Vem depois de uma falha → junto ao erro. Várias etapas → walkthrough curto. Só suba de nível quando a opção mais discreta realmente não der conta da mensagem.
4. Limite o gatilho do jeito certo
Some estado e momento à condição de página: mostre só para contas que ainda não fizeram aquilo, ou só depois que a ação falhou uma vez. Qualquer coisa mostrada a todos para sempre será ignorada por todos em duas semanas, que é o destino comum da ajuda em forma de banner permanente.
5. Ofereça uma saída e um caminho para se aprofundar
Tudo o que aparece sozinho precisa poder ser fechado, e o fechamento deve ficar registrado. Tudo o que resume precisa ter link para o artigo completo, porque a versão de duas frases vai estar errada para alguém. A ajuda contextual nunca deve ser o único lugar onde uma informação existe; mantenha a versão oficial nos seus guias do usuário e deixe o texto dentro do produto apontar para ela.
6. Meça o comportamento e então mantenha ou remova
Defina a condição de sucesso antes de publicar: menos tickets vindos daquela tela, mais conclusões daquela etapa, menos tentativas repetidas daquela ação. Se nada disso mudar depois de um período justo, a ajuda não era o problema; remova-a em vez de deixá-la fazendo barulho para sempre.
Como medir a ajuda contextual com honestidade
As métricas tentadoras são impressões e cliques, e as duas dizem quase nada: uma dica que todo mundo vê e ninguém precisa vai muito bem em impressões. As três que significam algo são mais difíceis de manipular.
A proporção de usuários que concluíram a ação naquela tela aumentou depois que a ajuda foi publicada? Esse é o objetivo de tudo, e dá para medir tela a tela.
Marque as conversas pela tela de origem e acompanhe esse recorte específico. Um número global de deflexão esconde o efeito de uma única boa dica.
Dispensas rápidas e visualizações repetidas da mesma dica significam a mesma coisa: ela não está respondendo à pergunta que as pessoas realmente têm.
Ajuda contextual: o que fazer e o que evitar
✅ Faça
- Deixe a fila de tickets escolher o que explicar
- Acione pelo estado e pelo comportamento, não só pela URL
- Limite a resposta a duas frases e coloque um link para se aprofundar
- Use o estado vazio; é espaço livre
- Coloque a melhor ajuda ao lado dos erros, onde a intenção é maior
- Permita fechar tudo, e faça o fechamento ficar registrado
- Remova as dicas que não mudaram o comportamento
❌ Não faça
- Colocar nove elementos de ajuda numa só tela
- Fazer de um tooltip a única cópia de uma regra ou formato
- Mostrar a mesma dica a todo mundo para sempre
- Usar um walkthrough de sete passos para um problema de um campo
- Responder com um código de erro em vez de um próximo passo
- Publicar ajuda para mascarar uma interface confusa
- Reportar impressões e chamar isso de impacto
Como criar ajuda contextual sem tempo de engenharia
A ajuda contextual costuma ficar atrás do produto porque cada item, isoladamente, é pequeno demais para justificar um ticket. Uma dica de uma linha num campo não vale uma vaga na sprint, então ela espera, e a mesma pergunta continua chegando na fila por mais um trimestre.
O Kompassify existe para quebrar esse ciclo. Tooltips, hotspots, walkthroughs curtos, checklists e anúncios são criados visualmente e publicados no produto em produção sem um release, e cada um pode ser direcionado a um segmento (contas sem dados, usuários na primeira semana, pessoas que acabaram de chegar a um determinado estado), para chegar a quem precisa e não a todo mundo. Como publicar leva minutos, o fluxo natural passa a ser o certo: publique a dica, observe a tela, remova se ela não fez diferença. O Kompassify é grátis até 100 usuários ativos mensais, os planos começam em US$ 129/mês, e ele está em conformidade com o GDPR e hospedado na UE.
Responda à pergunta onde ela é feita
Adicione tooltips, hotspots, walkthroughs e checklists ao seu produto sem abrir um ticket para a engenharia e direcione-os por tela, segmento e comportamento. Grátis até 100 usuários ativos mensais, planos a partir de US$ 129/mês, em conformidade com o GDPR e hospedado na UE.
Comece grátis →A versão em um parágrafo
Ajuda contextual é a orientação colocada onde a dúvida acontece, e não arquivada onde pode ser buscada. Ela é acionada por três coisas (a tela em que o usuário está, o estado da conta dele e o que ele acabou de fazer) e entregue por dicas inline, ícones de ajuda sob demanda, estados vazios instrutivos, orientação junto ao erro, hotspots, um painel de recursos sensível à tela ou um walkthrough curto, mais ou menos nessa ordem de intrusão. Deixe a fila de tickets escolher o que explicar, limite a resposta a duas frases com um link para se aprofundar, acione de forma precisa e avalie pelo número de pessoas que concluíram a tarefa, não pelo número de pessoas que a viram.
Perguntas frequentes
O que é ajuda contextual?
Ajuda contextual é a orientação entregue dentro do produto, no momento da necessidade, limitada ao que o usuário está fazendo agora. Em vez de ficar numa central de ajuda separada esperando ser buscada, ela fica presa a uma tela, um campo, um estado ou uma ação, e aparece quando esse contexto está ativo. A característica que a define é a relevância pela posição: o usuário nunca precisa descrever o problema para encontrar a resposta, porque a resposta já está ao lado do problema. A mesma frase pode ser documentação numa base de conhecimento e ajuda contextual ao lado do campo que ela explica; o que faz a diferença é onde ela está.
Qual é a diferença entre ajuda contextual e documentação?
A documentação é abrangente, fica num lugar próprio e é encontrada pela busca. A ajuda contextual é pontual, fica dentro da interface e é encontrada porque já está ali. A documentação é melhor para profundidade (procedimentos completos, material de referência, casos extremos), enquanto a ajuda contextual é melhor para microdúvidas, como o que um campo significa ou o que acontece se você clicar em algo. As duas trabalham juntas: a ajuda contextual absorve as perguntas pequenas e leva para a documentação quem precisa da versão longa. A ajuda contextual nunca deve ser o único lugar onde uma informação existe.
Quais são exemplos de ajuda contextual?
Sete padrões cobrem quase todas as implementações reais. Texto de dica inline abaixo de um campo, explicando o formato. Um ícone de ajuda sob demanda ao lado de um rótulo, que revela uma explicação mais longa. Um estado vazio instrutivo, que diz o que deveria estar na tela e como colocar isso lá. Orientação junto ao erro, que explica o que deu errado e o que fazer em seguida. Um hotspot que sinaliza um recurso novo ou escondido. Um painel de recursos in-app cujos artigos sugeridos mudam conforme a tela. E um walkthrough curto, de dois ou três passos, iniciado no ponto da dúvida. Eles estão listados mais ou menos do mais discreto ao mais intrusivo, e o instinto certo é usar o mais discreto que consiga transmitir a mensagem.
Quando a ajuda contextual deve ser acionada?
Três sinais devem decidir, e a maioria dos produtos só usa o primeiro. O lugar é a tela, o painel ou o campo em que o usuário está. O estado é a condição da conta: workspace vazio, nenhuma integração conectada, trial acabando, limite do plano atingido. O momento é o que acabou de acontecer: uma validação que falhou, um erro retornado, uma pausa longa, a terceira tentativa da mesma ação. Uma ajuda limitada apenas ao lugar tende a virar decoração permanente que todo mundo passa a ignorar em duas semanas. Uma ajuda limitada aos três merece a interrupção, porque aparece exatamente quando o usuário está na situação que ela descreve.
Como decidir o que explicar com ajuda contextual?
Deixe as evidências escolherem, porque o que confunde os usuários quase nunca é o que preocupa o time. Agrupe as últimas centenas de conversas de suporte pela tela em que o usuário estava: tudo o que é perguntado várias vezes a partir da mesma tela é um item de ajuda contextual cujo texto seus atendentes já escreveram. Depois, olhe as buscas sem resultado no seu widget de ajuda e as etapas do funil com abandono fora do normal, tempo longo na etapa ou tentativas repetidas. Ordene o resultado por volume vezes gravidade, publique os cinco primeiros e ignore o resto até esses cinco estarem no ar.
Pode haver ajuda contextual demais?
Sim, e essa é a forma mais comum de dar errado. A ajuda contextual compete com a interface que ela está ajudando: cada dica, ícone e marcador consome um pouco da atenção do usuário, precise ele ou não. Uma tela com nove elementos de ajuda na prática não tem nenhum, porque as pessoas aprendem a filtrar toda essa categoria visual. Pior: às vezes a ajuda é publicada para mascarar um design confuso, o que torna o problema de fundo permanente. Se uma explicação precisa de cinco frases, normalmente é a interface que precisa mudar.
Como medir a ajuda contextual?
Não por impressões nem cliques: uma dica que todo mundo vê e ninguém precisa vai muito bem nas duas métricas. Meça três coisas. A métrica principal é a conclusão da tarefa naquela tela específica: a proporção de usuários que terminam a ação aumentou depois que a ajuda foi publicada? A métrica secundária são os tickets ligados àquela tela, já que um número global de deflexão esconde o efeito de uma única boa dica. A métrica de proteção é a velocidade de dispensa e as visualizações repetidas, porque ambas indicam que a ajuda não está respondendo à pergunta que as pessoas realmente têm.
Ajuda contextual é a mesma coisa que onboarding?
Elas se sobrepõem, mas não são a mesma coisa. O onboarding é um programa com começo e fim, voltado a levar um novo usuário ao primeiro resultado relevante; a ajuda contextual é uma propriedade permanente da interface que atende usuários em todas as fases, inclusive quem é cliente há três anos e acabou de abrir uma tela que nunca usa. Na prática, os mesmos padrões, e muitas vezes as mesmas ferramentas, servem aos dois, e os melhores sistemas de ajuda contextual nascem do trabalho de onboarding; a diferença é que o onboarding termina e a ajuda contextual não.