OneTrace.pro Central de ajuda

Modelos e editor de e-mails

Um modelo é uma mensagem pronta para um canal: e-mail, mensagem no Telegram, SMS, Web Push, push móvel, mensagem no app, webhook e outros. O mesmo modelo é usado por jornadas, campanhas e pelo envio manual a partir do cartão do perfil. As variáveis inserem no texto o nome do cliente, o valor do pedido e outros dados.

A seção fica no menu Engajamento → Modelos. Todas as funções podem ver os modelos; criar e alterar é permitido para “Gerente” e superiores.

Criação de um modelo

  1. Abra Modelos, clique em Novo modelo no canto superior direito e escolha o canal na lista: nela estão todos os canais ativados no projeto, por exemplo E-mail ou Telegram.
  2. Preencha os campos gerais (tabela abaixo).
  3. Preencha o bloco Conteúdo. Os campos dependem do canal. No e-mail, são Assunto, Pré-cabeçalho (texto exibido ao lado do assunto na lista de e-mails), Editor de e-mail ou HTML, além da Versão em texto simples. Se a versão em texto não for preenchida, ela é gerada a partir do HTML.
  4. Clique em Salvar. A cada salvamento, o número da versão aumenta (“Versão 3”).
Campo O que significa
Nome Visível apenas na interface: nas listas de modelos, jornadas e campanhas
Canal É escolhido na criação e não pode ser alterado depois
Tópico de inscrição Um tópico do catálogo, por exemplo marketing ou news, ou uma nova chave, que aparecerá no catálogo. O cliente pode cancelar a inscrição apenas desse tópico
Mensagem transacional É enviada sem verificar inscrição, frequência e horário silencioso, mas não para um canal fechado do destinatário: a caixa de e-mail ou o número não existe, o bot foi bloqueado. Use apenas para confirmação de pedido, redefinição de senha e mensagens semelhantes; veja Mensagens transacionais e cascatas

Lista de modelos

A tabela mostra o canal, as versões de idioma do modelo (o idioma principal fica destacado em cor), a avaliação de entregabilidade, o tópico de inscrição e o horário da alteração com o número da versão.

Entregabilidade é o resultado da verificação de entregabilidade do modelo de e-mail em todas as versões de idioma: a pior avaliação entre as versões (“Bom”, “Há observações”, “Ruim”) e a maior pontuação do filtro de spam (spam a partir de 6). Os detalhes de cada idioma e o horário da verificação aparecem na dica do selo. O modelo é verificado em segundo plano após cada alteração do e-mail; enquanto a verificação está em andamento, o selo mostra “Verificando”. Alterar só o nome ou o tópico de inscrição não inicia uma nova verificação. Se a avaliação for “Há observações” ou “Ruim”, abra o modelo e execute a verificação nele para ver as observações.

Acima da tabela ficam a busca por nome e os filtros por canal, idioma e avaliação de entregabilidade, por exemplo todos os modelos com avaliação “Ruim” ou todos os modelos com versão em alemão. Clicar no cabeçalho de uma coluna ordena a tabela; clicar de novo inverte a ordem. Os filtros e a ordenação são lembrados: depois de excluir um modelo ou voltar do editor, a lista continua igual.

Lista de modelos com idiomas e avaliação de entregabilidade

Para excluir um modelo, clique no ícone de lixeira na linha dele na lista.

Variáveis

Os modelos são escritos na linguagem Twig. A variável fica entre chaves duplas. A lista completa, com exemplos, aparece ao expandir o bloco Variáveis abaixo do conteúdo.

Variável O que é inserido
profile.email, profile.phone, profile.user_id Identificadores do cliente
traits.first_name e outros traits.* Atributos do perfil
event.name, event.properties.amount O evento que disparou a mensagem
context.data.*, context.nodes.* Dados da jornada: os enviados na entrada pela API e a resposta do nó “Webhook”
project.name, unsubscribe_url, preferences_url Nome do projeto, link de cancelamento de inscrição e link para a central de preferências
project.legal_address Endereço legal da empresa nas configurações do projeto; útil para o rodapé do e-mail. Vazio se o endereço não estiver definido
loyalty.points, loyalty.tier, loyalty.expiring, loyalty.expire_at, loyalty.referral_url Conta no programa de fidelidade: saldo, nível, pontos a expirar e a data, link de convite
wallet_url Link para o cartão de fidelidade no Wallet: o cliente adiciona o cartão ao Apple Wallet ou ao Google Wallet. Vale por 90 dias; vazio se os cartões Wallet não estiverem conectados
promo_code('welcome') Cupom do cliente do grupo welcome: emitido no envio; na pré-visualização, um exemplo
order.number, order.amount, order.tracking_url Pedido do e-mail da loja: número, valor, link de rastreamento; valor com moeda — {{ order.amount|money(order.currency) }}
product('SKU-1') Produto do catálogo no idioma do e-mail: name, url, image, price, old_price, currency, available, stock, no momento do envio (preços e disponibilidade de produtos)
Olá, {{ traits.first_name|default('cliente') }}!
{% if event.properties.amount > 5000 %}O frete é grátis.{% endif %}

