Como resolver mensagens de erro em modelos de e-mail

O que você vai aprender

Se você encontrar erros ou avisos em um modelo de e-mail, talvez seja necessário resolvê-los antes de enviar sua mensagem. Pesquise neste recurso a mensagem de erro ou o aviso que você está encontrando para ver dicas de como resolver o problema.

Avisos de envio de campanha

• Encontramos # blocos no seu e-mail que ainda têm o texto padrão sem modificar ou estão em branco. Revise o e-mail antes de continuar.
  Se você receber este aviso, procure blocos vazios ou conteúdo de placeholder (por exemplo, "Este é um bloco de texto. Clique aqui para editá-lo.") no seu modelo. Confira as versões para desktop e dispositivos móveis do modelo. Se você não encontrar um bloco vazio ou conteúdo de placeholder, envie uma mensagem de prévia para você mesmo e revise-a no desktop e em dispositivos móveis. Se a prévia estiver boa, é seguro enviar a mensagem e ignorar este aviso.
• Possíveis problemas com o conteúdo do e-mail. Parece que não há nenhum link no seu e-mail. Você se esqueceu de adicioná-los ao seu e-mail?
  Esse aviso aparece se o seu e-mail de texto simples ou HTML personalizado não incluir nenhum link. Revise a mensagem para garantir que todo o conteúdo foi adicionado, incluindo links para qualquer chamada à ação. Se você não quiser incluir links no seu e-mail (além do seu link para cancelamento de inscrição), pode ignorar este aviso.
• Link para cancelamento de inscrição. Não foi possível encontrar um link para cancelamento de inscrição no seu e-mail. A Klaviyo adicionará um link para cancelamento de inscrição automaticamente ao enviar o e-mail, caso você não o inclua.
  Este aviso aparece se você não tiver adicionado uma tag de cancelamento de inscrição à sua mensagem (por exemplo, {% unsubscribe %} ou {% unsubscribe_link %}). Adicione um link para cancelamento de inscrição para evitar que o rodapé padrão da Klaviyo seja anexado à sua mensagem.

Visualizar erros

Ao visualizar uma prévia de uma mensagem, você pode ver esta mensagem de erro:

Mensagem exibida sem tags ou variáveis
Corrija tags de modelo ou variáveis inválidas para visualizar a mensagem com perfis e eventos reais.

Esse erro significa que há sintaxe inválida em algum lugar da sua mensagem. Para localizar a origem do erro, verifique a linha de assunto e o conteúdo do corpo da sua mensagem em busca de variáveis, tag ou declarações condicionais (ou seja, qualquer coisa no seu modelo cercada por chaves {}) que não sigam o formato descrito nos recursos do Help Center da Klaviyo. Abaixo estão algumas dicas para localizar o erro:

• Verifique as versões para desktop e para dispositivos móveis da sua mensagem.
• Se a sua mensagem contiver um cupom único, verifique se o nome do cupom está correto e se o seu cupom foi configurado na guia cupom.

Erros de modelos HTML personalizados

• Não foi possível encontrar as seguintes imagens: ... Verifique se elas estão incluídas no arquivo zip que você enviou.
  Confira se você digitou corretamente todos os caminhos de origem da imagem e se eles correspondem aos nomes de arquivo das imagens que você enviou. Se nenhum caminho de imagem for fornecido na mensagem de erro, revise seu arquivo HTML em busca de atributos de plano de fundo vazios (por exemplo, background=””)
• Uma tag de {% cancelar inscrição %} é obrigatória.
  Adicione uma tag de cancelar inscrição do Klaviyo ao rodapé da sua mensagem para resolver esse erro.
• Não foi possível analisar o restante: 'Z' de 'XYZ'.
  Esse erro significa que uma das suas tags (qualquer coisa entre {% %}) não é reconhecida pelo Klaviyo. Consulte nosso guia de referência de personalização de mensagens para ver as tags aceitas.

Erros de catálogo

Se o seu modelo usa uma tag de busca no catálogo, você pode encontrar o erro Não foi possível encontrar o item com o código: __. Ele pode ter sido excluído.

Se você vir esse erro, isso significa que não reconhecemos o ID do item incluído na guia. Não deixe de:

• Você está visualizando uma prévia com um evento que contém IDs de item (se o ID do item fizer referência dinamicamente aos dados do evento).
• A referência ao ID do item nos dados do seu evento está formatada corretamente.
• O ID do item dos dados do seu evento corresponde ao que está no seu catálogo da Klaviyo.

Erros de modelo do Shopify

• Erro de sintaxe do Liquid no HTML do corpo: tag desconhecida 'cancelar inscrição'
  Erro de sintaxe do Liquid no HTML do corpo: tag desconhecida 'web_view'
  Esses erros e outros semelhantes significam que uma tag específica da Klaviyo foi adicionada ao seu modelo antes de exportá-lo para o Shopify. O Shopify não oferece suporte aos links de cancelar inscrição da Klaviyo, gerenciar preferências ou visualização na Web.
• Erro de sintaxe do Html Liquid do corpo: tag desconhecida "Load"
  O Shopify não oferece suporte ao recurso de bloco de produto do Klaviyo. Se você adicionar um bloco de produto ao seu modelo de notificação do Shopify e depois importar esse modelo para o Shopify, esse erro será exibido. Remova o bloco de produto, exporte o HTML do seu modelo e importe-o no Shopify.
• Erro de sintaxe do Liquid no html do corpo: Tag desconhecida 'elsif'
  Erro de sintaxe do Liquid no html do corpo: a tag 'if' nunca foi fechada
  Erro de sintaxe do Liquid no html do corpo: a Tag 'X' nunca foi fechada
  Muitos modelos de notificação da Shopify da Klaviyo incluem instruções condicionais, que tornam sua mensagem dinâmica com base no status do pedido do cliente. Se parte de uma instrução condicional for excluída, você verá um erro como os acima.
  
  Para resolver isso, abra o modelo na Klaviyo e remova os elementos restantes da instrução condicional. Procure por tags que começam com:
  • { % for item in...
  • {% endfor %}
  • {% if...
  • {% elsif...
  • {% else %}
  • {% endif %}