O que são variáveis?
Variáveis são informações que podem ser usadas nas mensagens para personalizar a conversa com o cliente. Por exemplo, em vez de sempre escrever "Olá, cliente!", você pode usar uma variável para chamar o cliente pelo nome, como "Olá, João!".

Essas informações podem ser sobre o cliente, o atendente ou até a conversa em si. O Talk vai substituir essas variáveis automaticamente com os dados corretos quando o atendimento acontecer, tornando a interação mais pessoal e eficiente.

Como as variáveis funcionam no Talk
No Talk, você pode usar variáveis para personalizar mensagens, de forma que cada interação seja única. Por exemplo: Você pode usar o nome do cliente nas mensagens: "Oi, {{Contato.PrimeiroNome}}, como posso te ajudar?". Ou ainda, pode usar informações da conversa: "Sua solicitação foi registrada com o ID {{Conversa.Id}}."

Ao usar as variáveis, o Talk vai preencher automaticamente essas informações durante o atendimento, sem que você precise fazer isso manualmente. Isso economiza tempo e ajuda a criar uma experiência mais personalizada para o cliente.

Exemplos de variáveis disponíveis
Aqui estão alguns exemplos de variáveis que você pode usar:

1) Variáveis de Contato:

• {{Contato.PrimeiroNome}} — O primeiro nome do cliente.
• {{Contato.NomeCompleto}} — O nome completo do cliente.
• {{Contato.Numero}} — O número de telefone do cliente.

2) Variáveis do atendente

• {{Conversa.Id}} — O ID da conversa.
• {{Conversa.DataDeCriacaoUTC}} — A data de criação da conversa.

3) Variáveis de Conversa:

• {{Conversa.Id}} — O ID da conversa.
• {{Conversa.DataDeCriacaoUTC}} — A data de criação da conversa.

4) Variável de contexto:

O objeto Contexto guarda informações coletadas em blocos anteriores da conversa. Por exemplo, se você perguntar qual cidade o cliente mora, o valor informado pelo cliente pode ser salvo no objeto Contexto. Depois, em um novo bloco, você pode usar uma variável como {{Contexto."cidade":raw}} para referir-se a essa informação. 

Para ilustrar, veja abaixo um exemplo de um chatbot onde é perguntado ao contato o nome da cidade. Esse dado é salvo pelo bloco "Campo do Contato" utilizando o ID do contexto do bloco "Pedir para digitar", com base na resposta do contato à pergunta feita nesse bloco. Em um fluxo, é possível utilizar essa variável logo em seguida, ou seja, ela pode ser usada na próxima mensagem ao cliente.

Nesse exemplo a variável é {{Contexto.Z51p7RERLFC-Isnu:raw}}. Vamos entender cada parte dessa variável:

• Contexto: Refere-se ao conjunto de informações coletadas em blocos anteriores da conversa, que são armazenadas nos campos personalizados do contato.
• "Z51p7RERLFC-Isnu" (exemplo): Este seria o ID do bloco "Pedir para Digitar". Logo, se esse bloco perguntou "Qual é a sua cidade?", esse identificador estará associado à resposta digitada pelo contato, ou seja, a cidade mencionada pelo cliente. Você pode copiar facilmente o ID clicando em "Copiar id" no bloco desejado. 
• :raw: O sufixo :raw é usado para garantir que a resposta seja armazenada exatamente como foi enviada pelo usuário, sem qualquer modificação ou formatação adicional.

4) Variáveis exportadas:

Além das variáveis padrão do sistema, cada bloco pode gerar variáveis específicas com informações coletadas durante a conversa. Essas variáveis são chamadas de variáveis exportadas e podem ser utilizadas em mensagens futuras dentro do fluxo do chatbot.

Essas variáveis exportadas podem ser aproveitadas para diversas finalidades, como registrar feedbacks dos clientes, gerar relatórios ou enviar alertas para a equipe. Por exemplo, o texto de feedback deixado por um cliente pode ser enviado automaticamente para um sistema de acompanhamento de interações, permitindo que a equipe de atendimento visualize e analise o comentário.

A seguir, você pode verificar as variáveis exportadas dos principais blocos. Mas lembre-se de que você pode acessar essas variáveis diretamente nos detalhes de cada bloco dentro do editor de chatbot.

Fallback - Definindo um valor alternativo 

Em algumas situações, a informação esperada pode não estar disponível. Para evitar mensagens sem sentido ou incompletas, você pode definir um valor alternativo usando o fallback.

Isso é feito com o template {{#Ou}} Valor1 | Valor2 {{/Ou}}, onde:

Valor1 é a variável principal que tentamos utilizar.
Valor2 é o valor alternativo caso a variável esteja vazia.

Exemplo:
Se quisermos chamar o contato pelo primeiro nome, mas essa informação não estiver disponível, podemos configurar uma alternativa genérica:

Olá, {{#Ou}} {{Contato.PrimeiroNome}} | Cliente {{/Ou}}! Como posso te ajudar?
Se o contato tiver um primeiro nome cadastrado, será exibido algo como "Olá, João! Como posso te ajudar?". Caso contrário, aparecerá "Olá, Cliente! Como posso te ajudar?".

Isso garante que a comunicação fique sempre natural e completa.

Modificadores: Ajustando o formato das variáveis

Os modificadores permitem alterar a forma como um valor é exibido, garantindo que a informação apareça no formato desejado. Para utilizá-los, basta colocar o nome do modificador antes da variável. Veja a seguir os exemplos de modificadores:

1) CadaPrimeiraLetraMaiuscula→ Deixa a primeira letra de cada palavra em maiúscula:
{{CadaPrimeiraLetraMaiuscula Contato.NomeCompleto}}
Entrada: joão silva
Saída: João Silva

2) Maiusculo → Transforma todo o texto em letras maiúsculas:
{{Maiusculo Contato.NomeCompleto}}
Entrada: pedro batista
Saída: PEDRO BATISTA

3) Minusculo → Transforma todo o texto em letras minúsculas:
{{Minusculo Contato.NomeCompleto}}
Entrada: Gabriel Oliveira
Saída: gabriel oliveira

4) DataFormatada → Ajusta o formato da data de um campo específico:
{{DataFormatada Conversa.DataDeCriacaoUTC 'yyyy-MM-dd'}}
Entrada: 2025-02-02T15:30:00Z
Saída: 2025-02-02

Esperamos que este tutorial tenha ajudado a entender melhor como utilizar as variáveis para personalizar e otimizar o atendimento no Talk. Aproveite esses recursos para oferecer uma experiência mais eficiente e personalizada aos seus clientes!