> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Variáveis Nativas

> As variáveis nativas são variáveis que já vêm pré-configuradas no Treble. Estas permitem acessar informações importantes em seus fluxos de conversação como o código do país do número de telefone do cliente, a mensagem usada pelo seu cliente para iniciar um fluxo de conversação inbound, ou até mesmo o número da semana atual. Aprenda a usar as variáveis nativas para criar fluxos de conversação personalizados.

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/native-vars-1.png?fit=max&auto=format&n=woBrUvSBPp-ldiW5&q=85&s=81de188c69e2c385b396ed9034b19d23" alt="Variáveis nativas no Treble" width="2386" height="1456" data-path="images/native-vars-1.png" />

## 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.

```code theme={null}
{{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](https://savvytime.com/converter/utc) 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**.

```code theme={null}
{{weekday}}
```

<Card title="Guia de configuração de horários e tempo" icon="clock" href="/pt/docs/build-with-treble/guides/schedules-and-time-configuration">
  Aprenda a configurar horários e tempo no Treble.
</Card>

**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.

```code theme={null}
{{country_code}}
```

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/native-vars-2.png?fit=max&auto=format&n=woBrUvSBPp-ldiW5&q=85&s=648b74ee78c0f411c73081cdb85da184" alt="Variável country_code" width="2384" height="1460" data-path="images/native-vars-2.png" />

**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.

```code theme={null}
{{inbound}}
```

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/native-vars-3.png?fit=max&auto=format&n=woBrUvSBPp-ldiW5&q=85&s=d421128bb35ce9d5ebd711c35f0c17f5" alt="Variável inbound" width="2390" height="1456" data-path="images/native-vars-3.png" />

**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.

<inbound>
  <b>Dica:</b> Você pode usar a variável <code>{{inbound}}</code> em blocos condicionais para criar fluxos inteligentes segundo a palavra-chave com a qual o usuário inicia a conversação.
</inbound>

#### 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.

```code theme={null}
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]
```

<Info>
  Você pode criar e gerenciar os links do WhatsApp desde a seção <b>WhatsApp Links</b> no Treble, definindo a mensagem predefinida que será usada como valor de <code>inbound</code>.
</Info>

**Diagrama de fluxo simplificado:**

```mermaid theme={null}
graph TD;
    A[Usuário clica no link do WhatsApp] --> B[Envia mensagem predefinida]
    B --> C{Bloco condicional: Qual é o valor de inbound?}
    C -- Suporte --> D[Fluxo de Suporte]
    C -- Quero comprar --> E[Fluxo de Vendas]
    C -- Deixar feedback --> F[Fluxo de Feedback]
    C -- Outro --> G[Menu geral]
```

**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.

<Check>
  Pronto! Assim você pode usar a variável <code>inbound</code> junto com os Links do WhatsApp para criar um roteador inteligente de conversações no Treble.
</Check>

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

<CardGroup cols={2}>
  <Card title="Variáveis no Treble" icon="hashtag" href="/pt/docs/build-with-treble/features/variables">
    Aprenda a criar e usar variáveis personalizadas e coletadas pelo cliente.
  </Card>

  <Card title="Bloco condicional" icon="code" href="/pt/docs/integrations/hubspot/blocks/conditional">
    Aprenda a usar variáveis nativas em blocos condicionais.
  </Card>
</CardGroup>