> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.konfidency.cx/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# E-mail de solicitação de avaliação - Variáveis disponíveis

O sistema de e-mail usa a sintaxe **Mustache** para interpolação de variáveis. Para inserir uma variável, use a notação `{{payload.nomeDaVariavel}}`.

---

## Variáveis simples

Estas variáveis podem ser usadas diretamente em qualquer parte do template (assunto, corpo HTML, texto simples).

| Variável | Descrição | Exemplo |
| ---- |
| `{{payload.name}}` | Nome completo do cliente | `João Silva` |
| `{{payload.firstName}}` | Primeiro nome do cliente | `João` |
| `{{payload.email}}` | E-mail do destinatário | `joao@email.com` |
| `{{payload.orderId}}` | ID do pedido | `#123456` |
| `{{payload.product}}` | Nome do produto principal. Se houver mais de um produto no pedido, exibe o nome do primeiro + quantidade dos demais (ex: "Tênis mais 2 produto(s)") | `Tênis Esportivo` |
| `{{payload.sku}}` | SKU do primeiro produto do pedido | `TEN-42-PRETO` |
| `{{payload.productImage}}` | URL da imagem do primeiro produto | `https://...` |
| `{{payload.productCount}}` | Número total de produtos no pedido | `3` |
| `{{payload.productCountMinus5}}` | Quantidade de produtos além dos 5 primeiros exibidos (útil para o texto "e mais N produtos") | `2` |
| `{{payload.rateLink}}` | Link completo para o cliente avaliar os produtos do pedido | `https://www.kfy.app/rate/...` |
| `{{payload.unsubscribeLink}}` | Link de descadastramento do cliente | `https://www.kfy.app/unsubscribe/...` |

---

## Categorias do produto (variáveis dinâmicas)

Se os produtos possuem categorias estruturadas cadastradas no formato `NomeCategoria:[Valor]`, elas são extraídas automaticamente e disponibilizadas como variáveis a partir do **primeiro produto** do pedido.

**Formato gerado:** `{{payload.categoryNomeCategoria}}`

**Exemplos:**

| Categoria cadastrada | Variável gerada | Valor |
| ---- |
| `Origem:[São Paulo]` | `{{payload.categoryOrigem}}` | `São Paulo` |
| `Cor:[Azul]` | `{{payload.categoryCor}}` | `Azul` |
| `Tamanho:[M]` | `{{payload.categoryTamanho}}` | `M` |

> **Atenção:** Acentos e caracteres especiais são removidos do nome da variável. Ex: `Gênero` vira `categoryGenero`.

---

## Lista de produtos — `{{#payload.first5Products}}`

Usado para exibir os produtos do pedido em um bloco repetido (cards, tabela, etc.). Contém até **5 produtos**.

**Sintaxe:**

```handlebars
{{#payload.first5Products}}
  {{name}}
  {{image}}
  {{sku}}
  {{rateLink}}
{{/payload.first5Products}}
```

> Dentro do bloco `{{#payload.first5Products}}`, as variáveis internas **não** levam o prefixo `payload.` — o Mustache entra automaticamente no contexto do objeto do item atual.

### Variáveis disponíveis dentro do bloco

| Variável | Descrição |
| ---- |
| `{{name}}` | Nome do produto |
| `{{image}}` | URL da imagem do produto |
| `{{sku}}` | SKU do produto |
| `{{rateLink}}` | Link de avaliação específico para este produto |
| `{{verificationToken}}` | Token de verificação único deste produto |
| `{{order}}` | ID do pedido ao qual o produto pertence |
| `{{categoryNomeCategoria}}` | Categorias estruturadas do produto (mesma lógica das variáveis raiz) |

> Para exibir **todos os produtos** sem limite, use `{{#payload.products}}...{{/payload.products}}` com as mesmas variáveis internas.

---

## Lógica condicional

O Mustache exibe um bloco apenas se o valor existir e não for vazio/falso:

```handlebars
{{#payload.productCountMinus5}}
  e mais {{payload.productCountMinus5}} produto(s)
{{/payload.productCountMinus5}}
```

---

## Exemplo de uso combinado

```handlebars
Olá, {{payload.firstName}}!

Seu pedido {{payload.orderId}} está pronto para ser avaliado.

{{#payload.first5Products}}
  - {{name}} → {{rateLink}}
{{/payload.first5Products}}

{{#payload.productCountMinus5}}
  ...e mais {{payload.productCountMinus5}} produto(s).
{{/payload.productCountMinus5}}

Não quer mais receber e-mails? Descadastre-se aqui: {{payload.unsubscribeLink}}
```