Variáveis Nativas

​

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}}

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}}

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}}

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.

​

Exemplo de uso da variável inbound com os Links do WhatsApp

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]

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.

​

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