![Os grupos de variáveis de template — do contato, do agente e da conversa — e o texto de fallback para quando uma variável não pode ser preenchida.](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcmtRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--948ca89fdb45cec74866ea925adffa8f1cd93cad/1729186366-como-utilizar-variaveis-de-template.png)

Com as variáveis de template, você pode personalizar suas mensagens inserindo conteúdo dinâmico adaptado para cada destinatário. Ao adicionar marcadores (placeholders) nas suas mensagens, é possível customizar as comunicações com informações como o nome do contato, o número do pedido, entre outros detalhes.

Por exemplo, se você enviar uma mensagem com `Olá {{ contact.name }}, como posso ajudar?`, o Chatwoot substituirá o marcador pelo nome do contato e enviará algo como `Olá João, como posso ajudar?`.

Você também pode utilizar variáveis em **respostas prontas**, **macros** e **automações**.

### Criando variáveis de template

Para usar uma variável, basta digitar chaves duplas `{{` ao compor uma nova mensagem ou ao criar uma resposta pronta. As variáveis disponíveis aparecerão em uma lista, e você pode selecionar a que deseja utilizar.

As variáveis mais úteis são:

* `{{ conversation.id }}` — o ID numérico da conversa.
* `{{ contact.id }}` — o ID numérico do contato.
* `{{ contact.name }}` — o nome completo do contato.
* `{{ contact.first_name }}` — o primeiro nome do contato.
* `{{ contact.last_name }}` — o sobrenome do contato.
* `{{ contact.email }}` — o e-mail do contato.
* `{{ contact.phone_number }}` — o número de telefone do contato.
* `{{ contact.custom_attribute.nome_da_chave }}` — um atributo personalizado do contato.
* `{{ agent.id }}` — o ID numérico do agente.
* `{{ agent.name }}` — o nome completo do agente.
* `{{ agent.first_name }}` — o primeiro nome do agente.
* `{{ agent.last_name }}` — o sobrenome do agente.
* `{{ agent.email }}` — o e-mail do agente.
* `{{ conversation.display_id }}` — o número da conversa exibido no painel.
* `{{ conversation.custom_attribute.nome_da_chave }}` — um atributo personalizado da conversa.
* `{{ inbox.id }}` e `{{ inbox.name }}` — o ID e o nome da caixa de entrada.
* `{{ account.id }}` e `{{ account.name }}` — o ID e o nome da conta.

### O que acontece se eu enviar uma variável inexistente?

Se você tentar enviar uma variável indefinida, o Chatwoot exibirá um aviso.

**Como adicionar um texto de fallback?**

Se uma variável definida não puder ser preenchida pelo sistema, é possível usar um texto de fallback para substituí-la. Por exemplo, se a variável `contact.first_name` não puder ser preenchida, um texto de fallback adequado poderia ser "amigo".

Use o filtro `default` do Liquid e coloque o texto entre aspas. Exemplo: `{{ contact.first_name | default: "amigo" }}`.