Como utilizar variáveis de template?

A

Antonio Milesi

Última atualização em Jul 10, 2026

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.

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" }}.