O exemplo acima cumprimenta o cliente pelo nome (ou com uma palavra padrão, se o nome estiver vazio) e avisa sobre frete grátis em pedidos acima de 5000.

Os modelos são executados em um ambiente isolado (sandbox) seguro. Ele oferece as condições if, os laços for, set, as funções date, min, max e os filtros default, date, upper, lower, capitalize, number_format, round, join, replace, striptags e outros. Se uma variável não existir, é inserido um texto vazio, então use default nos pontos importantes. Se você usar uma construção proibida, ao salvar aparece o erro “O modelo usa uma construção proibida”. A mensagem final não pode passar de 512 KB. A herança de modelos (extends, block) não está disponível, e os laços e as chamadas de produtos, recomendações e códigos promocionais têm limite: um modelo que executa operações demais não será salvo.

Se o modelo tiver uma variável que a plataforma não conhece — um marcador de outro layout como {{ COMPANY_ADDRESS }} ou um erro de digitação como {{ first_name }} em vez de {{ traits.first_name }} —, um aviso com essas variáveis aparece acima do conteúdo. Elas ficarão vazias na mensagem. O aviso é atualizado quando você abre o modelo, salva, faz a pré-visualização e envia um teste.

Pré-visualização e envio de teste

  1. No painel Pré-visualização, informe o ID do perfil, o e-mail ou o user_id e clique no ícone de olho. Se o campo ficar vazio, os dados vêm do perfil com a atividade mais recente.
  2. No e-mail, alterne entre os modos Computador, Celular, Modo escuro e Sem imagens. No último, as imagens são substituídas pelas descrições alt: é assim que o e-mail aparece para os destinatários cujas imagens não são carregadas.
  3. No painel Envio de teste, escolha a integração. Informe o seu endereço ou chat id; caso contrário, a mensagem vai para o endereço do perfil. Clique em Enviar teste: o status da mensagem aparece abaixo do botão.

O envio de teste está disponível para a função “Gerente” e superiores. Nele, a inscrição, a frequência e o horário silencioso não são verificados. A pré-visualização não tem um evento de gatilho, então as variáveis event.* ficam vazias. Se você não tiver permissão para ver dados pessoais, o e-mail e o telefone aparecem mascarados.

Editor de modelo com pré-visualização em um perfil

Abaixo do e-mail, na pré-visualização, fica o bloco Na caixa de entrada. Ele mostra como o remetente, o assunto e o pré-cabeçalho aparecem na lista de e-mails do Gmail no computador, do Outlook e do Mail no iPhone. Um assunto e um pré-cabeçalho longos são cortados mais ou menos como nesses programas. O nome do remetente vem da integração escolhida no bloco de verificação de entregabilidade.

E-mail na caixa de entrada dos programas de e-mail

Verificação de entregabilidade

Antes de enviar, você pode verificar um modelo de e-mail: ele vai cair na caixa de entrada ou no spam? No bloco Verificação de entregabilidade, escolha a integração pela qual o e-mail será enviado e clique em Verificar. O e-mail é montado do mesmo jeito que no envio: com o rastreamento de aberturas e cliques e o link de descadastro. É verificada a versão de idioma aberta, e os dados são preenchidos a partir do perfil indicado na pré-visualização.

