1. Support
  2. Zap2Go
  3. Dicas
  4. Como formatar mensagens
Updated: 11 January 2023

Como formatar mensagens

O ZAp2Go oferece um conjunto vasto de possibilidades para formatar mensagens de texto de acordo com o necessário.

E esta formatação pode ser enriquecida com dados que seu mailing ou ativo (API) podem disponibilizar.

É possível também consultar dados via API e Banco de Dados (integrações externas), que podem melhorar a precisão das informações com as quais sua mensagem será enviada, garantindo melhor experiência do seu contato.

"Formatar mensagens" é o processo de substituir textos "coringas" por dados que podem melhorar a experiência do usuário.

Os textos coringa podem ter os seguintes formatos:

  • [xxxx] = uma palavra com um colchete de formatação. A seguir, estão detalhadas as trocas padrão, que usam este formato (veja as Trocas Padrão abaixo].

  • {$.xxxx} = uma variável para substituição. Esta variável deve ser fornecida no mailing, no ativo via API ou através de integração externa. Esta formação pode conter:

{$.xxxxx} = substituição simples do valor de "xxxx" nas variáveis.
{$.xxxxx:dd/MM} = substituição do valor com uma formatação adicional. Isso pode ser usado para:
   - data/hora com formato C# padrão.
   - data/hora com formato relativo (ex: "amanhã", "ontem", "hoje", "à tarde", "à noite", etc)
   - valor, percentual, etc.
   - nomes e mesmo formatações customizadas.  
{$.xxxxx:date:es} = substituição com formatação e com conversão de língua (por exemplo es = Español, en = English).


Trocas padrão:

As opções abaixo podem ser utilizadas:

[PrimeiroNome] O primeiro nome do cliente (obido pela carga ou diretamente do contato do WhatsApp)
[nomeCompletoCliente]
[NomeCliente] ou [nomeCliente] O mesmo que [PrimeiroNome].
[cpfCliente] CPF ou CNPJ do cliente, obtido na carga.
[telefoneCliente] Telefone do cliente, obtido na carga.
[BomDia] Retorna bom dia, boa tarde, boa noite - de acordo com o horário do envio
[Carteira] Retorna a identificação da carteira conforme configurado.
[CarteiraCompleta] O mesmo que [Carteira]
[CarteiraFirstPerson] Retorna uma mensagem já formatada de "Aqui falo da [Carteira]."


Formatação de variáveis:

As variáveis que podem ser usadas são as que foram previamente incluídas:

  • Pelo Mailing: veja como adicionar variáveis no Mailing AQUI

  • Pelo Ativo, enviando via API: veja como adicionar as variáveis no Ativo AQUI.

  • Por Integração Externa: se sua carteira utiliza automação, pode haver acesso a APIs externas, base de dados etc.


As variáveis são pares de:

  • Chave - valor = são os que são recebidos em colunas adicionais do mailing, ou nos demais métodos. Um exemplo deste caso é: 

    Seu mailing contém duas colunas adicionais:

DATA_CONSULTA, MEDICO_CONSULTA.

Suma mensagem então pode conter: 

 " ... Você tem agendada uma consulta no dia {DATA_CONSULTA:dd/MM} com o Dr. {MEDICO_CONSULTA} ...".  


  • Chave - objeto - valor = são estruturas armazenadas em formato JSON, que permitem serem acessados por JPATH. Esses dados podem ser enviados por API ou integração externa. Um exemplo deste caso é:

    Sua chamada de API inclui variáveis 

    {   "DIVIDA" : {  "valor": 189.32, "VENCIMENTO" : "2022-03-01" } }

    Sua mensagem poderia conter:
    " ... Há uma dívida em aberto com valor de {$.valor:#,##0.00}, com vencimento em {$.VENCIMENTO:dd/MM/yyyy} ..."


Para esclarecimento de outras dúvidas quanto ao uso de variáveis.

Entre em contato com o GUGA - Suporte