Cada loja tem voz própria. A IA do ShopIA gera a introdução da sua newsletter respeitando o tom, o público e o posicionamento que você configurou no DNA da marca. O resultado é um texto que parece escrito pela sua loja, não por um robô genérico.
A geração de texto via IA é aplicada apenas na introdução da newsletter — o trecho inicial antes da grade de produtos. Os produtos em si vêm do seu catálogo real (nome, foto, preço, link), sem geração textual.
O que é o DNA da marca
O DNA da marca é um conjunto de configurações que orienta a IA quando ela gera conteúdo para sua loja. Inclui:
| Campo | Descrição | Exemplo |
|---|---|---|
| Tom de voz | Como sua loja fala | "Descontraído mas profissional" |
| Público-alvo principal | Para quem você vende | "Mulheres de 25-45 anos, mães, classe B+" |
| Posicionamento | O diferencial da sua marca | "Cosméticos veganos artesanais" |
| Termos preferidos | Palavras que você usa | "amiga", "ritual", "self-care" |
| Termos a evitar | Palavras que não combinam | "promoção agressiva", "urgência exagerada" |
Configure em Configurar > Loja > DNA da marca.
Como o DNA é usado na newsletter
Quando o sistema gera a introdução, o pipeline é:
- Coleta dados da campanha (nome, segmentos, mês, produtos selecionados)
- Carrega o DNA da sua loja
- Monta prompt da IA com instrução: "gere uma introdução de 2 a 4 frases, no tom X, para público Y, posicionando Z"
- IA retorna texto candidato
- Sistema valida (não pode conter
{{não substituído, não pode incluir produto não listado, não pode ter palavras na lista negra) - Texto aprovado é cacheado em
pending_run_data - Mesmo texto é usado no preview, no envio de teste e no envio real (paridade total)
A geração ocorre 3 horas antes do disparo programado, com fallback estático caso a IA esteja indisponível.
Paridade entre preview, teste e envio real
A introdução gerada é a mesma nos três contextos:
- Preview no wizard (passo 3): mostra exatamente o texto que será enviado
- Enviar teste pra mim: chega no seu email com o mesmo texto
- Envio real: chega no inbox do cliente com o mesmo texto
A única diferença entre teste e real é o nome do destinatário no placeholder {{customer_first_name}}:
- No teste:
{{customer_first_name}}vira "Teste" - No real:
{{customer_first_name}}vira o primeiro nome do cliente (extraído decustomers.first_name)
O sistema de placeholder {{customer_first_name}}
A IA é instruída a usar {{customer_first_name}} quando quer chamar o cliente pelo nome. No envio real, o sistema substitui automaticamente por destinatário.
Por exemplo, a IA pode gerar:
"Oi{{customer_first_name}}, junho chegou cheio de novidade na nossa loja. Separei o que mais combina com você:"
No envio real para a Maria, isso vira:
"Oi Maria, junho chegou cheio de novidade na nossa loja. Separei o que mais combina com você:"
Quando o cliente não tem nome cadastrado, o sistema usa fallback genérico ("Oi tudo bem?" ou similar, sem nome).
Por que não usar [Cliente] ou outro símbolo
Decisão técnica documentada em ADR: o sistema utiliza padrão {{customer_first_name}} para evitar colisão com nomes de produto literais. Se um produto chama "Coleira [Cliente] Pet" e o sistema substituísse [Cliente], o nome do produto ficaria corrompido.
A UI do wizard mostra [Cliente] (mais amigável visualmente), mas internamente o sistema converte para {{customer_first_name}} antes de salvar.
Mudando o tom para um envio específico
Você pode sobrescrever o tom apenas para uma newsletter específica:
- No passo 2 do wizard, clique em Personalizar introdução.
- Marque Sobrescrever tom de voz.
- Defina o tom específico para esta campanha (ex: "tom mais sério, comunicado importante").
- Salve.
Essa alteração vale apenas para a campanha em questão. O DNA padrão da loja não é afetado.
Quando a IA falha
Cenários em que a IA pode não gerar texto:
- Provedor indisponível (timeout de 8 segundos) — sistema usa fallback estático
- Texto gerado contém placeholder não resolvido — sistema descarta e usa fallback
- Texto gerado contém termo da lista negra — sistema descarta e tenta novamente (até 2 tentativas)
O fallback estático é uma frase neutra com formato "As novidades de [mês] já estão disponíveis na nossa loja:" — funcional mas não personalizada.
Quando o fallback é usado, a campanha é marcada com badge "introdução genérica" no painel. Você pode editar manualmente antes do disparo se quiser.
Tom por segmento
A IA também ajusta o tom conforme o segmento de destinatários:
- VIP — linguagem mais cuidadosa, exclusiva, próxima
- Leads — linguagem de boas-vindas, sem assumir conhecimento prévio
- Inativos 60d+ — linguagem de "saudades", reconectando
- Compradores — tom intermediário, com contexto de marca já estabelecido
- Todos — tom neutro, acessível
Você não precisa configurar isso — é automático com base nos segmentos marcados.
Boas práticas
- Configure o DNA com cuidado. Quanto mais específico, melhor a IA performa. Use exemplos.
- Teste com diferentes públicos. A mesma campanha pode soar diferente para VIP vs Leads — envie teste para si mesmo simulando ambos.
- Não tente forçar muita coisa na introdução. A IA gera 2 a 4 frases. Mensagem detalhada vai no resto do email, não na intro.
- Revise periodicamente. Se sua marca evoluir, ajuste o DNA. A IA segue o que está cadastrado.