Como usar variáveis de modelo?

Pranav

Pranav

Última atualização em Jun 3, 2026

Com variáveis de template, você pode personalizar suas mensagens inserindo conteúdo dinâmico adaptado para cada destinatário. Ao adicionar placeholders em suas mensagens, você pode facilmente customizar suas comunicações com informações como o nome do cliente, número do pedido ou outros detalhes.

Por exemplo, se você enviar uma mensagem Oi {{ contact.name }}, como posso te ajudar?, o Chatwoot vai pegar o nome do contato e enviar uma mensagem como Oi João, como posso te ajudar?.

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

Criando variáveis de template

Para usar uma variável, digite dois colchetes duplos {{ ao compor uma nova mensagem ou criar uma resposta pronta. As variáveis disponíveis aparecerão, e você pode selecionar aquela que deseja usar.

As variáveis de template disponíveis são:

  • conversation.id

    ~ Para a versão numérica do ID da conversa.

  • contact.id

    ~ Para a versão numérica do ID do contato.

  • contact.name

    ~ Para o nome completo do contato.

  • contact.first_name

  • contact.last_name

  • contact.phone_number

  • agent.name

  • agent.first_name

  • agent.last_name

  • agent.phone_number

E se eu enviar uma variável inexistente?

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

Como adicionar um texto alternativo (fallback)?

Se uma variável definida não puder ser preenchida pelo sistema, um texto alternativo pode ser usado para substituir o valor pretendido. Por exemplo, se a variável contact.first_name não puder ser preenchida, um texto alternativo adequado poderia ser 'aí'.

Ao definir um texto alternativo, certifique-se de envolvê-lo com aspas simples. Veja um exemplo: {{ contact.first_name || 'aí'}}.