Uma variável é um espaço reservado, escrito entre chaves duplas, como {{firstName}}, que o sistema troca pelo valor real na hora de enviar a mensagem. Assim, o mesmo texto serve para todos os clientes: Olá, {{firstName}}! vira Olá, Maria! para uma pessoa e Olá, João! para outra. Este artigo mostra todas as variáveis do Construtor de Fluxo, de onde vêm e como criar as suas.
Onde encontrar (caminho até a tela):
- Lista de variáveis: Automações › Construtor de fluxo › (abrir o fluxo) › (qualquer bloco com mensagem) › Variáveis disponíveis
As regras de ouro
- Escreva sempre com chaves duplas:
{{name}}. Chaves simples, como{name}, não funcionam e o texto é enviado do jeito que foi escrito. - As variáveis diferenciam maiúsculas de minúsculas:
{{minhaVar}}e{{minhavar}}são variáveis diferentes. - Uma variável que não existe (ou nome digitado errado) é trocada por um texto vazio. Confira a grafia com cuidado.
- Nos campos de mensagem, os botões e a caixa Variáveis disponíveis mostram o que dá para usar e inserem o nome certo no ponto do cursor.
Variáveis prontas do sistema
| Variável | O que vira |
|---|---|
{{name}} | Nome completo do contato |
{{firstName}} | Primeiro nome do contato |
{{number}} | Número do contato, por exemplo 5511999998888 |
{{userName}} | Nome do atendente (dono do ticket) |
{{queue}} | Nome da fila (departamento) |
{{connection}} | Nome da conexão WhatsApp |
{{ticket_id}} | Número do ticket |
{{protocol}} | Protocolo do ticket |
{{name_company}} | Nome da empresa |
{{date}} | Data de hoje (dia-mês-ano) |
{{hour}} | Hora atual |
{{data_hora}} | Data e hora juntas |
{{ms}} | Saudação: Bom dia (6h às 12h), Boa tarde (12h às 18h), Boa noite (18h às 24h) ou Boa madrugada |
A data e a hora seguem o horário de Brasília. As variáveis do atendente e da fila ficam vazias enquanto a conversa ainda não tem atendente ou fila.
Variáveis do agente de IA
{{resumoIA}}: o resumo do atendimento feito pelo agente de IA do fluxo. Veja Agentes de IA: o que são e o que podem fazer.{{valorIA}}: o total confirmado pelo agente, sem o símbolo da moeda (por exemplo, 25,90). EscrevaR$ {{valorIA}}para mostrar o real.{{valorIACentavos}}: o mesmo total em centavos (2590), para enviar a sistemas externos.
Suas próprias variáveis
Além das prontas, o fluxo guarda as informações que você coleta durante a conversa. Elas ficam disponíveis nos blocos seguintes, com o nome que você escolheu:
| De onde vem | Como criar |
|---|---|
| Resposta do cliente | No bloco Pergunta, o campo Salvar resposta em (por exemplo, emailCliente) |
| Valor definido por você | No bloco Variável: nome e valor (texto ou código) |
| Resposta de um sistema externo | No bloco API Request, em extrair variáveis da resposta |
| Número da oportunidade | No bloco Oportunidade, o campo Salvar ID da oportunidade em variável (crm_opp_id). Veja Construtor de Fluxo: criar e atualizar oportunidades |
- Use nomes curtos, sem espaços nem acentos:
emailCliente,produtoEscolhido. - O nome precisa ser único dentro do fluxo. Se duas etapas gravam a mesma variável, a última sobrescreve a anterior.
- Depois de gravada, use
{{emailCliente}}em qualquer mensagem, em Condição, em e-mails e em chamadas de API.
Exemplo
- Bloco Pergunta: Qual é o seu e-mail?, salvando em
emailCliente. - Bloco Pergunta: Qual produto você procura?, salvando em
produto. - Bloco de Bloco de conteúdo:
Perfeito, {{firstName}}! Vamos enviar as informações sobre {{produto}} para {{emailCliente}}.
Perguntas frequentes
Escrevi {nome} e a mensagem saiu com {nome}.
As variáveis usam chaves duplas. Escreva {{name}}, ou clique no botão da variável para inserir o texto certo.
Escrevi a variável certa, mas saiu vazia.
Confira as letras maiúsculas e minúsculas, e se o bloco que grava a variável vem antes no caminho do fluxo. Uma variável ainda não preenchida vira texto vazio.
Como mostro o valor com R$?
Escreva R$ {{valorIA}}. A variável traz só o número, para você escolher como mostrar.
Posso usar a variável do cliente em uma chamada de API ou e-mail?
Sim. Os campos de URL, corpo, assunto e destinatário aceitam as variáveis, com chaves duplas.
A saudação {{ms}} está errada para o meu fuso.
O horário usado é o de Brasília. A saudação segue esse fuso.