Tooltips e Textos de Ajuda

Objetivo

Criar tooltips, hints e textos de ajuda contextual para interfaces digitais que orientam o usuário sem interromper o fluxo - explicando funcionalidades, prevenindo erros e reduzindo a necessidade de suporte.

Quando usar

Ao projetar interfaces com funcionalidades não-óbvias
Em configurações, dashboards e painéis administrativos
Para funcionalidades novas que precisam de explicação
Quando o suporte recebe perguntas repetitivas sobre a mesma feature

Como usar

1Copie o prompt abaixo no Claude ou ChatGPT
2Liste as funcionalidades que precisam de textos de ajuda
3Receba tooltips e textos de apoio prontos
4Implemente nos componentes de interface

O Prompt

Você é um especialista em UX writing e microcopy para produtos digitais brasileiros. Sabe que tooltip e texto de ajuda são o suporte silencioso do produto - aparecem no momento certo, removem dúvida e evitam que o usuário abandone ou cometa erro. Tooltip eficaz: 1. APARECE NO MOMENTO DA DÚVIDA - não antes, não depois 2. É CURTO - 1-2 frases no máximo. Se precisar de mais, é documentação, não tooltip 3. RESPONDE "POR QUE ISSO EXISTE?" não só "O que é isso?" 4. NUNCA REPETE o que o label já diz Texto de ajuda inline (abaixo de campos e seções): - Antecipa a dúvida antes de ela virar erro - Usa exemplo concreto ("Ex: joao@empresa.com") - Explica consequência ("Este email vai aparecer no recibo do cliente") CONTEXTO Produto/Plataforma: [o que é] Features que precisam de tooltip/ajuda: [liste as features ou campos] Público: [nível técnico e contexto de uso] Tom: [formal | amigável | técnico | descontraído] ENTREGUE para cada feature/campo: 1. TOOLTIP (1-2 frases - aparece ao passar o mouse ou tocar o ícone ?) 2. TEXTO DE AJUDA INLINE (abaixo do campo - sempre visível) 3. PLACEHOLDER do campo (quando aplicável) 4. MENSAGEM DE VALIDAÇÃO (quando o usuário preenche errado)

Exemplo de uso

Input

Produto: Software de emissão de notas fiscais para autônomos e MEIs Features/campos: CNPJ do tomador de serviço, Código do serviço (ISS), Alíquota de ISS, Retenção na fonte, Descrição do serviço, Email para envio da NF Tom: amigável e simples - usuário não tem formação contábil

Output

TOOLTIPS E TEXTOS DE AJUDA - Software de NF para MEIs 1. CNPJ DO TOMADOR DE SERVIÇO Tooltip (?): "É o CNPJ da empresa que está te contratando. Você encontra no contrato, na proposta ou pedindo para o RH ou financeiro do cliente." Texto de ajuda inline: "Nem sempre obrigatório. Se o cliente for pessoa física (CPF), você não precisa preencher aqui." Placeholder: "00.000.000/0000-00" Mensagem de validação (CNPJ inválido): "Esse CNPJ não confere. Confere se todos os 14 números estão certos - às vezes falta um zero no início." 2. CÓDIGO DO SERVIÇO (ISS) Tooltip (?): "Cada tipo de serviço tem um código na lista do município. O código errado pode causar rejeição da nota. Se não sabe qual é o seu, nossa lista de sugestões por tipo de trabalho pode ajudar." Texto de ajuda inline: "Use o mesmo código que você já usou antes para o mesmo tipo de serviço. [Ver lista de códigos por profissão →]" Placeholder: "Ex: 17.06 - Suporte técnico" Mensagem de validação (código inválido para o município): "Esse código não existe para o município selecionado. Tenta buscar pelo nome do seu serviço na lista." 3. ALÍQUOTA DE ISS Tooltip (?): "A porcentagem de imposto que incide sobre o seu serviço. Depende do município e do tipo de serviço - geralmente fica entre 2% e 5%. Seu contador ou a prefeitura da sua cidade podem confirmar." Texto de ajuda inline: "Não sabe qual é a sua? Procura 'alíquota ISS [nome do município]' no Google ou consulta sua prefeitura. Usar alíquota errada pode gerar multa." Placeholder: "Ex: 2,5%" Mensagem de validação (fora do intervalo permitido): "A alíquota de ISS costuma ficar entre 2% e 5%. Verifique o valor com seu contador ou prefeitura antes de emitir." 4. RETENÇÃO NA FONTE Tooltip (?): "Quando ativado, o imposto é descontado diretamente pelo seu cliente antes de te pagar. Isso depende do contrato ou da exigência da empresa contratante. Em caso de dúvida, confirme com o financeiro do cliente." Texto de ajuda inline: "Só marque se o cliente pediu ou se o contrato prevê retenção. Se você marcar sem precisar, o cliente vai descontar do pagamento indevidamente." Opções: [Sim, reter na fonte] [Não reter] 5. DESCRIÇÃO DO SERVIÇO Tooltip (?): "Descreve o que você fez em linguagem simples. A nota fiscal com descrição clara tem menos chance de ser questionada pelo cliente ou pela prefeitura." Texto de ajuda inline: "Seja específico. Em vez de 'Prestação de serviços', prefira 'Desenvolvimento de site institucional para empresa X - período de 01/03 a 31/03'." Placeholder: "Ex: Consultoria de marketing digital - criação de estratégia de conteúdo para redes sociais, período: março/2025" Mensagem de validação (campo vazio): "A descrição não pode ficar em branco. Uma descrição clara protege você e o cliente." 6. EMAIL PARA ENVIO DA NF Tooltip (?): "Para onde a nota fiscal vai ser enviada. Confirme com o financeiro ou contabilidade do cliente - nem sempre é o email do contato principal." Texto de ajuda inline: "Esse email vai receber a nota em PDF assim que ela for emitida. Você também recebe uma cópia no seu email cadastrado." Placeholder: "financeiro@empresa.com.br" Mensagem de validação (formato inválido): "Esse email não parece certo. Verifica se não falta o '@' ou o '.com'."