Imagine uma pessoa no celular, no meio de um cadastro, a poucos toques de concluir um pedido. De repente aparece a frase "Erro 4021: operação inválida". Ela não sabe o que fez, não sabe o que corrigir e não sabe se a cobrança foi feita. O botão diz apenas "OK". Ela fecha a tela, e o pedido se perde por causa de um texto, não de uma falha de programação.
Esse é o território do UX writing: a escrita dos textos que vivem dentro de um produto digital, como rótulos de botões, mensagens de erro, avisos, instruções de formulário e telas vazias. Na Trilion, que desenvolve sites e sistemas desde 1995, vemos que a interface bem desenhada perde força quando o texto confunde, e que um bom texto muitas vezes resolve o que nenhum ajuste visual resolveria.
Neste artigo, você vai entender o que é UX writing e o que é microcopy, ver como escrever mensagens de erro que orientam, aprender regras práticas para botões e formulários e montar um processo simples para revisar os textos do seu projeto. Se quiser conversar sobre a interface do seu produto, o briefing em 3 passos está em /desenvolvimento/orcamento.
UX writing: o que é e onde ele aparece
UX writing é a disciplina que planeja e escreve os textos de uma interface para que a pessoa entenda o que fazer, conclua a tarefa e se sinta segura no caminho.
O que é UX writing, em uma frase
O que é UX writing? É escrever o texto como parte do design, e não como enfeite colocado no fim. O texto de um botão, de um aviso ou de uma tela vazia faz parte da experiência tanto quanto o layout, a cor e o fluxo de navegação. Por isso ele deve ser pensado junto com o design de UX e a usabilidade do produto, desde os primeiros esboços.
O que é microcopy
Microcopy é o nome dado aos textos pequenos da interface: a etiqueta de um campo, a dica abaixo dele, o texto de um botão, a confirmação depois de salvar. São poucas palavras, mas aparecem nos momentos de decisão. Quem escreve microcopy trabalha com economia: cada palavra precisa justificar o espaço que ocupa.
Onde o texto de interface costuma aparecer
Em quase todo ponto de contato. A lista abaixo ajuda a mapear o que existe no seu produto.
- Botões e links: dizem o que acontece ao clicar.
- Formulários: rótulos, exemplos de preenchimento e regras de formato.
- Mensagens de erro: explicam o que falhou e como seguir.
- Telas vazias: orientam o primeiro passo quando ainda não há dados.
- Confirmações e avisos: dão segurança antes e depois de uma ação importante.
- E-mails e notificações do sistema: prolongam a conversa fora da tela.
Faça um teste agora: abra o seu site ou sistema e leia apenas os textos dos botões. Eles contam, sozinhos, o que a pessoa consegue fazer ali?
Princípios de um bom texto de interface
Um bom texto de interface usa as palavras que a pessoa já conhece, diz o que aconteceu, indica o próximo passo e mantém um tom respeitoso do início ao fim.
Fale a língua de quem usa
A segunda heurística de usabilidade do Nielsen Norman Group pede que o sistema use palavras e conceitos que o usuário já conhece, em vez de termos internos da empresa. O texto também deve seguir uma ordem natural e lógica. Na prática, isso significa pesquisar o vocabulário do público antes de batizar menus e botões, porque o que parece óbvio para a equipe nem sempre é óbvio para quem chega.
Clareza antes de criatividade
Um rótulo criativo que exige interpretação custa mais do que ajuda. Prefira o termo direto, com um nome para cada conceito, usado sempre do mesmo jeito. Se a tela diz "carrinho" num lugar e "sacola" em outro, a pessoa pergunta se são coisas diferentes. A consistência reduz esforço e dá confiança.
Voz e tom não são a mesma coisa
A voz é a personalidade da marca e permanece estável. O tom muda conforme o momento: pode ser leve ao dar boas-vindas e deve ser sóbrio ao informar uma falha no pagamento. Humor em mensagens de erro merece cuidado. O Nielsen Norman Group lembra que a graça cansa quando o usuário vê o mesmo aviso várias vezes, e reserva a exceção para falhas raras e totais.
Escreva para ler com pressa
Ninguém lê interface como lê um livro. Frases curtas, verbos no início das ações e a informação mais importante primeiro funcionam melhor. Revise cada texto perguntando se uma pessoa distraída, em movimento e com a tela pequena, entenderia o que fazer em 3 segundos de leitura.

