> For the complete documentation index, see [llms.txt](https://delivery.ajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://delivery.ajuda.cc/geral/deliverybot/notificacao-de-pedidos/modo-avancado-das-mensagens-de-notificacao.md).

# Modo avançado das 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.

<figure><img src="/files/eaFOKthDcBJSa3eyPnhY" alt=""><figcaption><p>Painel de variáveis disponíveis para personalizar a mensagem</p></figcaption></figure>

## 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 -%}
```

{% hint style="info" %}
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.
{% endhint %}

## 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      |

{% hint style="info" %}
As mensagens utilizam a linguagem Liquid. Para mais detalhes sobre a sintaxe completa, consulte a documentação oficial: <https://shopify.github.io/liquid/>
{% endhint %}