A voz da VTEX representa os principais elementos da nossa marca e a forma como nos comunicamos. Ela garante que a nossa escrita reflita a personalidade e os padrões de qualidade da VTEX em todos os canais.

Ao se comunicar com nosso público, tenha em mente os seguintes princípios:

✅ Encontre o equilíbrio entre ousadia, credibilidade e otimismo para alcançar o tom certo.
✅ Saiba sempre com quem está falando.
✅ Nosso público é o ponto de partida de toda comunicação. A VTEX orienta a jornada.
✅ Seja simples e direto ao ponto.

Nas seções a seguir, vamos ver em mais detalhes cada um desses princípios.

Ao escrever uma documentação ou criar uma nova interface, guiamos os usuários a realizar uma determinada ação da forma mais eficiente possível.

Nossa comunicação é direcionada aos seguintes públicos:

Tipo de público	Descrição
Iniciante	Novos nas operações de ecommerce e na VTEX, com pouca ou nenhuma experiência anterior. O principal desafio deles é se adaptar à plataforma e ao contexto de ecommerce.
Operacional	Lidam diariamente com tarefas na plataforma de ecommerce, como cadastro de SKUs e gerenciamento de promoções. São familiarizados com o contexto de ecommerce, mas precisam de ajuda para resolver alguns problemas.
Altamente técnico	Esses profissionais criam ou integram soluções técnicas com a VTEX. Atuam na implementação de lojas e no desenvolvimento de aplicativos, utilizando nossas soluções e integrações com sistemas de parceiros por meio das APIs da VTEX. Por isso, buscam documentações técnicas detalhadas, que apresentem as características de todos os nossos recursos e orientem sobre como atender às necessidades de negócio.

A VTEX se baseia em três pilares: ousadia, confiabilidade e otimismo.
Isso significa que nossa escrita demonstra autoridade no assunto e vai direto ao ponto (ousadia), o que nos ajuda a construir confiança com nossos clientes ao orientá-los na configuração, solução de problemas e otimização da plataforma (confiabilidade). Fazemos tudo isso de maneira confiante e amigável, sem gerar preocupações aos usuários (otimismo).

A VTEX não é a protagonista, o público é quem está no centro, e a VTEX é o seu guia. Temos muito a oferecer ao mundo e, muitas vezes, tendemos a nos colocar como protagonistas. Vamos mudar essa abordagem: ao nos apresentarmos como um guia, nos tornamos a ferramenta que os clientes precisam para superar seus desafios.

Seguem dois exemplos práticos:

Comunicação genérica
No Admin, os usuários podem criar landing pages totalmente personalizadas para atender às suas necessidades, como exibir anúncios especiais, destacar promoções ou apresentar algum outro conteúdo interessante para enriquecer a experiência do usuário.

Comunicação personalizada
No Admin, você pode criar landing pages personalizadas, como páginas para anúncios ou promoções específicas.

O público em primeiro lugar
Nosso foco não deve ser em nós. A comunicação é o nosso ponto de partida — é por meio dela que começamos conversas e construímos conexões. Por isso, entender com quem estamos falando é essencial. Nosso público tem familiaridade com tecnologia, então nossa linguagem precisa refletir isso: ser clara, direta, e estar alinhada aos desafios e necessidades de quem entende do assunto. Mais do que falar, queremos fazer sentido. Trazendo soluções práticas e insights técnicos, entregamos valor de verdade e fortalecemos nosso relacionamento com quem importa.

Seguem dois exemplos práticos:

Comunicação genérica
Esse recurso permite que os merchants exibam os produtos mais relevantes para os clientes e adicionem ou ocultem produtos pré-selecionados dos resultados de pesquisa, oferecendo maior flexibilidade ao personalizar a experiência de compra.

Comunicação empoderadora
Essa funcionalidade permite que você exiba os produtos mais relevantes para o cliente e adicione ou oculte produtos pré-selecionados nos resultados da pesquisa.

Seja direto. Como oferecemos uma solução complexa, já usamos muitos conceitos e termos técnicos. Por isso, nossos textos precisam ser o mais claros e objetivos possível. Qualquer pessoa que leia nossa comunicação, seja um anúncio, um email ou uma página do site, deve entender facilmente a mensagem e se reconhecer no que estamos dizendo. Evite repetições e ambiguidades. Sempre releia o texto para garantir que o texto esteja claro e sem repetições desnecessárias.

Direto ao ponto ✅	Excesso de informação 🚫
Ocorreu um erro ao salvar a linha. Tente novamente.	Ocorreu um problema ao tentar salvar a linha. Tente novamente para garantir que suas alterações sejam salvas com sucesso.

Resumindo:

✅ Sempre saiba com quem está falando.
✅ Nosso público é o ponto de partida de toda comunicação. A VTEX orienta a jornada.
✅ Mantenha o texto simples e direto ao ponto.
✅ Encontre o equilíbrio entre ousadia, credibilidade e otimismo para alcançar o tom certo.

Não seja nem tão formal nem tão informal

Muito informal ❌	Medida certa ✅	Muito formal ❌
Ops! Aconteceu um erro ao importar os produtos.	Ocorreu um erro ao importar os produtos	Desculpe, houve um erro na importação dos produtos.
Agora, é só preencher seus dados pra gente continuar com o pedido!	Insira suas informações para continuar	O usuário deverá inserir seus dados cadastrais para que possamos prosseguir com o processamento da solicitação.

Queremos ser educados, mas não precisamos usar “por favor” nas instruções. Queremos uma comunicação mais direta.

Correto ✅	Incorreto ❌
No Admin VTEX, acesse Pedidos > Todos os pedidos	No Admin VTEX, por favor acesse Pedidos > Todos os pedidos
Para atualizar contas ou títulos, use um arquivo que você exportou anteriormente.	Para atualizar contas ou títulos, por favor use um arquivo que você exportou anteriormente.