A verificação analisa três coisas:

  • Remetente. Para o serviço de e-mail do OneTrace.pro, o domínio do endereço do remetente precisa estar adicionado e verificado em Domínios de envio, de preferência com um registro DMARC. Para um servidor SMTP próprio, são verificados os registros SPF e DMARC do domínio; a assinatura DKIM é configurada no seu provedor de e-mail e não é possível verificá-la daqui.
  • Conteúdo. O assunto (vazio, em maiúsculas, com !! ou $$, longo demais), o pré-cabeçalho, o tamanho do e-mail (o Gmail corta HTML acima de 102 KB), e-mail feito só de imagens, imagens sem alt, encurtadores de links, links por endereço IP e links cujo texto é o endereço de outro site, o link de descadastro visível nos e-mails de marketing e os elementos que os programas de e-mail removem (scripts, formulários, frames).
  • Pontuação do filtro de spam. O e-mail inteiro é analisado pelo filtro de spam Rspamd. Uma pontuação abaixo do limite de “suspeito” é boa; acima do limite de “spam”, o e-mail provavelmente cairá no spam. Na lista O que influenciou a pontuação aparecem as regras do filtro e o peso de cada uma.

O resultado é uma destas avaliações: Bom (não há motivos evidentes para cair no spam), Há observações (o e-mail vai chegar, mas é melhor corrigir as observações) ou Ruim (alto risco de spam ou erro do remetente). Cada observação explica o que está errado e como corrigir.

Mais abaixo fica a Compatibilidade com programas de e-mail: recursos de layout que não funcionam no Outlook para Windows, no Gmail, no Yandex Mail ou no Mail.ru, como cantos arredondados, sombras, media queries, fontes próprias, SVG e vídeo. O e-mail vai chegar nesses programas, mas vai aparecer de outro jeito, por isso isso não afeta a avaliação.

Verificação de entregabilidade do e-mail

As campanhas verificam os e-mails das suas variantes do mesmo jeito — veja Verificação dos e-mails antes do lançamento.

Versões de idioma

Um modelo pode ter versões em vários idiomas. Cada destinatário recebe a versão no idioma do perfil dele (o atributo language) ou, se não houver, a principal. Os idiomas disponíveis são definidos nas configurações do projeto.

  1. Acima do bloco Conteúdo, clique em Adicionar idioma e escolha um idioma. Depois escolha como criar a versão:

    • Cópia da versão aberta — layout, imagens e links já estão no lugar, falta só traduzir os textos;
    • Tradução com IA — um rascunho de tradução da versão principal, veja abaixo;
    • Importar um e-mail com IA — um e-mail pronto neste idioma, veja Importar para uma versão de idioma.

    Escolha de como criar a nova versão

  2. Alterne entre as versões com os botões de idioma. A versão principal é marcada como "principal".

  3. Para que destinatários sem versão própria recebam outro idioma, abra a versão desse idioma e clique em Tornar principal. Excluir versão remove a versão aberta.

  4. Clique em Salvar. Cada versão é verificada separadamente; uma versão com erros aparece com um ícone de alerta.

Rascunho de tradução

Para não traduzir uma versão do zero manualmente, abra-a e clique em Rascunho de tradução. O OneTrace.pro traduz a versão principal para o idioma da aba aberta: assunto, pré-cabeçalho, textos dos blocos do editor, versão em texto simples, textos de SMS, push e mensageiros. Variáveis como {{ traits.first_name }}, links, imagens e o design não mudam.

O rascunho apenas preenche o formulário. Leia-o, ajuste as formulações e clique em Salvar. Se algum campo não puder ser traduzido sem perder variáveis, ele permanece no idioma de origem e o OneTrace.pro mostra quantos campos ficaram assim. Se a versão já for diferente da principal, uma pergunta aparece antes da substituição.

O número de rascunhos por mês é limitado pelo plano; veja Planos. O botão não aparece se a tradução não estiver ativada na sua instalação.

A versão é escolhida assim: primeiro o idioma exato, depois o idioma sem região (um cliente com pt-BR recebe a versão pt) e depois outra variante do mesmo idioma. A pré-visualização e o envio de teste mostram a versão aberta, e a variável {{ language }} contém o idioma da versão enviada.

Editor de e-mails

No modelo de e-mail, clique em Abrir o editor no campo “Editor de e-mail”. Se o modelo já tiver HTML, o editor começa o e-mail do zero, e o código antigo é substituído ao salvar. O OneTrace.pro gera sozinho, ao salvar, o código para os clientes de e-mail, incluindo o Outlook e os celulares.

À direita da tela há três abas:

  • Blocos: adicionar um bloco. Ele é colocado depois do bloco selecionado ou no fim do e-mail, antes do rodapé.
  • Bloco: configurações do bloco selecionado na tela. Os blocos podem ser movidos para cima e para baixo, arrastados, duplicados e excluídos.
  • E-mail: fundo, fundo do e-mail, cores do texto e dos links, fonte, largura do e-mail (480–800 px), espaçamento interno e forma de exibir as imagens.
