Como adicionar lógica condicional a modelos de e-mail usando o criador de lógica

O que você vai aprender

Saiba como usar o construtor de lógica para adicionar lógica condicional dinâmica — como instruções if/else e loops for — diretamente aos blocos de texto nos seus modelos de e-mail. Isso permite exibir conteúdo personalizado para diferentes destinatários com base no perfil ou em propriedades personalizadas, sem escrever código.

Antes de começar

O construtor de lógica está disponível em:

• Editor de e-mail de arrastar e soltar — blocos de texto, blocos de tabela e blocos de divisão
• Editor de e-mail somente texto — em um modal em vez de um painel lateral

Para usar o construtor de lógica, você vai precisar de pelo menos um perfil na sua conta que tenha a propriedade que você quer avaliar. As propriedades de perfil e as propriedades personalizadas podem ser adicionadas por meio de formulários de registro, uploads de CSV, integrações de e-commerce e outras ferramentas de crescimento de lista.

Observação: O construtor de lógica é compatível com perfil e propriedades personalizadas. Ele não é compatível com dados de evento. Para usar dados de evento na sua lógica, use a opção Converter em código e escreva tags do Django diretamente.

Adicione uma instrução if/else

Use uma instrução if/else para exibir conteúdos diferentes aos destinatários com base em um perfil ou uma propriedade personalizada. Por exemplo, você pode mostrar um bloco de desconto para VIP somente para clientes com mais de 500 pontos de fidelidade e um incentivo de inscrição para todos os demais.

No editor de arrastar e soltar

1. Clique duas vezes em um bloco de texto, bloco de tabela ou bloco de divisão para entrar no modo de edição.
2. Clique no botão Inserir na barra de ferramentas na parte superior da página.
3. Selecione If/else no menu suspenso.
   • Um painel lateral será aberto à esquerda, e a tela será deslocada para a direita.
4. Configure sua instrução if:
   • Use o primeiro menu suspenso para escolher um perfil ou propriedade personalizada para avaliar.
   • Use o segundo menu suspenso para selecionar um operador (por exemplo: igual a, é maior que, está definido).
   • Insira ou selecione um valor para comparar, dependendo do operador escolhido.
5. Se quiser, clique em Adicionar condição para adicionar critérios adicionais à instrução if.
   • Use AND ou OR para conectar condições. OR é selecionado por padrão.
   • Clique no botão clonar em uma condição para duplicá-la como uma nova condição OR.
6. Para adicionar uma ramificação else if, clique em Adicionar else if e configure as condições da mesma forma. Os destinatários que atenderem a essas condições — mas não à instrução if — vão ver este conteúdo.
7. Para adicionar uma ramificação else, marque a caixa de seleção Else (marcada por padrão). Edite o conteúdo no canvas para definir o que os destinatários que não atendem a nenhuma condição vão ver. Desmarque a caixa para remover a ramificação else por completo.
8. Edite o conteúdo no canvas para cada condição. Cada condição aparece como uma caixa azul enquanto está sendo configurada.
9. Quando terminar, clique na seta para trás para fechar o painel e salvar sua lógica.

Dica: para remover toda a lógica configurada de um bloco, clique em Remover lógica no painel lateral.

Observação: clicar em Excluir na instrução if inicial vai redefinir os valores dela, em vez de remover a instrução por completo. Clicar em Excluir em uma ramificação else if ou else vai remover essa ramificação.

No editor somente texto

Siga as mesmas etapas acima, mas selecione Inserir na barra de ferramentas de edição de texto. O criador de lógica será aberto em um modal em vez de um painel lateral. Todas as mesmas opções de configuração estão disponíveis.

Adicionar um loop for

Use um loop for para iterar por uma lista de itens e exibir conteúdo repetido para cada um. Por exemplo, você pode percorrer os produtos visualizados recentemente por um cliente para mostrar cada um deles no e-mail.

No editor de arrastar e soltar

