Ir para o conteúdo

Customizações avançadas

Temos um poderoso motor de personalização das mensagens enviadas! Ou seja, além de variáveis, é possível ter estruturas de repetição e desvio de fluxos.

Como funcionam as variáveis

Aviso

Cada integração possuí variáveis diferentes. Então, sempre veja a lista de variáveis disponíveis em cada notificação.

Onde vejo as variáveis

As variáveis estão disponíveis em uma lista em cada notificação. Tenha bastante atenção! Afinal, cada notificação e cada plataforma tem variações diferentes.

Como posso utilizar as variáveis?

Usar as variáveis é bem simples, dá uma olhada!

Vamos supor que você esteja utilizando o evento de boleto impresso. Normalmente, temos:

  • billet.url;
  • customer.first_name.

Veja que temos 2 variáveis em sequência e cada uma com objetivos diferentes: url do boleto e primeiro nome do cliente.

Para exibir a variável na mensagem enviada, basta utilizar {{ customer.first_name }}. É desse jeito mesmo, com 2 chaves abrindo e 2 fechando a variável.

Separamos em dois casos, váriaveis das notificações e links normais, como o seu site por exemplo.

O seu link ficou como se fosse um texto normal?

Por limitação do próprio WhatsApp, o link só ficará clicável em duas situações: a pessoa tem o seu contato adicionado ou se ela já te respondeu.

Para exibir links é um pouco diferente. Assim, é necessário escrever deste jeito: {{& billet.url }}.

Então, será preciso adicionar o & para URL que você queira enviar, ok?

O uso do {{& billet.url }} como mencionado no tópico acima é somente para variáveis, caso você deseje adicionar um link para sua loja por exemplo, basta escrever ele normalmente, como se fosse um texto comum.

Como usar o "ver meus boletos"?

Para saber mais sobre o ver meus boletos acesse esse manual

Para utilizar o ver meus boletos, basta colocar na sua notificação a variável: {{& billet.shorten_url}}.

Pronto, agora basta o cliente abrir esse url e já vai ser redirecionado para o ver meus boletos.

Como eu consigo deixar o nome do meu cliente mais "humanizado"?

Você olhou as mensagens disparadas e viu que estamos enviando um texto mais ou menos assim: Oi ANA CLARA, tudo bem?

O nome em caixa alta pode ficar um pouco fora dos padrões de uma linguagem mais humanizada, certo?

Para resolver essa questão, temos disponíveis alguns meio de deixar a frase ou palavra com uma escrita mais personalizadas.

Primeiro, você precisa escrever ela assim: {{# ucfirst}}{{ customer.first_name }}{{/ ucfirst}}.

Complicado? Calma, vamos explicar: para exibir o primeiro nome é necessário utilizar {{ customer.first_name }}.

Agora que vem a parte interessante! Para exibir apenas o Ana com a primeira letra em caixa alta, você precisa utilizar uma função auxiliar, que neste caso é ucfirst.

Então, funções auxiliares devem ser escritas assim: {{# funcao }}ANA CLARA{{/ funcao}}.

Observe que não precisa de espaço no nome.

Além disso, a personalização precisa ser aberta usando # e fechada usando /.

Em resumo, para deixar a escrita mais humanizada, você pode ficar de olho nessas regras de configuração:

  • Primeiro nome: {{ customer.fisrt_name }};
  • Caixa alta da primeira letra da palavra: ucfirst;
  • Abrir função: #;
  • Fechar função: /;
  • Funções auxialiares: {{# funcao }}CONTEÚDOTEXTUAL{{/ funcao}}.

Funções auxiliares disponíveis

Temos algumas funções extras que podem ser bastante úteis para seus envios. Confira:

  • ucfirst: Transforma FRASE GIGANTE AQUI em Frase;
  • currency_br: Usada para escrever valores usando o formato brasileiro, por exemplo: 100.000,00;
  • date_br: Formata as datas em formato brasileiro, por exemplo: 01/01/2020.

Estruturas de repetição

Estruturas de repetição são úteis caso você trablhe com e-commerce (ou mais de um produto). O resultado final delas é basicamente este:

1x - Vara de pescar
2x - Minhoca

Ou seja, você pode pegar uma lista de products e escrever item por item, como demonstra o exemoplo abaixo:

*Itens do seu pedido:*
{{# products }}
- {{ quantity }}x {{ name }}
{{/ products}}

Veja que para iniciar uma estrutura de repetição, utilizamos #. Para fechá-la, utilizamos /.

Caso trabalhe com infoprodutos, recomendamos que você escreva o nome do produto direto, como, por exemplo:

Vimos que você tem interesse no *{{ products.0.name }}* e talvez você tenha ficado com alguma dúvida para concluir sua compra.

Desvios de fluxos

Algumas integrações não possuem certas informações ou o método de entrega não possui uma URL para rastreio, entre outras situações.

Neste caso, você pode utilizar os desvios de fluxo para garantir que um texto em branco não será exibido, como no exemplo:

Olá Pedro!

Acabamos de despachar o seu pedido, o código de rastreio dele é: BR123123123BR.

Você também pode monitorar na URL: 

Viu que a URL está em branco? Isto poderia ser evitado da seguinte maneira:

Olá Pedro!

Acabamos de despachar o seu pedido, o código de rastreio dele é: {{ shipping.code }}.
{{# shipping.url }}

Você também pode monitorar na URL: {{ shipping.url }}
{{/ shipping.url }} 

Fazendo isto, vamos garantir que somente o texto dentro do bloco seja exibido caso exista alguma informação dentro da variável.


Última atualização: 23 de fevereiro de 2021 12:56:37