Como usar variáveis de template?

Última atualização em May 21, 2026

As variáveis de template permitem personalizar mensagens automaticamente utilizando informações dinâmicas do contato, agente ou conversa.

Com elas, você pode inserir:

  • Nome do cliente

  • Número da conversa

  • Telefone

  • Nome do agente

  • E muito mais

Isso funciona em:

  • Mensagens

  • Respostas rápidas (Canned Responses)

  • Macros

  • Automações


Exemplo básico

Se você enviar:

Olá {{ contact.name }}, como posso ajudar?

O Wootdesk substituirá automaticamente pela informação do contato:

Olá João, como posso ajudar?

Como inserir variáveis?

Ao escrever uma mensagem, digite:

{{

O sistema exibirá automaticamente a lista de variáveis disponíveis.

Basta selecionar a desejada.


Variáveis disponíveis

Conversa

{{ conversation.id }}

ID numérico da conversa.


Contato

{{ contact.id }}

ID do contato.

{{ contact.name }}

Nome completo do contato.

{{ contact.first_name }}

Primeiro nome.

{{ contact.last_name }}

Sobrenome.

{{ contact.phone_number }}

Telefone do contato.


Agente

{{ agent.name }}

Nome completo do agente.

{{ agent.first_name }}

Primeiro nome do agente.

{{ agent.last_name }}

Sobrenome do agente.

{{ agent.phone_number }}

Telefone do agente.


Exemplo completo

Olá {{ contact.first_name }},

Meu nome é {{ agent.first_name }} e vou cuidar do seu atendimento.

Seu protocolo é #{{ conversation.id }}.

Resultado:

Olá João,

Meu nome é Carlos e vou cuidar do seu atendimento.

Seu protocolo é #1548.

Texto de fallback (valor padrão)

Você também pode definir um texto alternativo caso a variável não exista.

Exemplo:

Olá {{ contact.first_name || 'cliente' }}

Se o contato não tiver primeiro nome cadastrado:

Olá cliente

Importante sobre fallback

O texto padrão deve estar entre aspas simples:

✅ Correto:

{{ contact.first_name || 'cliente' }}

❌ Incorreto:

{{ contact.first_name || cliente }}

O que acontece se usar uma variável inválida?

Se você utilizar uma variável inexistente, o Wootdesk exibirá um aviso informando que a variável não é válida.

Exemplo:

{{ contact.plan }}

Caso essa variável não exista, o sistema alertará antes do envio.


Onde usar variáveis?

As variáveis funcionam em:

  • Mensagens manuais

  • Respostas rápidas

  • Macros

  • Automação

  • Bots

  • Campanhas

  • API

  • WhatsApp

  • E-mail

  • Widget do site


Boas práticas

  • Sempre utilize fallback em campos importantes

  • Evite mensagens muito robóticas

  • Use personalização para melhorar conversão e atendimento

  • Teste as variáveis antes de publicar automações

  • Utilize primeiro nome para mensagens mais naturais