Bloco Finalidade
Título, Texto Texto com formatação e variáveis, por exemplo {{ traits.first_name }}
Imagem Imagem da biblioteca de mídia: texto alternativo, link, largura de 10 a 100 %
Botão Texto, link, cores e arredondamento
Divisor, Espaçador Linha e espaço vazio
Colunas 2 ou 3 colunas com títulos, texto, imagens, botões e espaçadores. No celular, as colunas ficam uma embaixo da outra
Produtos Seleção de recomendações: personalizados, populares, “Vistos juntos”, “Semelhantes” etc. Os personalizados, populares e em alta podem ser limitados a uma Categoria do catálogo. A fonte Produtos selecionados mostra até 12 produtos do catálogo na ordem definida: encontre-os pelo nome, e só entram no e-mail os que estão em estoque. É possível exibir de 1 a 12 produtos em 1 a 4 colunas, com preço e botão. Nos produtos com avaliações, a nota aparece abaixo do nome. Se não houver produtos adequados, o bloco não entra no e-mail
Pedido Pedido do e-mail da loja: produtos, valores, rastreamento da encomenda e endereços. Em e-mails sem pedido, o bloco não aparece
Pesquisa A pergunta principal da pesquisa: botões NPS de 0 a 10 ou cinco estrelas. O cliente dá a nota direto no e-mail, e a página da pesquisa a salva e sugere as outras perguntas
HTML O seu próprio código, como está
Rodapé Texto, link de cancelamento de inscrição e link “Gerenciar inscrições”

Editor de e-mail com um bloco selecionado

O botão Mudar para HTML, na aba “E-mail”, transforma o e-mail em código comum. Depois disso, não é possível voltar ao editor.

Link (CDN) Anexo no e-mail
Tamanho do e-mail Leve Maior, somando o tamanho das imagens
Exibição A imagem é carregada ao abrir. Se o e-mail bloquear imagens, aparece só a legenda A imagem aparece na hora

A forma padrão é definida no campo Entrega de imagens padrão, na aba “E-mail”. Em uma imagem específica, ela pode ser alterada no campo Exibição. Todos os anexos de um mesmo e-mail, somados, não podem passar de 1 MB. Se os links públicos não estiverem configurados na instalação, só os anexos ficam disponíveis.

IA no editor de e-mails

A IA ajuda com os textos do modelo de e-mail: sugere assuntos, ajusta o texto dos blocos e monta o e-mail inteiro a partir de uma descrição. O resultado da IA é um rascunho: ele vai para o formulário ou para o editor, e quem salva o modelo é você. A IA conhece o nome do projeto, o ramo da loja, a moeda, o idioma da versão aberta e o tom e as regras da marca. Os dados dos clientes não são enviados a ela.

A IA está disponível em plano pago e é cobrada do saldo do projeto conforme o uso. Se a IA estiver indisponível no momento (período de teste, saldo zerado ou limite de gastos atingido), os botões continuam visíveis, com o motivo ao lado.

Ideias de assunto

O botão Ideias de assunto fica acima dos campos “Assunto” e “Pré-cabeçalho”. Escolha o Foco (abordagens diferentes, curiosidade e clareza, urgência, toque pessoal ou benefício para o leitor) e, se quiser, escreva as Preferências, por exemplo “sem emojis”. Clique em Sugerir: a IA sugere cinco pares de assunto + pré-cabeçalho com base no texto da versão aberta do e-mail.

Na lista, o assunto aparece como o destinatário o verá, com um nome de exemplo. A marca Com o nome do destinatário indica que o assunto tem a variável do nome. O botão Usar coloca o par no formulário.

Ideias de assunto e pré-cabeçalho

Ajuste do texto de um bloco

Selecione no canvas do editor um título, um texto ou um botão. No painel do bloco, na seção IA: editar o texto, há os botões Encurtar, Mais simpático, Mais formal, Corrigir erros e Reescrever…, este com a sua instrução. A sugestão da IA aparece abaixo dos botões: Substituir a coloca no bloco, e Cancelar mantém o texto como estava.

A IA não altera as variáveis do modelo nem os links. Se uma variável sumir da resposta ou um link mudar, o texto não é substituído e você vê a explicação.

Ajuste do texto de um bloco com IA

E-mail a partir de uma descrição