Mensagens de erro que orientam em vez de culpar
Uma boa mensagem de erro descreve o problema com precisão, não culpa a pessoa e mostra como corrigir, preferencialmente ao lado do ponto exato onde a falha aconteceu.
As 3 perguntas que a mensagem precisa responder
A documentação de conteúdo do Atlassian Design indica que uma mensagem de erro informa que um problema já ocorreu, o que ele afeta e o que fazer em seguida. Resumindo em perguntas simples:
- O que aconteceu?
- O que isso significa para a pessoa?
- O que ela pode fazer agora?
Se a equipe não sabe a causa, o mesmo guia recomenda não inventar uma explicação: admita que algo deu errado e ofereça um próximo passo.
Evite palavras que acusam
O Nielsen Norman Group recomenda um tom positivo e sem culpa, evitando termos como "inválido", "ilegal" ou "incorreto". O sistema deve se adaptar, e não transferir a responsabilidade para a pessoa. Em vez de "CPF inválido", escreva "O CPF precisa ter 11 números. Confira se algum dígito ficou faltando". A segunda versão descreve a exigência do campo e indica a correção.
Esconda códigos, mostre caminhos
Códigos de erro servem à equipe técnica, não ao usuário. A heurística 9 do Nielsen Norman Group pede mensagens sem códigos e sem termos técnicos, que indiquem o problema específico e sugiram uma saída. Quando o código for útil para o suporte, ele pode aparecer em letra pequena, depois do texto principal, sem protagonismo.
Mantenha as respostas já digitadas
Entre as diretrizes de eficiência do Nielsen Norman Group está preservar o que a pessoa digitou, mesmo quando há um erro, para que ela edite em vez de recomeçar. Esse é um ponto em que texto e programação andam juntos: de nada adianta a mensagem gentil se o formulário apaga tudo ao falhar. Na Trilion, quem desenha também programa, e esse tipo de detalhe é resolvido na mesma conversa.
Compartilhe com quem cuida do seu site: qual é a pior mensagem de erro que o seu produto exibe hoje?
Botões, rótulos e formulários
Botões devem nomear a ação com um verbo claro, rótulos de campo devem dizer o que digitar, e as dicas devem aparecer antes do erro, não depois dele.
Botões com verbo e resultado
O Atlassian Design orienta usar uma ou duas palavras, com verbo no imperativo que nomeia a ação, como "Salvar" ou "Remover", e evitar rótulos vagos como "OK". O mesmo raciocínio vale para o português. "Enviar pedido" é melhor que "Continuar", e "Excluir conta" é melhor que "Confirmar", porque a pessoa sabe o que vai acontecer antes de tocar.
Rótulos e exemplos nos campos
O rótulo diz o que o campo pede, e o exemplo mostra o formato. Evite usar apenas o texto de dentro do campo como rótulo, porque ele some quando a pessoa começa a digitar. Se o telefone exige DDD, diga isso antes. Orientar antes do erro economiza o erro.
Quando avisar sobre um problema
O Nielsen Norman Group sugere evitar erros prematuros: não marque um campo como problemático só porque a pessoa clicou nele e saiu sem preencher. Em campos propensos a falha, como senhas, uma orientação em tempo real, ao lado do campo, ajuda mais do que uma bronca no final.
Checklist rápido para formulários
- Cada campo tem um rótulo visível e permanente.
- Os formatos esperados aparecem antes de o erro acontecer.
- O erro surge junto ao campo, e não só no topo da página.
- As respostas digitadas são preservadas.
- O botão final descreve a ação concreta.

