Variáveis do bot: Personalize as mensagens do seu bot

Com as variáveis, o seu bot envia mensagens personalizadas para cada cliente. Nome, endereço, horário de atendimento, status do pedido e muito mais são preenchidos automaticamente, na hora da conversa. Isso deixa o atendimento mais próximo e evita que você precise escrever uma mensagem diferente para cada pessoa.
​

Variáveis são "espaços reservados" que você insere nos textos do bot. Quando a mensagem é enviada, a OmniChat substitui a variável pelo dado real daquele atendimento.
​

Por exemplo, se você escrever:

A cliente Maria vai receber:

As variáveis não servem apenas para os textos das mensagens. Elas funcionam em vários pontos da construção do bot:

Atenção: nas mensagens enviadas ao cliente, os dados sensíveis (e-mail, CPF e CNPJ) aparecem mascarados.

Esse mascaramento no Bot é automático e obrigatório, diferente da configuração de Privacidade de Dados da loja, que pode ou não mascarar dados conforme o que for definido lá. Ou seja, mesmo que a loja esteja configurada para não mascarar, dentro do Bot o dado sensível aparece mascarado do mesmo jeito. Já nas integrações de API o valor é enviado completo, sem máscara, para que o sistema externo receba o dado real.

Prefira sempre usar as sugestões do editor em vez de digitar a variável manualmente. Assim você garante que o nome está exatamente correto. Se a variável estiver escrita errado, ela não será substituída.

As variáveis são sensíveis a maiúsculas e minúsculas.

Escrever @consumidor.nome (com c minúsculo) não é reconhecido pelo bot, só @Consumidor.nome funciona.

A variável correta fica destacada em azul no editor; se aparecer em branco, foi digitada errado. Esse é o motivo mais comum de "a variável não substituiu", então vale reforçar isso na seção de Problemas Comuns.

Informações do cadastro do cliente que está conversando com o bot.

Dados sensíveis: por segurança, e-mail, CPF e CNPJ aparecem mascarados nas mensagens enviadas ao cliente. Por exemplo: ma***@email.com.

Exemplo:

Resultado:

Os dias disponíveis são: segundaFeira, tercaFeira, quartaFeira, quintaFeira, sextaFeira, sabado e domingo.

Exemplo:

Resultado:

Ao usar horários de abertura e fechamento, aplique sempre a formatação #ApenasHorario ou #ApenasHorarioComMinutos para exibir apenas a hora, e não a data completa.
​

Dados da loja física associada ao cliente em atendimento.

Exemplo:

Resultado:

A variável @Chat.ultimaMensagemObjeto só aparece e funciona nas configurações de integrações de API (URL, cabeçalhos, parâmetros e corpo da requisição). Ela não é substituída em mensagens enviadas ao cliente. Use-a quando o sistema externo precisar receber a última mensagem completa, incluindo anexos.

Formato de saída de @Chat.ultimaMensagemObjeto:

Exemplo, corpo da requisição configurado na integração:

O sistema externo recebe:

Interface do objeto:

Repare que o valor é injetado como JSON de verdade (objeto), e não como texto. A OmniChat ajusta as aspas automaticamente para que o JSON final continue válido.

Exemplo:

Exemplo:

Resultado:

Consulta os dados de um time específico da sua operação. Ao digitar @Time., o editor lista os seus times. Escolha o time e depois o dado desejado.

Exemplo:

Resultado:

Insere os valores de uma lista cadastrada na OmniChat como uma lista numerada, pronta para o cliente escolher uma opção.

Exemplo, lista "sabores" com os valores Calabresa, Mussarela e Portuguesa:

Resultado:

Busca um dado em tempo real em um sistema externo, usando uma integração de API do tipo "Dados específicos" configurada na plataforma. Ao digitar @API., o editor lista as suas integrações. Depois, escolha o campo da resposta que deseja exibir.

Exemplo:

Resultado:

Recupera valores que o bot guardou durante a conversa. Por exemplo, com a ação de guardar a resposta do cliente.

As formatações ajustam a aparência do valor. Elas são adicionadas com # logo após a variável. O editor sugere as formatações disponíveis para cada dado.

Tudo o que vier após o + é colado imediatamente após o valor, sem espaço. É útil para completar horários e unidades.

Exemplo:

Resultado:

A variável apareceu do jeito que eu escrevi, sem trocar pelo dado do cliente?
Isso costuma acontecer quando a variável foi digitada manualmente e tem algum erro de escrita, incluindo diferença de maiúsculas/minúsculas. Apague o trecho e digite @ novamente, escolhendo a variável pela lista de sugestões do editor.

A variável ficou em branco na mensagem enviada?
Nesse caso, o cliente provavelmente não tem aquele dado preenchido no cadastro (por exemplo, data de nascimento ou CEP). Revise o fluxo para garantir que a mensagem continue fazendo sentido mesmo quando o dado vier vazio.