UX Writing Guide - SellSync¶

Versão: 1.0.0 Última atualização: 15 de dezembro de 2025 Domínio: https://sellsync.ai

📋 Índice¶

Voice & Tone
Writing Principles
Grammar & Mechanics
Microcopy Library
Error Messages
Empty States
Success Messages
CTAs (Call-to-Actions)
Forms & Labels
Accessibility

Voice & Tone¶

Brand Voice (Constante)¶

A voz do SellSync é:

1. Amigável - Como um parceiro de negócios, não apenas um fornecedor de software - Usamos "você" (não "o usuário") - Evitamos jargão técnico desnecessário

2. Confiável - Honesto sobre limitações ("Isso pode levar até 5 minutos") - Dados e resultados reais, sem promessas exageradas - Transparente sobre problemas ("Nosso servidor está lento hoje")

3. Empoderador - "Você" está no controle, a IA ajuda - Celebramos vitórias ("Parabéns! Primeira resposta enviada") - Mostramos impacto ("Você economizou 2h hoje")

4. Brasileiro - Linguagem local, não tradução literal do inglês - Exemplos do dia a dia ("frete grátis", "PIX", "Correios") - Evitamos anglicismos desnecessários

Tone (Varia por Contexto)¶

Contexto	Tom	Exemplo
Onboarding	Entusiasmado, encorajador	"Ótimo! Agora vamos conectar seu Mercado Livre"
Sucesso	Celebratório, positivo	"🎉 Primeira resposta enviada! Você economizou 2 minutos."
Erro	Empático, solucionador	"Ops! Algo deu errado. Vamos tentar de novo?"
Urgência	Direto, claro	"Sua assinatura vence em 3 dias. Atualize o cartão."
Educacional	Paciente, didático	"Dica: Configure templates para respostas ainda mais rápidas"

Writing Principles¶

1. Clareza sobre Criatividade¶

✅ BOM:

"Conecte sua conta do Mercado Livre para começar"

❌ RUIM:

"Sincronize sua existência digital mercadolivresca para iniciar a jornada"

2. Conciso, mas Completo¶

✅ BOM:

"Trial de 14 dias. Sem cartão de crédito."

❌ RUIM:

"Experimente gratuitamente por quatorze dias corridos sem necessidade de cadastrar dados bancários ou cartão de crédito neste momento inicial"

3. Ativo, não Passivo¶

✅ BOM:

"Você enviou 15 respostas hoje"

❌ RUIM:

"15 respostas foram enviadas"

4. Humano, não Robótico¶

✅ BOM:

"Não encontramos perguntas novas. Volte mais tarde!"

❌ RUIM:

"Nenhum resultado foi retornado pela query de busca no banco de dados"

5. Positivo Frame¶

✅ BOM:

"Upgrade para Pro para desbloquear Analytics"

❌ RUIM:

"Você não pode acessar Analytics no Plano Basic"

Grammar & Mechanics¶

Capitalização¶

Títulos (Title Case): - Headers de páginas (H1, H2) - Nomes de features ("SAC IA", "Analytics Avançado") - Botões importantes ("Começar Teste Grátis")

Sentence case: - Corpo de texto - Labels de formulário ("Email", "Senha") - Botões secundários ("Cancelar", "Voltar")

Exemplos:

✅ "Configure Seu Tom de Voz" (H2)
✅ "Nome completo" (label)
✅ "Começar Teste Grátis" (CTA principal)
✅ "Salvar alterações" (botão secundário)

Pontuação¶

Pontos Finais: - ❌ Não use em headers, labels, botões - ✅ Use em parágrafos, descrições longas

Vírgulas: - Use em listas (Oxford comma opcional, mas seja consistente) - "Conecte Mercado Livre, Shopee, e Shopify" (com Oxford) - "Conecte Mercado Livre, Shopee e Shopify" (sem Oxford)

Exclamações: - Use com moderação (apenas em sucessos) - ✅ "Parabéns! Primeira resposta enviada!" - ❌ "Configure sua conta!" (não precisa)

Aspas: - Use para citações ou UI elements - "Clique em 'Conectar' para continuar"

Números¶

1-9: Escrever por extenso em texto corrido ("três horas")
10+: Usar numeral ("15 perguntas")
Dados/Métricas: Sempre numeral ("Você tem 5 perguntas abertas")
Dinheiro: R$ 297 (não R$ 297,00 se for valor inteiro)

Abreviações¶

Evitar em geral, exceto: - IA (Inteligência Artificial) - ML (Mercado Livre - apenas em contextos técnicos) - SAC (Serviço de Atendimento ao Cliente) - API, OAuth (em docs técnicos) - NF-e (Nota Fiscal eletrônica)

Sempre escrever por extenso primeira vez:

"Conecte sua conta do Mercado Livre (ML) via OAuth"

Microcopy Library¶

Botões¶

CTAs Primários¶

✅ "Começar Teste Grátis"
✅ "Criar Conta Grátis"
✅ "Conectar Mercado Livre"
✅ "Aprovar e Enviar"
✅ "Salvar Alterações"

❌ "Clique Aqui"
❌ "Enviar"
❌ "OK"