Telas vazias, confirmações e momentos delicados
Os textos de apoio, como telas vazias, confirmações e avisos de ação irreversível, transformam pontos de dúvida em pontos de segurança.
Telas vazias que ensinam o primeiro passo
Quando o usuário abre um painel sem dados, a tela em branco gera dúvida. Um texto curto que explica o que aparecerá ali e o botão do primeiro passo, como "Cadastrar primeiro cliente", dá direção. A tela vazia é uma das poucas oportunidades de ensinar sem interromper ninguém.
Confirmações que fecham o ciclo
Depois de uma ação, a pessoa quer saber se deu certo. "Pedido enviado. Você receberá a confirmação por e-mail" fecha o ciclo e informa o que vem depois. Uma confirmação vaga deixa a pessoa em dúvida e ela repete a ação, o que cria pedidos duplicados.
Ações que não têm volta
Antes de excluir, cancelar ou enviar algo definitivo, o texto deve dizer o que será perdido e oferecer saída. O guia do Atlassian Design recomenda indicar o que acontece se a pessoa não agir e sugere cuidado com "por favor" e "desculpe": em erros menores, essas palavras podem agravar a percepção do problema, e ficam reservadas para consequências sérias e irreversíveis.
Ajuda no momento certo
A heurística 10 do Nielsen Norman Group diz que o ideal é o sistema dispensar explicações, mas, quando a ajuda é necessária, ela deve ser breve, focada na tarefa e apresentada no contexto. Uma dica ao lado do campo vale mais do que um manual distante.
Como criar um processo de UX writing no projeto
Um processo simples de UX writing envolve mapear os textos, definir um guia de voz, escrever em conjunto com o design e testar com pessoas do público.
Passo a passo para começar
- Inventário: liste todos os textos do produto, tela por tela.
- Glossário: escolha um termo para cada conceito e use sempre o mesmo.
- Guia de voz e tom: defina como o produto fala em situações normais e em falhas.
- Escrita no protótipo: substitua textos de preenchimento por textos verdadeiros logo nos primeiros esboços.
- Teste: peça a pessoas do público que realizem tarefas e observe onde hesitam.
- Revisão contínua: reveja os textos a cada nova funcionalidade.
Escrever junto com o protótipo
Textos de preenchimento em latim escondem problemas. Quando o protótipo e o wireframe já trazem os textos finais, o time percebe se um rótulo é longo demais para a tela, se uma mensagem cabe ao lado do campo e se o fluxo faz sentido lido em voz alta.
Testar o texto com pessoas
Um texto só se prova quando alguém tenta usá-lo. Os métodos de UX research e os testes simples de usabilidade servem também para a escrita. Peça a 5 pessoas do público que cumpram uma tarefa e anote cada pausa e cada pergunta. A dúvida em voz alta indica exatamente onde o texto falhou.
Quem escreve: designer, redator ou programador?
A resposta ideal é uma conversa entre os três. O designer conhece o fluxo, o redator cuida da clareza e o programador sabe o que o sistema consegue informar em cada falha. Na Trilion, o design e o código ficam no mesmo time, e isso encurta o caminho entre identificar uma mensagem ruim e corrigi-la de verdade, como detalhamos em handoff entre design e desenvolvimento sem ruído.
Acessibilidade e consistência no texto
Texto de interface acessível não depende só de cor e de ícones, usa linguagem simples e mantém o mesmo padrão em todas as telas.
Não dependa só da cor
O guia de mensagens de erro do Google para desenvolvedores lembra que muita gente tem deficiência de visão de cores e orienta combinar a cor com outro sinal, como texto em negrito ou um marcador. O Nielsen Norman Group diz o mesmo: nunca use apenas cor ou animação para sinalizar um erro. Um ícone e uma frase clara garantem que a mensagem chegue a todos. O tema aparece com mais detalhe em nosso artigo sobre WCAG e acessibilidade digital.
Links e botões que fazem sentido sozinhos
Quem usa leitor de tela costuma percorrer uma lista de links fora de contexto. Se todos dizem "clique aqui", a lista é inútil. Prefira "Ver condições de entrega" ou "Baixar o guia". O mesmo vale para botões: o texto deve funcionar mesmo sem a imagem ao redor.
Mantenha um padrão entre telas e canais
O padrão de escrita precisa se repetir: mesmas palavras para as mesmas ações, mesma estrutura de mensagem, mesma pontuação. Quando existe um design system, o guia de textos entra nele, ao lado de cores e componentes. Assim cada nova tela nasce com o tom certo.
Conclusão
UX writing é a parte do design que se faz com palavras: dizer o que aconteceu, orientar o próximo passo e tratar a pessoa com respeito. Os textos pequenos da interface, os botões, os campos e as mensagens de erro, pesam nos momentos em que alguém decide continuar ou desistir.
Comece pelo inventário, escolha um termo para cada conceito, reescreva as mensagens de erro com as 3 perguntas e teste com pessoas do público. Se você quer revisar a interface do seu site ou sistema com um time em que design e código trabalham juntos, monte o briefing em /desenvolvimento/orcamento ou comece pela página de design UX e usabilidade. A proposta é escrita depois do briefing, e o valor depende do escopo.
Se a interface envolve conexões com outros sistemas, vale também conhecer nossa frente de integração de sistemas, onde as mensagens de falha entre sistemas também precisam ser pensadas.
Sobre este texto
Este artigo foi escrito pela equipe da Trilion a partir da experiência de desenvolver sites e sistemas desde 1995 e da leitura de documentação e publicações especializadas de design de interface. Os fatos atribuídos a terceiros foram conferidos nas páginas originais. Nenhum número de resultado é prometido: o texto descreve método, não garantia.
- Nielsen Norman Group, Error-Message Guidelines: https://www.nngroup.com/articles/error-message-guidelines/ (consulta em 07/11/2026)
- Nielsen Norman Group, 10 Usability Heuristics for User Interface Design: https://www.nngroup.com/articles/ten-usability-heuristics/ (consulta em 07/11/2026)
- Atlassian Design, Error messages: https://atlassian.design/foundations/content/designing-messages/error-messages (consulta em 07/11/2026)
- Google for Developers, Format error messages to enhance readability: https://developers.google.com/tech-writing/error-messages/format-for-readability (consulta em 07/11/2026)

