Variáveis nativas no Treble

​
O que são as variáveis nativas?

As variáveis nativas no Treble são variáveis especiais que o sistema fornece automaticamente em cada conversação. Você não precisa defini-las nem pedi-las ao usuário: sempre estão disponíveis e você pode usá-las diretamente em nós condicionais ou para personalizar mensagens e rotas do seu fluxo conversacional. Estas variáveis permitem criar fluxos inteligentes e personalizados, adaptando a experiência do usuário segundo o contexto, a hora, o país, o dia da semana ou a mensagem inicial com a qual o usuário inicia a conversação.
Importante: As variáveis nativas podem ser usadas diretamente em blocos condicionais, sem necessidade de tê-las capturado previamente no fluxo.

​
Por que são importantes?

  • Permitem personalizar a experiência do usuário de forma automática e dinâmica.
  • Facilitam a segmentação e o roteamento de conversações segundo contexto, horário, país, etc.
  • Ajudam a criar fluxos mais inteligentes e adaptados às necessidades de cada cliente.
  • Reduzem a necessidade de pedir informações redundantes ao usuário.

​
Variáveis nativas disponíveis

A seguir, te explicamos cada variável nativa, como se usa e exemplos de casos de uso:

​
1. Hora atual (time)

Esta variável armazena a hora atual (em formato 24 horas, GMT-0) na qual o usuário interage com o fluxo. É útil para criar fluxos que dependam do horário, como atenção fora do horário laboral, promoções noturnas, ou mensagens personalizadas segundo a hora do dia. 
{{time}}
Nota: A hora está em GMT-0. Se seu negócio está em outra zona horária (por exemplo, Colômbia GMT-5), deve ajustar a condição somando ou restando horas segundo corresponda. Você pode usar este conversor de tempo para calcular a hora local.
Exemplo de uso:
  • Redirecionar a um agente só no horário laboral:
    • Se {{time}} >= 13:00 e {{time}} < 22:00, mostrar menu de atenção.
    • Se não, mostrar mensagem de fora do horário.

​
2. Dia da semana (weekday)

Esta variável indica o dia da semana no qual o usuário interage com o fluxo. O valor é um número inteiro onde 1 é segunda-feira e 7 é domingo. 
{{weekday}}

Guia de configuração de horários e tempo

Aprenda a configurar horários e tempo no Treble.
 Exemplo de uso:
  • Oferecer promoções só nos fins de semana:
    • Se {{weekday}} >= 6, mostrar mensagem de promoção especial.
  • Mudar o fluxo de suporte segundo o dia:
    • Se {{weekday}} <= 5, dirigir ao suporte regular.
    • Se {{weekday}} >= 6, dirigir ao suporte de fim de semana.

​
3. Código do país (country_code)

Esta variável contém o código do país do número de telefone do usuário. É útil para personalizar mensagens, rotas ou agentes segundo o país de origem do cliente. O formato é o seguinte: +57, +55, etc. 
{{country_code}}
Variável country_code Exemplo de uso:
  • Mostrar mensagens no idioma local segundo o país:
    • Se {{country_code}} = +57, mostrar mensagens em espanhol (Colômbia).
    • Se {{country_code}} = +55, mostrar mensagens em português (Brasil).
  • Atribuir agentes especializados por país.

​
4. Mensagem inicial (inbound)

Esta variável armazena a mensagem com a qual o usuário inicia a conversação (só para fluxos inbound). Permite personalizar a experiência segundo a intenção ou palavra-chave com a qual o usuário entra em contato com sua empresa. 
{{inbound}}
Variável inbound Exemplo de uso:
  • Se o usuário inicia a conversação com “Suporte”, dirigí-lo diretamente ao fluxo de suporte.
  • Se o usuário escreve “Cotização”, mostrar o menu de cotizações.
Suponha que sua empresa tem várias campanhas ou canais de aquisição e você quer que, dependendo da mensagem com a qual o usuário inicia a conversação (usando um link do WhatsApp com mensagem predefinida), o usuário seja dirigido automaticamente a um fluxo específico. Isto é possível graças à variável nativa inbound, que captura a mensagem inicial enviada pelo usuário. Cenário:
  • Você tem três campanhas ativas:
    1. Campanha de Suporte: O link do WhatsApp tem a mensagem predefinida Suporte.
    2. Campanha de Vendas: O link do WhatsApp tem a mensagem predefinida Quero comprar.
    3. Campanha de Feedback: O link do WhatsApp tem a mensagem predefinida Deixar feedback.
Quando o usuário clica em um destes links e envia a mensagem, a variável {{inbound}} tomará exatamente esse valor. Você pode usar um bloco condicional no início do fluxo para rotear a conversação segundo o valor de inbound. Configuração do bloco condicional:
  • Se {{inbound}} for igual a Suporte → Redirecionar ao fluxo de suporte.
  • Se {{inbound}} for igual a Quero comprar → Redirecionar ao fluxo de vendas.
  • Se {{inbound}} for igual a Deixar feedback → Redirecionar ao fluxo de feedback.
  • Em qualquer outro caso → Mostrar um menu geral ou mensagem de boas-vindas padrão.
Condição personalizada:
Variável: inbound
Operador: Igual a
Valor: Suporte → [Fluxo de Suporte]
Valor: Quero comprar → [Fluxo de Vendas]
Valor: Deixar feedback → [Fluxo de Feedback]
Em todos os demais casos → [Menu geral]
Você pode criar e gerenciar os links do WhatsApp desde a seção WhatsApp Links no Treble, definindo a mensagem predefinida que será usada como valor de inbound.
Diagrama de fluxo simplificado: Vantagens desta abordagem:
  • Permite medir o desempenho de cada canal ou campanha usando métricas de WhatsApp Links.
  • Automatiza a experiência do usuário, levando-o diretamente ao fluxo relevante segundo sua intenção inicial.
  • Facilita a personalização e a análise da aquisição de leads por canal.
Pronto! Assim você pode usar a variável inbound junto com os Links do WhatsApp para criar um roteador inteligente de conversações no Treble.

​
Casos de uso avançados

  • Horários e dias combinados: Você pode combinar {{time}} e {{weekday}} para criar regras como “só mostrar promoções nas sextas-feiras depois das 18h”.
  • Segmentação internacional: Use {{country_code}} para adaptar o idioma, moeda ou agente segundo o país do usuário.
  • Automação inbound: Use {{inbound}} para rotear automaticamente os usuários segundo a intenção detectada em sua primeira mensagem.

​
Próximos passos

Variáveis no Treble

Aprenda a criar e usar variáveis personalizadas e coletadas pelo cliente.

Bloco condicional

Aprenda a usar variáveis nativas em blocos condicionais.