CTAs Secundários¶

✅ "Cancelar"
✅ "Voltar"
✅ "Pular por Enquanto"
✅ "Editar"
✅ "Ver Detalhes"

CTAs Destrutivos¶

✅ "Excluir Conta" (não "Deletar")
✅ "Remover Integração"
✅ "Cancelar Assinatura"

⚠️ Sempre com confirmação:
"Tem certeza? Esta ação não pode ser desfeita."

Links¶

✅ "Saiba mais sobre automações"
✅ "Ver todos os planos"
✅ "Ler documentação"

❌ "Clique aqui para ver" (não diz o que é)

Placeholders (Inputs)¶

Email: "seu@email.com"
Senha: "Mínimo 8 caracteres"
Nome: "João Silva"
Empresa: "Minha Loja"
Telefone: "(11) 98765-4321"

❌ "Digite seu email aqui" (redundante)

Tooltips¶

✅ "Clique para copiar API Key"
✅ "Taxa de resposta: % de perguntas respondidas em 24h"
✅ "Disponível no Plano Pro"

Regra: Máximo 1 frase, sem ponto final

Badges¶

Status:
✅ "Ativo"
✅ "Pausado"
✅ "Pendente"
✅ "Conectado"
✅ "Falhou"

Features:
✅ "Novo"
✅ "Beta"
✅ "Em Breve"
✅ "Recomendado"

Error Messages¶

Estrutura¶

Formato: 1. O que aconteceu (problema) 2. Por que aconteceu (causa - opcional) 3. Como resolver (ação)

Exemplos¶

Erro de Validação¶

❌ "Campo obrigatório" (muito genérico)

✅ "Email é obrigatório"
✅ "Senha deve ter no mínimo 8 caracteres"
✅ "CPF inválido. Verifique o formato (XXX.XXX.XXX-XX)"

Erro de Conexão¶

❌ "Erro 500" (muito técnico)

✅ "Não conseguimos conectar ao Mercado Livre. Tente novamente em alguns minutos."
✅ "Conexão perdida. Verifique sua internet e recarregue a página."

Erro de Permissão¶

❌ "403 Forbidden"

✅ "Você não tem permissão para acessar esta página. Entre em contato com o admin da conta."
✅ "Analytics é exclusivo do Plano Pro. Faça upgrade para desbloquear."

Erro de Pagamento¶

❌ "Pagamento falhou"

✅ "Cartão recusado. Verifique os dados ou use outro cartão."
✅ "Pagamento não processado. Atualize seu método de pagamento em Configurações."

Tom em Erros¶

Empático, não acusatório: - ✅ "Ops! Algo deu errado." - ❌ "Você cometeu um erro."

Solucionador, não apenas informativo: - ✅ "Não conseguimos salvar. Tente novamente ou contate o suporte." - ❌ "Erro ao salvar."

Empty States¶

Estrutura¶

Ilustração (opcional)
Título (o que está vazio)
Descrição (por que está vazio + próximo passo)
CTA (ação principal)

Exemplos¶

Dashboard Vazio (Novo Usuário)¶

Título: Nenhuma pergunta ainda

Descrição: Conecte sua conta do Mercado Livre para começar a receber perguntas.

CTA: "Conectar Mercado Livre"

Lista de Automações Vazia¶

Título: Nenhuma automação criada

Descrição: Automações economizam tempo executando tarefas repetitivas automaticamente. Que tal pausar produtos sem estoque?

CTA: "Criar Primeira Automação"
Link secundário: "Ver exemplos"

Filtro sem Resultados¶

Título: Nenhuma pergunta encontrada

Descrição: Nenhuma pergunta corresponde aos filtros selecionados. Tente ajustar os critérios.

CTA: "Limpar Filtros"

Success Messages¶

Exemplos¶

Ação Concluída¶

✅ "Alterações salvas com sucesso!"
✅ "Resposta enviada!"
✅ "Integração conectada!"
✅ "Automação criada!"

Milestone Alcançado¶

✅ "🎉 Primeira resposta enviada! Você economizou 2 minutos."
✅ "🏆 100 perguntas respondidas! Você está arrasando."
✅ "✨ Upgrade concluído! Bem-vindo ao Plano Pro."

Email/Notificação Enviada¶

✅ "Email enviado para seu@email.com. Verifique sua caixa de entrada."
✅ "Link de redefinição enviado. Válido por 1 hora."

Tom em Sucessos¶

Celebratório (mas não exagerado)
Mostrar impacto quando possível ("Você economizou X")
Emoji opcional (apenas em milestones)

CTAs (Call-to-Actions)¶

Regras de Ouro¶

Comece com Verbo de Ação
✅ "Começar Teste Grátis"
❌ "Teste Grátis"
Seja Específico
✅ "Conectar Mercado Livre"
❌ "Conectar"
Remova Fricção
✅ "Criar Conta Grátis" (enfatiza gratuito)
❌ "Registrar-se"
Use Primeira Pessoa quando Apropriado
✅ "Começar Meu Teste" (landing page)
✅ "Salvar Alterações" (dashboard)

