> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blubash.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Usar variáveis em templates de mensagem do WhatsApp

> Entenda como funcionam as variáveis dinâmicas nos templates e respostas rápidas do BluBash, com exemplos práticos e boas práticas de personalização.

Variáveis são espaços reservados dinâmicos que permitem personalizar templates e respostas rápidas com informações específicas de cada contato. Em vez de enviar uma mensagem genérica, você pode inserir automaticamente nomes, números de pedido, datas e outros detalhes.

## Como as variáveis funcionam

As variáveis usam um formato numerado entre chaves duplas:

* `{{1}}` — primeira variável
* `{{2}}` — segunda variável
* `{{3}}` — terceira variável
* E assim por diante, até `{{10}}`

Ao enviar uma mensagem, você preenche cada variável com o valor apropriado para aquele contato. O BluBash pode sugerir valores automaticamente com base nos dados do contato.

## Onde você pode usar variáveis

| Local                  | Variáveis suportadas           |
| ---------------------- | ------------------------------ |
| **Cabeçalho de texto** | Máximo de 1 variável (`{{1}}`) |
| **Corpo da mensagem**  | Até 10 variáveis               |
| **Rodapé**             | Não suportado                  |

## Exemplos práticos

### Exemplo 1: retomar uma conversa

**Template:**

```
Olá {{1}}, tudo bem?

Vi que não terminamos nossa conversa sobre {{2}}.
Gostaria de continuar agora?
```

**Valores preenchidos:**

* `{{1}}` = "Maria" (nome do contato)
* `{{2}}` = "Plano Premium" (assunto)

**Mensagem enviada:**

```
Olá Maria, tudo bem?

Vi que não terminamos nossa conversa sobre Plano Premium.
Gostaria de continuar agora?
```

### Exemplo 2: confirmação de pedido

**Template:**

```
{{1}}, seu pedido foi confirmado!

Pedido: #{{2}}
Total: {{3}}
Entrega estimada: {{4}}
```

**Variáveis:**

* `{{1}}` = Nome do contato
* `{{2}}` = Número do pedido
* `{{3}}` = Valor total
* `{{4}}` = Data de entrega

## Sugestões automáticas de valores

Ao enviar um template, o BluBash sugere valores para cada variável com base em:

* **Dados do contato** — nome, e-mail, número de telefone, empresa
* **Dados do agente** — seu nome
* **Campos personalizados** — quaisquer campos personalizados configurados para o contato
* **Data e hora atuais** — a data e a hora do envio

Você pode aceitar as sugestões ou editá-las manualmente antes do envio.

## Boas práticas

<Steps>
  <Step title="Use uma ordem lógica">
    Atribua variáveis em uma ordem consistente entre seus templates para reduzir confusão:

    * `{{1}}` = Nome do contato
    * `{{2}}` = Nome do agente
    * `{{3}}` = Nome da empresa
  </Step>

  <Step title="Forneça exemplos claros">
    Ao configurar variáveis, adicione valores de exemplo realistas. Isso ajuda na aprovação da Meta e facilita o preenchimento correto pela sua equipe.
  </Step>

  <Step title="Mantenha simples">
    Use apenas o número de variáveis que você realmente precisa. Recomenda-se de 2 a 4 variáveis; evite criar templates com muitas variáveis desnecessariamente.
  </Step>

  <Step title="Sempre revise antes de enviar">
    Verifique se todos os valores estão corretos e revise a pré-visualização da mensagem antes de confirmar o envio.
  </Step>
</Steps>

## Regras importantes

* Todas as variáveis em um template são **obrigatórias** — você não pode deixar nenhuma em branco
* As variáveis precisam seguir o formato `{{número}}` exatamente
* Cabeçalhos de texto suportam no máximo **1 variável**
* O corpo da mensagem suporta no máximo **10 variáveis**
* Os números das variáveis devem ser **sequenciais** — não pule números (por exemplo, não use `{{1}}` e `{{3}}` sem `{{2}}`)
