Solução de problemas com mensagens de erro de modelos de e-mail
Estimado 4 min de leitura
|
Atualizado 7 de ago. de 2025, 00:00 EST
O senhor aprenderá
Se o senhor encontrar erros ou avisos em um modelo de e-mail, talvez seja necessário resolvê-los antes de enviar a mensagem. Pesquise neste recurso a mensagem de erro ou aviso que o senhor está encontrando para encontrar dicas para resolver o problema.
Avisos de envio de campanhas
- Encontramos # blocos em seu e-mail que ainda têm o texto padrão não modificado ou estão em branco. Revise seu e-mail antes de continuar.
Se o senhor encontrar esse aviso, procure blocos vazios ou conteúdo de espaço reservado (por exemplo, "Este é um bloco de texto. Clique aqui para editá-lo.") em seu modelo. Verifique as versões desktop e móvel do modelo. Se não conseguir encontrar um bloco vazio ou conteúdo de espaço reservado, envie uma mensagem de visualização para si mesmo e revise-a no desktop e no celular. Se a visualização parecer boa, é seguro enviar a mensagem e ignorar esse aviso. - Possíveis problemas com o conteúdo do e-mail. Parece que não há nenhum link em seu e-mail. O senhor se esqueceu de adicioná-los ao e-mail?
Esse aviso aparece se o e-mail em texto simples ou HTML personalizado não incluir nenhum link. Revise a mensagem para ter certeza de que todo o conteúdo foi adicionado, inclusive os links para as chamadas para ação. Se não quiser incluir nenhum link no e-mail (exceto o link de cancelamento de inscrição), o senhor pode ignorar esse aviso. - Link de cancelamento de inscrição. Não foi possível encontrar um link de cancelamento de inscrição em seu e-mail. A Klaviyo adicionará automaticamente um link de cancelamento de assinatura ao enviar o e-mail, caso o senhor não adicione um.
Esse aviso aparece se o senhor não tiver adicionado uma tag de cancelamento de assinatura à mensagem (por exemplo, {% unsubscribe %} ou {% unsubscribe_link %}). Adicione um link de cancelamento de assinatura para evitar que o rodapé padrão do Klaviyo seja anexado à sua mensagem.
Erros de visualização
Ao visualizar uma mensagem, o senhor pode encontrar essa mensagem de erro:
Mensagem exibida sem tag ou variáveis
Corrija a tag inválida do modelo ou das variáveis para visualizar a mensagem com o perfil e os eventos reais.
Esse erro significa que há uma sintaxe inválida em algum lugar de sua mensagem. Para localizar a origem do erro, verifique a linha de assunto e o conteúdo do corpo da mensagem em busca de variáveis, tags ou declarações condicionais (ou seja, qualquer coisa em seu modelo cercada por colchetes {}) que não siga o formato descrito nos recursos da Central de Ajuda da Klaviyo. Abaixo estão algumas dicas para localizar o erro:
- Verifique as versões desktop e móvel de sua mensagem.
- Se sua mensagem contiver um cupom dinâmico, verifique se o nome do cupom está correto e se o cupom foi configurado na guia Coupons.
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 o senhor carregou.
Verifique se todos os caminhos de origem da imagem foram escritos corretamente e se correspondem aos nomes dos arquivos das imagens que o senhor carregou. Se nenhum caminho de imagem for fornecido na mensagem de erro, verifique se há atributos de plano de fundo vazios em seu arquivo HTML (por exemplo, background="") - É necessária uma tag {% unsubscribe %}.
Adicione uma tag de cancelamento de assinatura do Klaviyo ao rodapé da mensagem para resolver esse erro. - Não foi possível analisar o restante: 'Z' de 'XYZ'.
Esse erro significa que uma de suas tags (qualquer coisa cercada por {% %}) não é reconhecida pelo Klaviyo. Consulte nosso guia de referência de personalização de mensagens para ver as etiquetas aceitas.
Erros de catálogo
Se o seu modelo usar uma tag de pesquisa de catálogo, o senhor poderá encontrar o erro Unable to find item with code: __. Ele pode ter sido excluído.
Se o senhor vir esse erro, significa que não reconhecemos o ID do item incluído na guia. Certifique-se de que:
- O senhor está visualizando com um evento que contém IDs de itens (se o ID do item fizer referência dinâmica aos dados do evento).
- A referência ao ID do item dos dados do seu evento está formatada corretamente.
- O ID do item dos dados do evento corresponde ao que está no catálogo do Klaviyo.
Erros de modelo da Shopify
- Corpo html Erro de sintaxe do Liquid: Tag desconhecida 'unsubscribe'
Erro de sintaxe do Body html Liquid: Unknown tag '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 a Shopify. A Shopify não é compatível com os links de cancelamento de assinatura, gerenciamento de preferências ou visualização na web da Klaviyo. - Body Html Liquid Syntax Error : Tag desconhecida "Load"
A Shopify não pode suportar o recurso de bloco de produtos da Klaviyo. Se o senhor adicionar um bloco de produto ao seu modelo de notificação da Shopify e, em seguida, importar esse modelo para a Shopify, esse erro será exibido. Remova o bloco do produto, exporte o HTML do modelo e importe-o para a Shopify. - Erro de sintaxe do corpo html Liquid: Desconhecido tag 'elsif' Erro de sintaxe do Body
html Liquid: 'if' tag nunca foi fechado
Erro de sintaxe do Body html Liquid: A tag 'X' nunca foi
fechada Muitos dos Klaviyo Shopify modelos de notificação do 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, o senhor verá um erro como os descritos acima.
Para resolver isso, abra o modelo em Klaviyo e remova o elemento restante da declaração condicional. Procure por tags que comecem com: - { % for item in...
- {% endfor %}
- {% if...
- {% elsif...
- {% else %}
- {% endif %}
Esse artigo foi útil?
Use esse formulário somente para dar feedback sobre os artigos. Saiba como entrar em contato com o suporte.