Como usar conteúdo dinâmico em modelos do WhatsApp
Adicione variáveis de perfil, personalizadas e de evento para personalizar modelos do WhatsApp. O conteúdo dinâmico permite adaptar cada mensagem com dados do cliente, como nome, nível de fidelidade, nome do produto ou link de finalização da compra.
Como os modelos do WhatsApp exigem aprovação da Meta antes do envio, você precisa seguir regras específicas de formatação ao adicionar variáveis.
Antes de começar
Conecte sua conta do WhatsApp Business à Klaviyo antes de enviar um modelo para aprovação. Você pode criar um modelo de rascunho antes de conectar.
Tenha o seguinte em mente antes de adicionar conteúdo dinâmico:
- Sempre inclua um valor padrão para cada variável.
- Visualize seu modelo com dados reais antes de enviá-lo para aprovação.
- Se você incluir links, adicione um URL de fallback.
- Certifique-se de que a propriedade do perfil ou o campo de evento exista na sua conta.
Os valores padrão mantêm sua mensagem legível quando faltam dados. Se uma variável de texto não tiver valor nem fallback, a Klaviyo envia um espaço em branco no lugar. Um link de botão de URL vazio ainda pode fazer com que a mensagem seja ignorada.
Adicionar variáveis de perfil e variáveis personalizadas de perfil
As variáveis de perfil extraem informações armazenadas no perfil de um cliente, como nome ou endereço de e-mail. Você também pode usar propriedades do perfil personalizadas que você criou, como nível de fidelidade ou localização da loja preferida.
Use Adicionar personalização no editor para inserir essas variáveis em vez de digitá-las manualmente.
Para adicionar uma variável de perfil ou de propriedade personalizada:
- Acesse Conteúdo > Modelos.
- Clique em Criar > Novo modelo.
- Selecione WhatsApp como o canal.
- Insira um Nome do modelo usando letras minúsculas, números e sublinhados e selecione o Idioma.
- Escolha a intenção da sua mensagem: Marketing ou Transacional.
- Clique em Criar para abrir o editor de modelos.
- No corpo, clique no ícone de pessoa Adicionar personalização.
- Pesquise e selecione a propriedade do perfil ou a propriedade personalizada que você quer inserir.
- Se a propriedade abrir um painel de configurações, insira Texto padrão e clique em Inserir. Você também pode adicionar ou atualizar o fallback na tag inserida usando o filtro
|default:'value'.
Exemplo:
Hi {{ person.first_name|default:'there' }},Exemplo com uma propriedade personalizada:
Your current loyalty tier is {{ person.loyalty_tier|default:'Valued customer' }}.Recomendamos usar valores padrão para que a mensagem ainda faça sentido quando uma Propriedade do perfil estiver vazia. O Klaviyo usa o texto alternativo em vez de deixar uma lacuna.
Adicionar variáveis de evento
As variáveis de evento extraem dados de um evento específico, como Produto visualizado ou Checkout iniciado. Use variáveis de evento para fazer referência a um nome de produto, valor do carrinho ou URL do checkout.
Use variáveis de evento em um fluxo acionado pelo evento correspondente. Por exemplo, use dados de Produto visualizado em um fluxo de carrinho abandonado. Selecionar um evento para a prévia do modelo não torna esses dados de evento disponíveis em uma campanha.
Para inserir variáveis de eventos:
- No editor de modelos, clique em Prévia.
- Em Pré-visualizar fonte de dados, selecione Evento e, em seguida, escolha o tipo de evento que aciona seu fluxo.
- Use as setas para navegar por instâncias recentes de eventos e selecione uma com os dados que você quer pré-visualizar.
- Clique em Todas as propriedades para ver as variáveis de evento disponíveis.
- Em Propriedades do evento, clique na propriedade que você quer usar para copiar a tag de variável.
- Clique em Concluído para voltar ao editor e, em seguida, cole a variável no seu modelo.
- Adicione um valor padrão usando o filtro
|default:'value'.
Por exemplo, se o seu evento tiver uma propriedade Name:
You recently viewed {{ event.Name|default:'an item on our site' }}.Se você incluir um link, sempre forneça uma URL alternativa. Por exemplo, um evento Viewed Product pode armazenar o link do produto em URL:
View this item: {{ event.URL|default:'https://yourwebsite.com' }}.Substitua https://yourwebsite.com por um URL válido da sua marca. Essa opção de fallback dá aos destinatários um destino quando o campo do evento está vazio. Para um link de checkout, copie o campo de URL de checkout do seu evento Started Checkout.

Como referenciar Propriedades do perfil com lookup
Se uma Propriedade do perfil contiver espaços ou caracteres especiais (como /), faça referência a ela usando o filtro lookup.
Por exemplo:
{{ person|lookup:'Birthday' }}Adicionar um valor alternativo
Se a propriedade do perfil puder estar ausente, adicione um valor de fallback usando o filtro default.
{{ person|lookup:'Birthday'|default:'your birthday' }}Isso exibe “seu aniversário” se o perfil não contiver essa propriedade.
Práticas recomendadas para aprovação da Meta
Siga estas diretrizes para reduzir o risco de rejeição do modelo:
- Inclua um valor padrão para cada variável.
- Garanta que os links de fallback usem um URL válido e com a sua marca.
- Visualize o modelo com dados reais de perfil e de evento.
- Confirme se suas variáveis correspondem exatamente às Propriedades do perfil existentes ou aos campos de eventos.
Se você não seguir os requisitos de formatação da Meta, seu modelo pode ser rejeitado ou as mensagens podem ser ignoradas.
Para ver mais requisitos de formatação, consulte Como criar um modelo do WhatsApp.
Próximas etapas
Agora que você adicionou conteúdo dinâmico ao seu modelo do WhatsApp:
- Clique em Enviar para análise, revise os detalhes do modelo e, em seguida, clique em Enviar para enviar o modelo para a Meta e receber a aprovação.
- Após a aprovação, use o modelo em uma campanha ou fluxo. Se ele contiver variáveis de evento, use um fluxo acionado pelo evento correspondente.
- Teste sua mensagem com perfis internos antes de enviar para clientes.