Modo avançado das mensagens de notificação

Use variáveis dinâmicas, controle de fluxo e formatação de data para personalizar suas mensagens de notificação.

As mensagens de notificação utilizam a linguagem Liquid para inserir conteúdo dinâmico. Com ela, você pode exibir dados do cliente, do pedido e da loja automaticamente em cada mensagem enviada.

Inserindo variáveis

Você pode inserir variáveis de duas formas:

1. Pelo painel de variáveis — clique no botão { } no editor para ver todas as variáveis disponíveis organizadas por categoria. Basta clicar na variável desejada para inseri-la na mensagem.

2. Digitando manualmente — escreva a variável entre {{ }} diretamente no editor.

Painel de variáveis disponíveis para personalizar a mensagem

Variáveis disponíveis

Consumidor

Variável	Descrição	Exemplo
{{ customer.name }}	Nome do cliente	João Silva
{{ customer.phone }}	Telefone do cliente	(11) 99999-9999
{{ customer.ordersCountOnMerchant }}	Total de pedidos do cliente na loja	5

Loja

Variável	Descrição	Exemplo
{{ merchant.name }}	Nome da loja	Pizzaria Bella
{{ merchant.address }}	Endereço da loja	Rua das Flores, 123
{{ merchant.link }}	Link da loja	https://minhaloja.com

Pedido

Variável	Descrição	Exemplo
{{ order.displayId }}	Código do pedido	12345
{{ order.type }}	Tipo do pedido	DELIVERY ou TAKEOUT
{{ order.note }}	Observação do pedido	Sem cebola
{{ order.createdAt }}	Data e hora do pedido	2025-01-01T14:30:00
{{ order.estimatedDeliveryDateTime }}	Data e hora estimada de entrega	2025-01-01T15:00:00
{{ order.deliveryAddress }}	Endereço de entrega	Av. Brasil, 456
{{ order.deliveryFee }}	Valor da entrega	R$ 8,00
{{ order.paymentName }}	Forma de pagamento	PIX
{{ order.total }}	Valor total do pedido	R$ 58,00
{{ order.link }}	Link de acompanhamento do pedido	https://minhaloja.com/pedido/12345

Itens do Pedido

Estas variáveis devem ser usadas dentro de um loop {% for item in order.items %}:

Variável	Descrição	Exemplo
{{ item.name }}	Nome do produto	Pizza Margherita
{{ item.quantity }}	Quantidade	2
{{ item.total }}	Valor total do item	R$ 45,00
{{ item.note }}	Observação do item	Borda recheada

Variantes (modificadores)

Estas variáveis devem ser usadas dentro de um loop {% for variant in item.variants %}:

Variável	Descrição	Exemplo
{{ variant.name }}	Nome do modificador	Tamanho

Opções da Variante

Estas variáveis devem ser usadas dentro de um loop {% for variantItem in variant.variantItems %}:

Variável	Descrição	Exemplo
{{ variantItem.name }}	Nome da opção	Grande
{{ variantItem.quantity }}	Quantidade da opção	1

Controle de fluxo

Use tags de controle de fluxo para exibir conteúdo condicionalmente.

if / else

Executa um bloco de código somente se uma condição for verdadeira. Útil para diferenciar entre pedidos de entrega e retirada:

{% if order.type == "DELIVERY" -%}
Entrega em:
🏠 {{order.deliveryAddress}}
{%- else -%}
Retirada em:
🏠 {{merchant.address}}
{%- endif %}

Você também pode usar if para exibir informações opcionais:

{%- if order.note %}
Observação: {{order.note}}
{%- endif %}

Iteração (loops)

Use loops para listar os itens do pedido e seus modificadores.

for

Executa repetidamente um bloco de código para cada item de uma coleção:

{% for item in order.items %}
*Produto:* {{item.name}}
*Quantidade:* {{item.quantity}}
*Valor:* {{item.total}}
{%- for variant in item.variants %}
  *{{variant.name}}*
  {%- for variantItem in variant.variantItems %}
  *{{variantItem.quantity}}* {{variantItem.name}}
  {%- endfor %}
{%- endfor %}
{%- if item.note %}
*Observação:* {{item.note}}
{%- endif %}
{% endfor -%}

Use -%} ou {%- para remover espaços em branco extras antes ou depois das tags Liquid. Isso ajuda a manter a mensagem formatada corretamente no WhatsApp.

Formatação de data

Use o filtro date para converter datas em formatos legíveis:

{{ order.createdAt | date: "%d, %B de %Y %H:%M" }}

Resultado: 01, janeiro de 2025 14:30

Códigos de formatação mais usados

Código	Descrição	Exemplo
%d	Dia do mês (01-31)	01
%m	Mês numérico (01-12)	01
%B	Nome do mês por extenso	janeiro
%Y	Ano com 4 dígitos	2025
%H	Hora (00-23)	14
%M	Minuto (00-59)	30

As mensagens utilizam a linguagem Liquid. Para mais detalhes sobre a sintaxe completa, consulte a documentação oficial: https://shopify.github.io/liquid/