No Flowbuilder é possível manipular e consultar variáveis nativas e criadas, isso facilita produtividade, integrações e a manter as informações sempre atualizadas de forma automática.
Essa documentação visa explicar cada um dos tipos existentes no sistema e explicar onde utiliza-las. Cada bloco onde podem ser utilizadas/consultadas se encontra ao lado do titulo.
Ex: Utilitários [Validar Condições/envio de mensagem]
Ou seja esse tipo de variável pode ser utilizado e visualizado nos blocos Validar condições e envio de mensagem.
Documentação referente aos blocos: blocos

🛠️Utilitários [Validar Condições/Envio de Mensagem]

date.date

• Descrição: Data no formato técnico (YYYY-MM-DD).

• Exemplo: 2025-06-09

  
  
  

date.date_formatted

• Descrição: Data formatada (DD/MM/YYYY).

• Exemplo: 09/06/2025

  
  

  

📍 Case: Confirmação de agendamento

• Bloco Enviar mensagem:
  → "Seu agendamento está confirmado para {{date.date_formatted}} às {{date.time}}."

• Cliente recebe data no padrão brasileiro.

date.day

• Descrição: Dia do mês (1 a 31).

• Exemplo: 9
  
  

  
  
  

📍 Case: Promoção do dia

• Bloco Bloco condicional:
  → Se {{date.day}} == 15
  → Enviar mensagem: "Hoje é dia 15, você tem 15% de desconto!"

date.day_of_week_name

• Descrição: Nome do dia da semana.

• Exemplo (condição):  sexta-feira
  Se a variável for igual à “Sexta-feira” o bloco condicional deve passar por um bloco de “Enviar mensagem” e dizer ao cliente Atendimento transferido! Lhe desejamos um bom final de semana.

📍 Case: Mensagem personalizada por dia

• Bloco Definir variável:
  → Variável $saudacao recebe "Boa {{date.day_of_week_name}}!"

• Usada em várias mensagens do fluxo.

date.day_of_week_number

• Descrição: Número do dia da semana (Segunda=1, Domingo=7).

• Exemplo: 1

📍 Case: Redirecionar atendimento

• Bloco Bloco condicional:
  → Se {{date.day_of_week_number}} == 6 ou 7
  → Transferir para departamento_fora_horário
  → Senão → Seguir fluxo normal.

date.day_of_year

• Descrição: Dia do ano (1 a 365/366).

• Exemplo: 227

📍 Case: Mensagem motivacional

• Bloco Enviar mensagem:
  → "Hoje é o {{date.day_of_year}}º dia do ano. Ainda dá tempo de conquistar seus objetivos!"

date.full_date

• Descrição: Data e hora completas (YYYY-MM-DD HH:mm:ss).

• Exemplo: 2025-06-09 11:18:31

• 
  
  

  
  

• 
  
  

  
  

📍 Case: Registro técnico

• Bloco Gravar no log:
  → "Solicitação recebida em {{date.full_date}}"

• Útil para auditoria.

date.full_date_formatted

• Descrição: Data e hora completas formatadas (DD/MM/YYYY HH:mm:ss).

• Exemplo: 09/06/2025 11:18:31

📍 Case: Confirmação de abertura de ticket

• Bloco Enviar email:
  → "Seu ticket foi aberto em {{date.full_date_formatted}}. Em breve entraremos em contato."

date.is_weekend

• Descrição: Retorna true se for sábado ou domingo.

• Exemplo (condição): false (Segunda a Sexta) / true (Sábado ou Domingo)

• 
  
  

  
  

  
  

  
  
  

📍 Case: Diferenciar atendimento

• Bloco Bloco condicional:

  • Se {{date.is_weekend}} == true
    → Oferecer menu rápido: "Quer abrir um chamado para segunda-feira?"

  • Senão → Seguir com menu de departamentos.

  
  

date.month_name

• Descrição: Nome do mês.