CTAs por Contexto¶

Contexto	CTA	Alternativa
Landing page	"Começar Teste Grátis"	"Criar Conta Grátis"
Signup	"Criar Conta"	"Cadastrar"
Login	"Entrar"	"Fazer Login"
Integração	"Conectar Mercado Livre"	"Autorizar Acesso"
Resposta IA	"Aprovar e Enviar"	"Enviar Resposta"
Upgrade	"Fazer Upgrade para Pro"	"Ver Planos"
Cancelamento	"Cancelar Assinatura"	"Desativar Conta"

Forms & Labels¶

Labels¶

Regras: - Curtos (1-3 palavras) - Sentence case - Sem dois pontos (:) no final - Sem asterisco (*) para obrigatório (usar texto "obrigatório")

✅ Nome completo
✅ Email
✅ Senha

❌ Nome Completo:
❌ Email*

Helper Text¶

Campo: Email
Helper: "Usaremos para login e notificações"

Campo: Senha
Helper: "Mínimo 8 caracteres, inclua números e letras"

Campo: Tom de voz
Helper: "Como a IA deve responder? Você pode mudar depois."

Required Fields¶

Opção 1: Marcar obrigatórios

Email (obrigatório)
Telefone (opcional)

Opção 2: Marcar opcionais (preferido se maioria é obrigatório)

Email
Telefone (opcional)

Accessibility¶

Alt Text (Imagens)¶

Regras: - Descrever conteúdo, não "imagem de..." - Máximo 125 caracteres - Se decorativa, usar alt=""

✅ "Dashboard mostrando 15 perguntas abertas"
❌ "Imagem de um dashboard"

✅ alt="" (logo decorativa no footer)

Link Text¶

Descritivo (para screen readers):

❌ "Clique aqui para ver planos"
✅ "Ver todos os planos"

❌ "Leia mais"
✅ "Leia mais sobre automações"

Headings (Hierarquia)¶

H1: Apenas 1 por página (título principal)
H2: Seções principais
H3: Subsections
Não pule níveis (H1 → H3 ❌)

Checklist de Review¶

Antes de publicar copy, verifique:

[ ] Tom está amigável e empoderador?
[ ] Sem jargão técnico desnecessário?
[ ] CTAs começam com verbo de ação?
[ ] Erros explicam como resolver?
[ ] Números formatados consistentemente?
[ ] Capitalização consistente (Title Case vs Sentence case)?
[ ] Sem pontos finais em botões/labels?
[ ] Alt text em imagens?
[ ] Link text é descritivo?
[ ] Testado com screen reader? (opcional mas recomendado)

Examples Bank¶

Onboarding Flow¶

Tela 1 (Welcome):
H1: "Bem-vindo ao SellSync!"
Subtitle: "Vamos configurar tudo em 3 passos rápidos"
CTA: "Começar"

Tela 2 (Connect ML):
H2: "Conecte seu Mercado Livre"
Body: "Para gerar respostas inteligentes, precisamos acessar suas perguntas e produtos."
CTA: "Conectar Mercado Livre"
Link: "Como funciona a integração?"

Tela 3 (Configure AI):
H2: "Configure o tom da IA"
Body: "Como você quer que a IA responda seus clientes?"
Options: "Formal", "Amigável", "Técnico"
CTA: "Continuar"

Tela 4 (First Response):
H2: "Teste a IA agora!"
Body: "Encontramos 12 perguntas abertas. Vamos responder a primeira?"
CTA: "Aprovar e Enviar"
Link: "Pular por enquanto"

Error Examples¶

Cenário: Usuário tenta acessar Analytics no Plano Basic

❌ "Acesso negado"
✅ "Analytics é exclusivo do Plano Pro. Faça upgrade para desbloquear insights poderosos sobre suas vendas."
CTA: "Ver Planos"

Voice & Tone Examples¶

Amigável (Onboarding)¶

"Ótimo! Sua conta do Mercado Livre está conectada. Agora vamos configurar a IA para responder do seu jeito."

Confiável (Status/Transparência)¶

"Sincronizando perguntas... Isso pode levar até 2 minutos se você tiver muitos produtos."

Empoderador (Success)¶

"🎉 Você respondeu 50 perguntas esta semana! Isso economizou aproximadamente 2h30min do seu tempo."

Brasileiro (Contextual)¶

❌ "Shipping is free for your region"
✅ "Frete grátis para sua região"

❌ "Payment via PIX"
✅ "Pague com PIX"

Changelog¶

v1.0.0 (15/12/2025)¶

Guia inicial de UX Writing
Tom de voz definido (Amigável, Confiável, Empoderador, Brasileiro)
Biblioteca de microcopy (CTAs, erros, empty states)
Exemplos práticos de onboarding

Recursos¶

Ferramentas: - Hemingway Editor - Simplificar texto - Grammarly - Revisar gramática - WAVE - Testar acessibilidade

Referências: - Mailchimp Content Style Guide - GOV.UK Design System

Última atualização: 15 de dezembro de 2025 Versão: 1.0.0 Mantido por: Product & Design @ SellSync

Dúvidas? product@sellsync.ai