Você pode usar a sintaxe de variáveis de template do Wassenger para exibir informações dinâmicas nas suas mensagens com base em um conjunto de variáveis pré-definidas que estão vinculadas ao usuário atual que envia a mensagem, ou ao chat alvo, contato, metadata e data.
As variáveis de template podem ser usadas em respostas rápidas, respostas automáticas e mensagens enviadas através da API ou web chat.
🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso de API e automatize qualquer coisa no WhatsApp fazendo o registro para um teste gratuito e começando em minutos!
Você pode exibir informações dinâmicas em mensagens com base nas seguintes entidades:
whatsapp: número do WhatsApp conectado que está enviando a mensagemuser: usuário atual que está enviando a mensagemchat: chat alvo que receberá a mensagemcontact: contato alvo que receberá a mensagemdate: a data atual quando a mensagem for entregue
➡️ Aqui há mais informações sobre as variáveis específicas aceitas.
➡️ Encontre um exemplo real enviando variáveis de template usando a API
Como funciona
A sintaxe de variável de template pode ser usada em qualquer mensagem de texto com chaves duplas {{ para abrir e }} para fechar a expressão:
Dear {{ contact.name }},
We will be in touch shortly with more information.
Your query has been registered on {{ date.humanize.full }}.
Your support agent is {{ chat.agent.name }}.
Thank you!
A mensagem anterior com variáveis de template será enviada ao usuário assim:
Dear Michael,
We will be in touch shortly with more information.
Your query has been registered on Monday, August 26, 2024 11:01 AM.
Your support agent is Noah.
Thank you!
Usando um valor padrão
Dear {{ contact.name | customer }},
How can I help you today?
Caso a variável contact.name esteja vazia para o contato alvo, customer será usado como valor padrão. Portanto, a mensagem enviada ao usuário ficará assim:
Dear customer,
How can I help you today?
Você também pode encadear múltiplos valores padrão assim:
Dear {{ contact.name | contact.surname | customer }}
Nesse caso, se contact.name estiver vazio, o valor padrão será contact.surname. Então, se contact.surname estiver vazio, o valor padrão será customer.
🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso de API e automatize qualquer coisa no WhatsApp fazendo o registro para um teste gratuito e começando em minutos!
Variáveis suportadas
Aqui está a lista das variáveis suportadas na sintaxe de template:
Variáveis de campanha
Ao enviar mensagens a partir de uma Campanha, você pode usar as seguintes variáveis de template com base nos dados dos contatos importados via upload de arquivo CSV / Excel. Cada variável de template apontará para a coluna pré-selecionada importada no documento CSV / Excel.
Variáveis de template de campanha aceitas
🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso de API e automatize qualquer coisa no WhatsApp fazendo o registro para um teste gratuito e começando em minutos!
Exemplos
Variável de template simples
Dear {{ contact.name }},
How can I help you today?
Múltiplas variáveis de template
Dear {{ contact.name }},
We will send you more information to your email: {{ contact.email }}
If you need further information, you can call us: {{ whatsapp.number }}
Thank you!
Usar metadata do contato em variáveis de template
Hello {{ metadata.crm_name }}
We will send you an email to: {{ metadata.crm_email }}
Variável de template com um valor padrão
Dear {{ contact.name | customer }},
Thank you!
Variável de template com múltiplos valores padrão
Dear {{ contact.name | contact.surname | customer }},
Thanks for contacting us, we will answer your query shortly.
Thank you!
Exemplo de API ao vivo
Agora você pode brincar, depurar e testar a API ao vivo diretamente do seu navegador, explorar e experimentar mais exemplos de API e obter com um clique snippets de código prontos para uso disponíveis em 15+ linguagens de programação 😎
Experimente nosso testador de API ao vivo agora
🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso de API e automatize qualquer coisa no WhatsApp fazendo o registro para um teste gratuito e começando em minutos!
Perguntas (FAQ)
Onde posso usar variáveis de template?
Você pode usar variáveis de template em respostas rápidas, respostas automáticas e mensagens enviadas via API.
Posso enviar a metadata do contato nas variáveis de template?
Sim, pode! Basta usar a seguinte sintaxe:
Hello {{ metadata.crm_name }}
Onde crm_name representa a chave de metadata crm_name na metadata do contato.
Você pode criar ou atualizar a metadata do contato pelo web chat ou pela API.
Posso definir um valor padrão se o valor da variável estiver vazio?
Sim, você pode usar a seguinte sintaxe para definir um valor padrão:
Dear {{ contact.name | customer }}!
Nesse caso, assumindo que o contato alvo não tem nome definido, o valor exibido na mensagem enviada será customer. Exemplo:
Dear customer!
O que acontece se a variável estiver vazia e não houver valor padrão?
Nesse caso, a expressão da variável de template será removida da mensagem.
Por exemplo, dada a seguinte template de mensagem onde contact.name está vazio:
Hello {{ contact.name }},
We are happy to have you onboard!
A mensagem resultante será enviada assim:
Hello,
We are happy to have you onboard!
No entanto, em casos como este pode ser melhor usar a sintaxe de valor padrão:
Hello {{ contact.name | there }},
We are happy to have you onboard!
Assim será enviada ao usuário:
Hello there,
We are happy to have you onboard!
Posso usar múltiplos valores padrão possíveis?
Sim! Você pode encadear múltiplas expressões de valor padrão.
Caso você queira substituir um valor por múltiplos valores padrão alternativos, pode usar a seguinte sintaxe:
Dear {{ contact.name | contact.surname | contact.phone | customer }}
Nesse caso, se contact.name estiver vazio, ele usará contact.surname como padrão. Depois, se contact.surname estiver vazio, usará contact.phone. Finalmente, se contact.phone estiver vazio, usará customer, uma string bruta.