• Exemplo: Junho

• 

  
  

  
  

• 
  
  

📍 Case: Campanha do mês

• Bloco Enviar template:
  → "Promoção exclusiva de {{date.month_name}}: frete grátis em todas as compras!"

date.month_number

• Descrição: Número do mês (Janeiro=1, Dezembro=12).

• Exemplo: 6

• 
  
  

  
  

  
  

• 
  

  
  
  

📍 Case: Relatório interno

• Bloco Definir variável:
  → $mes_atual = {{date.month_number}}

• Depois, usado em Requisição HTTP para enviar dados ao CRM.

• 
  

date.time

• Descrição: Hora atual (HH:mm:ss).

• Exemplo: 11:18:31

  
  

• 
  
  

  
  

  
  

• 
  
  

📍 Case: SLA de atendimento

• Bloco Definir variável:
  → $inicio_atendimento = {{date.time}}

• No encerramento, outro bloco compara horário para calcular duração.

date.timestamp

• Descrição: Data/hora em milissegundos desde 1970.

• Exemplo (uso técnico): 1749478711412

📍 Case: Gerar protocolo único

• Bloco Gerar protocolo:
  → "ATD-{{date.timestamp}}"

• Garante que nenhum protocolo se repete.

date.week_of_year

• Descrição: Número da semana do ano (1 a 52/53).

• Exemplo: 24

📍 Case: Controle de campanhas semanais

• Bloco Bloco condicional:
  → Se {{date.week_of_year}} == 24
  → Enviar mensagem de promoção da semana 24.

date.year

• Descrição: Ano atual.

• Exemplo: 2025

📍 Case: Validade de contrato

• Bloco Enviar documento:
  → "Seu contrato foi renovado para o ano de {{date.year}}."

Contato

agentePreferido  [Validar Condições/Envio de Mensagem/Agente Favorito/Definir Var.]

• Descrição: Armazena o agente preferido, pode der definida (nos blocos definir variável) ou apenas consultada (Agente Favorito, validar condições ou envio de mensagem).

email  [Validar Condições/Envio de Mensagem/Definir Var.]

• Descrição: Armazena o email do contato, pode der definida (nos blocos definir variável) ou apenas consultada (Validar condições ou envio de mensagem).

empresa  [Validar Condições/Envio de Mensagem/Definir Var.]

• Descrição: Armazena a empresa do contato, pode der definida (nos blocos definir variável) ou apenas consultada (Validar condições ou envio de mensagem).

name  [Validar Condições/Envio de Mensagem/Definir Var.]

• Descrição: Armazena o nome do contato, pode der definida (nos blocos definir variável) ou apenas consultada (Validar condições ou envio de mensagem).

name  [Validar Condições/Envio de Mensagem/Definir Var.]

• Descrição: Armazena o nome do contato, pode der definida (nos blocos definir variável) ou apenas consultada (Validar condições ou envio de mensagem).

contact_tags  [Validar Condições/Envio de Mensagem/Definir Var.]

• Descrição: Armazena as tags do contato, pode der definida (nos blocos definir variável) ou apenas consultada (Validar condições ou envio de mensagem).

stop_receiving_campaigns  [Validar Condições/Envio de Mensagem/Definir Var.]

• Descrição: Armazena o valor do campo “Parar de receber campanhas” do contato, pode der definida (nos blocos definir variável) ou apenas consultada (Validar condições ou envio de mensagem).

Atendimento

agentePreferido  [Validar Condições/Envio de Mensagem/Agente Favorito/Definir Var.]

• Descrição: Armazena o agente preferido, pode der definida (nos blocos definir variável) ou apenas consultada (Agente Favorito, validar condições ou envio de mensagem).

email  [Validar Condições/Envio de Mensagem/Definir Var.]

• Descrição: Armazena o email do contato, pode der definida (nos blocos definir variável) ou apenas consultada (Validar condições ou envio de mensagem).