Modelos transacionais

4 min de leitura64
Copiar para a I.A.:

E-mail transacional é o que o seu sistema manda para uma pessoa por causa de algo que ela fez: confirmação de pedido, código de acesso, aviso de entrega. Em Conteúdo › Transacionais você escreve o texto desses e-mails no painel, e o sistema integrado só diz qual modelo usar e com quais valores. Na Casa Moura Cafés, a loja virtual dispara o modelo pedido-confirmado a cada compra — e quando a Renata quer mudar uma frase, ela muda aqui, sem pedir alteração no código da loja.

Criar um modelo

Clique em Novo modelo e preencha:

  • Chave — o nome que o sistema envia para escolher o modelo. Só letras minúsculas, números e hífen, única na conta, e não muda depois de criada. Escolha pensando em quem vai integrar: pedido-confirmado, e não modelo1.
  • Nome — como a sua equipe reconhece o modelo na lista.
  • Modelo ativo — veja abaixo o que acontece ao desligar.
  • Assunto — aceita variáveis, como os demais campos.
  • Conteúdo HTML — com a aba Prévia para conferir e a barra com Gerar com IA, Usar modelo e Salvar como modelo.
  • Versão em texto, na aba Texto simples — opcional. Aparece em clientes de e-mail que não mostram HTML e ajuda na pontuação de spam.

O modelo não guarda remetente: ele vem da chamada do sistema ou, se a chamada não indicar, é o remetente padrão da conta.

Variáveis: o contrato com o sistema

Onde entra um valor da chamada, escreva o nome entre chaves duplas: {{numero_pedido}}. Logo abaixo do assunto, Variáveis detectadas mostra em tempo real a lista tirada do assunto, do HTML e da versão em texto. Essa lista é exatamente o que a chamada precisa mandar — nem mais, nem menos:

  • se a chamada não mandar uma variável que o modelo usa, o envio é recusado;
  • se a chamada mandar uma variável que o modelo não usa, o envio também é recusado.

A regra é rígida de propósito: sem ela, o e-mail sairia com um buraco no lugar do dado — "Seu pedido nº foi confirmado" — e contaria como entregue.

O pedido-confirmado da Casa Moura tem o assunto "Pedido {{numero_pedido}} confirmado" e, no HTML, {{first_name}} e {{previsao_entrega}}. A loja manda os três valores a cada compra.

Três diferenças em relação às campanhas

  • Os valores vêm da chamada, não do cadastro do contato. Por isso a lista de variáveis das campanhas não aparece aqui.
  • Não há valor de reserva: {{first_name|cliente}} não é reconhecido. Se um dado pode faltar, o sistema precisa mandar o texto alternativo.
  • O valor entra como texto: marcação HTML enviada numa variável aparece escrita no e-mail, não formatada.

Escreva a variável sem espaços dentro das chaves. {{ numero_pedido }} não é detectada nem substituída, e sai assim no e-mail.

Mudar um modelo que já está em uso

Salvar vale a partir do próximo envio. Mudar texto, cores e layout é seguro. O que pede combinação prévia com quem cuida da integração é mexer nas variáveis:

  • acrescentar uma variável faz as chamadas atuais, que não a mandam, passarem a ser recusadas;
  • renomear ou remover uma variável faz o sistema mandar um nome que o modelo não usa mais — também recusado.

Cuidado especial com Usar modelo: um modelo de e-mail de marketing costuma trazer variáveis do contato, como {{unsubscribe_url}}, que aqui viram exigências da chamada. A tela avisa quais vieram; troque ou remova as que não fizerem sentido antes de salvar.

Desativar e excluir

  • Desativar (desligar Modelo ativo) faz as chamadas com aquela chave serem recusadas, mas guarda o texto. É o jeito de tirar um disparo do ar e trazê-lo de volta depois.
  • Excluir faz o mesmo, sem volta. A chave fica livre, e um modelo novo com ela passa a responder no lugar.

Para onde ir depois

  • Criar e usar modelos de e-mail — a biblioteca de onde vem o Usar modelo.
  • Biblioteca de mídia — o endereço das imagens do HTML.
  • Personalizar com variáveis — como as variáveis funcionam nas campanhas, para comparar.

Resumindo: crie o modelo com uma chave estável, escreva as variáveis sem espaços e trate a lista de variáveis detectadas como contrato — a chamada manda exatamente essas —, combine com quem integra antes de mexer nelas e use o interruptor de ativo para tirar um envio do ar sem apagar o texto.

Este artigo foi útil?