O botão E-mail com IA fica acima do editor e ao lado do botão “Abrir o editor”. Descreva do que trata o e-mail e o que você espera do leitor, e informe os links, por exemplo: “liquidação de casacos até domingo, descontos de até 30 %, link https://…”. Ative Produtos do catálogo se o e-mail precisar de produtos: a IA examina as categorias do catálogo e encontra produtos em estoque. Clique em Montar o e-mail; normalmente leva até um minuto.

Para que o novo e-mail se pareça com os seus outros e-mails, escolha um E-mail de exemplo: um modelo de e-mail do projeto criado no editor. A IA repete o visual e a estrutura dele: cores e fonte, logotipo e outras imagens, botões, blocos HTML como uma caixa com código promocional e o rodapé com as variáveis. Os textos ela escreve pela descrição: ofertas, códigos promocionais e links do exemplo não passam para o novo e-mail, a não ser que você os informe na descrição.

O e-mail é montado com blocos do editor: título, texto, botão, produtos e rodapé com o link de cancelamento da inscrição. Se o editor já tiver um e-mail, o OneTrace.pro pergunta se deve substituí-lo. O assunto e o pré-cabeçalho só são preenchidos se esses campos estiverem vazios. Se algo precisar de ajuste, aparecem avisos acima do editor, por exemplo para informar os links dos botões que não estavam na descrição.

E-mail com IA a partir de uma descrição

As variantes do e-mail para o teste A/B a IA cria diretamente na campanha.

Importar um e-mail pronto

Se o e-mail já foi criado em outro serviço, não é preciso montá-lo de novo. Na página Modelos, clique em Importar e-mail (IA):

  1. Escolha Arquivo e envie um e-mail salvo do seu programa de e-mail (.eml) ou uma página .html. Ou escolha Código HTML e cole o código do e-mail.
  2. Clique em Importar. A IA costuma levar até um minuto para processar o e-mail.
  3. O editor abre com um novo modelo de e-mail: o e-mail é dividido em blocos do editor, as imagens são copiadas para a biblioteca de mídia, o nome do destinatário é trocado pela variável {{ traits.first_name }} e o link de descadastro vai para o bloco “Rodapé”. Textos e links ficam como no e-mail.
  4. Revise o modelo e clique em Salvar. Até você salvar, o modelo não existe.

Janela de importação de e-mail

Modelo criado a partir de um e-mail com IA

Se parte do e-mail não pôde ser transferida, aparece uma lista acima do formulário: quais imagens não foram copiadas ou quais blocos foram ignorados. Se o e-mail não puder ser dividido em blocos, ele é importado como um único bloco “HTML”. Pixels de rastreamento e o link “Ver no navegador” não são importados.

OneTrace.pro detecta o idioma do e-mail pelo atributo lang e pelo cabeçalho Content-Language e, se eles não batem com o texto, pelo próprio texto do e-mail. O idioma do e-mail se torna o idioma principal do novo modelo.

Importar para uma versão de idioma

Se você já tem o e-mail em outro idioma, não precisa traduzi-lo: em um modelo de e-mail aberto, clique em Adicionar idioma, escolha o idioma e depois Importar um e-mail com IA. O e-mail é enviado do mesmo jeito que na criação de um modelo e vai para a versão do idioma escolhido, com blocos, imagens e assunto próprios. Revise a versão e clique em Salvar.

Se o idioma do e-mail não corresponder ao escolhido, aparece acima da versão uma dica, por exemplo “Parece que o e-mail está em francês”, e o botão Usar como versão "francês". Se essa versão já existir, OneTrace.pro pergunta se você quer substituí-la.

A importação está disponível nos planos “Crescimento” e “Empresarial”; o número de importações por mês — tanto de novos modelos quanto de versões — depende do plano, veja Planos. No plano “Inicial”, o botão mostra a partir de qual plano a função está disponível.

Biblioteca de mídia

A biblioteca de mídia abre quando você adiciona um bloco “Imagem” ou clica em Escolher imagem.

  • Enviar aceita JPEG, PNG, GIF, WebP e AVIF de até 10 MB. Imagens largas são reduzidas para 1200 px. WebP e AVIF são convertidos, porque nem todos os clientes de e-mail os exibem. GIF fica como está, com a animação.
  • Se você enviar o mesmo arquivo de novo, não é criada uma cópia.
  • Uma imagem usada em um modelo não pode ser excluída enquanto você não a remover do modelo.
  • O espaço ocupado pelas imagens conta para o limite do plano.

Biblioteca de mídia com imagens enviadas