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 no conteúdo do e-mail. Parece que não há nenhum link no seu e-mail. Você esqueceu de adicioná-los ao e-mail?
Este aviso aparece se o seu e-mail em texto simples ou HTML personalizado não inclui nenhum link. Revise a mensagem para garantir que todo o conteúdo foi adicionado, incluindo links para quaisquer chamadas à ação. Se você não quiser incluir links no seu e-mail (além do seu link para cancelamento de inscrição), você pode ignorar este aviso. - Link para cancelamento de inscrição. Nenhum link para cancelamento de inscrição foi encontrado neste modelo. A Klaviyo adicionará um link para cancelamento de inscrição automaticamente ao enviar o e-mail.
Este aviso aparece se você não tiver adicionado uma tag de cancelar inscrição à sua mensagem (por exemplo, {% unsubscribe %} ou {% unsubscribe_link %}). Adicionar 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.
Esta mensagem significa que o Klaviyo não conseguiu renderizar uma tag de modelo ou variável. 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 instruções condicionais (ou seja, qualquer coisa no seu modelo cercada por {{ }} or {% %}) que não sigam o formato descrito na referência de personalização de mensagem. Confira abaixo 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 aba Cupons.
Depois de corrigir o problema, visualize a mensagem novamente com um perfil ou evento que contenha os dados usados pelo seu modelo. Confirme que as variáveis são preenchidas antes de enviar um e-mail de teste.
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.
Verifique se você digitou corretamente todos os caminhos de origem das imagens 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 e procure atributos de plano de fundo vazios (por exemplo,background=""). Remova os atributos de plano de fundo vazios e envie o arquivo HTML corrigido novamente. - 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 o Klaviyo não conseguiu ler parte de uma expressão do modelo. Verifique a expressão citada no erro para identificar aspas fora do lugar ou repetidas, espaços em nomes de propriedades ou sintaxe de filtro incorreta. O problema pode estar dentro de variáveis {{ }} ou tags {% %}. Consulte a referência de personalização de mensagens para ver a sintaxe compatível e exemplos.
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 tag. Certifique-se de que:
- 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).
- Se o ID do item vier de dados de evento ou de uma propriedade do perfil, a referência estará formatada corretamente.
- O ID do item na sua tag, nos dados do evento ou na propriedade do perfil corresponde a um item no seu catálogo do 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 do 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, gerenciar preferências ou web view do Klaviyo. Remova esses links específicos do Klaviyo do modelo de notificação do Shopify antes de exportá-lo novamente. - Erro de sintaxe do Liquid no HTML do corpo: tag desconhecida "Load"
Esse erro indica que o HTML exportado contém uma tag específica do Klaviyo que a Shopify não oferece suporte. Se o modelo de notificação da Shopify contiver um bloco de produto do Klaviyo, remova-o, exporte o HTML do seu modelo e importe-o para a 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 dos modelos de notificação do Shopify da Klaviyo incluem instruções condicionais, que tornam sua mensagem dinâmica com base no status do pedido do cliente, e loops, que repetem conteúdo para itens em um pedido. Se parte de uma instrução ou loop for excluída, você poderá ver um erro como os acima.
Para resolver isso, abra o modelo na Klaviyo e restaure as tags ausentes. Cada {% if ... %} precisa de um {% endif %} correspondente, e cada {% for ... %} precisa de um {% endfor %} correspondente. Mantenha {% elsif ... %} e {% else %} dentro da instrução correspondente. Se você remover intencionalmente uma instrução ou loop, remova o bloco inteiro, incluindo o conteúdo, para que não restem tags sem correspondência nem variáveis de item. Procure estas tags de abertura, ramificação e fechamento:- {% for item in...
- {% endfor %}
- {% if...
- {% elsif...
- {% else %}
- {% endif %}
Depois de fazer alterações, exporte o modelo atualizado e importe-o no Shopify. Visualize e teste a notificação no Shopify antes de salvar. As variáveis de notificação do Shopify são preenchidas no Shopify; a prévia do Klaviyo só permite que você confira o estilo.