Início Funcionalidades Avançadas Como usar variáveis de template

Como usar variáveis de template

Última atualização em Apr 18, 2025

As variáveis de template permitem personalizar suas mensagens com base em informações dinâmicas de cada cliente. Ao inserir placeholders nos seus textos, você pode adaptar o conteúdo automaticamente com dados como nome do contato, número do pedido, entre outros.

Por exemplo, ao enviar a mensagem:

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

A plataforma substituirá automaticamente a variável pelo nome do contato. Assim, se 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, respostas rápidas (canned responses), macros e regras de automação.

Como criar e utilizar variáveis

Para adicionar uma variável, digite duas chaves duplas {{ ao compor uma mensagem ou configurar uma resposta rápida. Um menu será exibido com as opções disponíveis. Basta selecionar a variável desejada.

Variáveis disponíveis

Você pode utilizar as seguintes variáveis:

  • conversation.id – ID numérico da conversa

  • contact.id – ID numérico do contato

  • contact.name – Nome completo do contato

  • contact.first_name – Primeiro nome do contato

  • contact.last_name – Sobrenome do contato

  • contact.phone_number – Telefone do contato

  • agent.name – Nome completo da atendente

  • agent.first_name – Primeiro nome da atendente

  • agent.last_name – Sobrenome da atendente

  • agent.phone_number – Telefone da atendente

O que acontece se eu usar uma variável inexistente?

Caso você utilize uma variável que não está disponível, a Akece exibirá um aviso informando que a variável é inválida e não será aplicada na mensagem.

Como adicionar um texto alternativo (fallback)?

Se uma variável válida não puder ser preenchida com um valor, você pode definir um texto alternativo para substituir a informação ausente.

Por exemplo:

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

Se o primeiro nome do contato estiver disponível, será exibido normalmente. Caso contrário, a mensagem utilizará "cliente" como alternativa.

Importante: o texto alternativo deve estar entre aspas simples.


Se precisar de ajuda para configurar ou utilizar variáveis de template, fale com a nossa equipe:
📩 [email protected] | 📱 @akece.ai