1. Clique duas vezes em um bloco de texto, bloco de tabela ou bloco de divisão.
2. Clique no botão Inserir na barra de ferramentas.
3. Selecione Loop for no menu suspenso.
   • Um painel lateral será aberto à esquerda.
4. No campo Variável, insira a lista pela qual você quer fazer um loop (por exemplo, event.items).
5. No campo Alias do item, insira um nome para referenciar cada item individual dentro do loop (por exemplo, item).
6. Edite o conteúdo no canvas para definir o que será exibido para cada item.
7. Clique na seta para trás para fechar o painel e salvar sua lógica.

Dica: para remover o loop por completo, clique em Remover lógica no painel lateral.

Adicionar uma tag configurável

Use uma tag configurável para inserir tags do Django que não são abrangidas pelos criadores de if/else ou de loop for — como instruções with ou tags de catálogo.

1. Clique duas vezes em um bloco de texto, bloco de tabela ou bloco de divisão.
2. Clique no botão Inserir na barra de ferramentas.
3. Selecione Tag configurável no menu suspenso.
   • Um painel lateral será aberto à esquerda.
4. No campo Nome da tag, insira a tag que vai abrir e fechar o bloco (por exemplo, with).
5. Na área de texto Código, adicione seu código de tag personalizada do Django.
6. Para adicionar uma ramificação, clique em Adicionar ramificação. Isso cria uma seção adicional em que você pode configurar outro nome de tag e bloco de código.
7. Clique na seta para trás para fechar o painel e salvar sua lógica.

Trabalhar com lógica aninhada

Você pode aninhar instruções lógicas dentro umas das outras — por exemplo, uma instrução if/else dentro de um loop for. Isso permite que você crie sequências de conteúdo altamente segmentadas.

Quando a lógica está aninhada:

• Os ícones de linhas verticais indicam o nível de aninhamento de cada declaração lógica.
• Ao passar o mouse sobre uma instrução pai, todo o bloco aninhado é destacado.
• Ao passar o mouse sobre uma instrução filha, apenas essa instrução filha é destacada.
• Você pode recolher e expandir as instruções-filhas de forma independente da instrução-pai.
• Se mais de três níveis de lógica estiverem aninhados, um indicador +[número] aparecerá para mostrar a profundidade adicional do aninhamento.

Converter a lógica em código

Se você precisar de mais controle sobre sua lógica ou quiser usar recursos não compatíveis, como dados de evento ou comparações de datas, você pode converter a configuração do seu criador de lógica em código Django bruto.

Aviso: converter a lógica em código é uma ação sem volta e não pode ser desfeita. Depois de converter, você não poderá voltar para o construtor de lógica.

Para converter:

1. Abra o painel lateral do criador de lógica do bloco que você quer atualizar.
2. Para instruções if/else, cada segmento individual (if, else if) tem seu próprio botão Converter para código. Clique no botão do segmento que você quer converter.
3. Para loops for, clique no único botão Converter em código para todo o loop.
4. Uma janela modal de aviso vai aparecer. Confirme que você quer continuar.
5. Após a conversão, o código convertido aparecerá em um editor de código no painel lateral. Você pode editá-lo diretamente por lá.

Esse estado convertido é permanente — ele vai permanecer mesmo depois que você fechar o painel ou sair do modelo.

Diferenças no editor somente de texto

O construtor de lógica no editor somente de texto funciona da mesma forma que no editor de arrastar e soltar, com uma diferença principal: a lógica é configurada em uma modal, e não em um painel lateral. Todas as mesmas opções de if/else, loops for, tag configuráveis, aninhamento e conversão para código estão disponíveis.

Depois que a lógica é configurada, ela aparece no canvas da mesma forma que no editor de arrastar e soltar. Ao clicar em Editar em uma condição configurada, o modal é aberto para permitir novas edições.

Recursos adicionais

• Referência de lógica condicional
• Como mostrar ou ocultar blocos e seções do modelo com base em variáveis dinâmicas
• Referência de personalização de mensagens
• Sobre propriedades personalizadas
• Curso: Aplique conceitos de lógica de programação para criar mensagens mais personalizadas