Solução de problemas com mensagens de erro de modelos de e-mail

Estimado 5 minuto de leitura
|
Atualizado 22 de ago. de 2024, 10:38 EST
O senhor aprenderá

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

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

Erros de visualização

Ao visualizar uma mensagem, o senhor pode encontrar essa mensagem de erro: 

Mensagem exibida sem tags ou variáveis
Corrija as tags ou variáveis inválidas do modelo para visualizar a mensagem com perfis e 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

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

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

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: Tag 'elsif' desconhecida
    Erro de sintaxe do Body html Liquid: a tag 'if' nunca foi fechada
    Erro de sintaxe do Body html Liquid: a tag 'X' nunca foi fechada
    Muitos dos modelos de notificação da Shopify da Klaviyo incluem declaraçõ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 no Klaviyo e remova os elementos restantes da declaração condicional. Procure por tags que comecem com: 
    • { % for item in...
    • {% endfor %}
    • {% if...
    • {% elsif...
    • {% else %}
    • {% endif %}
Recursos adicionais

Recursos adicionais

Esse artigo foi útil?
Use esse formulário somente para fazer comentários sobre artigos. Saiba como entrar em contato com o suporte.

Saiba mais sobre a Klaviyo

Comunidade
Conecte-se com colegas, parceiros e especialistas da Klaviyo para encontrar inspiração, compartilhar percepções e obter respostas para todas as suas perguntas.
Treinamentos ao vivo
Participe de uma sessão ao vivo com especialistas da Klaviyo para aprender sobre as práticas recomendadas, como configurar os principais recursos e muito mais.
Suporte

Acesse o suporte por meio da sua conta.

Suporte por e-mail (teste gratuito e contas pagas) Disponível 24 horas

Chat/assistência virtual
A disponibilidade varia conforme o local e o tipo de plano