Principal 🔍Recursos Avançados Como usar variáveis de modelo (template variables)

Como usar variáveis de modelo (template variables)

Última atualização em Apr 10, 2025

As variáveis de modelo permitem personalizar suas mensagens com conteúdos dinâmicos, adaptados a cada contato. Elas são úteis para incluir automaticamente dados como nome do cliente, número de telefone, ID da conversa, entre outros.


Exemplo de uso

Se você enviar a mensagem:

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

E o nome do contato for João, a mensagem enviada será:

Olá João, como posso te ajudar?

Essas variáveis podem ser utilizadas em:

  • Mensagens manuais

  • Respostas prontas (canned responses)

  • Macros

  • Regras de automação


Como inserir variáveis em mensagens

Ao redigir uma mensagem, digite {{ (duas chaves) e o exibirá a lista de variáveis disponíveis. Basta selecionar a que deseja.


Variáveis disponíveis

🔹 Conversa

  • conversation.id → ID numérico da conversa

🔹 Contato

  • contact.id

  • contact.name

  • contact.first_name

  • contact.last_name

  • contact.phone_number

🔹 Agente

  • agent.name

  • agent.first_name

  • agent.last_name

  • agent.phone_number


O que acontece se a variável não existir?

Se você tentar usar uma variável inexistente ou mal escrita, exibirá um aviso de erro, impedindo que a mensagem seja enviada incorretamente.


Como adicionar texto alternativo (fallback)

Caso a variável definida não possa ser preenchida (ex: o contato não tem nome registrado), você pode usar um texto alternativo (fallback).

Exemplo:

Olá {{ contact.first_name || 'cliente' }}, como posso te ajudar?

Se o contact.first_name não estiver disponível, a mensagem enviada será:

Olá cliente, como posso te ajudar?

✅ Use aspas simples para definir o fallback: 'texto alternativo'