Variáveis e Contexto em Chatbots

​

Tipos de Variáveis

​

1. Variáveis de Sessão

Olá {{nome}}! Como posso te ajudar hoje?

​

2. Variáveis de Contato

• {{contato.nome}} - Nome do contato
• {{contato.email}} - E-mail do contato
• {{contato.telefone}} - Telefone do contato
• {{contato.empresa}} - Nome da empresa
• {{contato.cidade}} - Cidade do contato
• {{contato.estado}} - Estado do contato
• {{contato.pais}} - País do contato
• {{contato.tags}} - Tags associadas ao contato
• {{contato.criado_em}} - Data de cadastro
• {{contato.ultima_interacao}} - Data da última interação
• {{contato.canal}} - Canal de comunicação atual
• {{contato.id}} - ID único do contato

​

3. Variáveis de Sistema

• {{data_atual}} - Data atual no formato DD/MM/AAAA
• {{hora_atual}} - Hora atual no formato HH:MM
• {{dia_semana}} - Dia da semana (segunda, terça, etc.)
• {{nome_empresa}} - Nome da sua empresa
• {{canal}} - Canal de comunicação atual (WhatsApp, Instagram, etc.)
• {{id_conversa}} - ID único da conversa

​

4. Variáveis Personalizadas

1. Use o nó “Atribuição”
2. Escolha um nome para a variável (sem espaços ou caracteres especiais)
3. Defina o valor (pode conter outras variáveis)

​

Escopo das Variáveis

• Global: Acessível em qualquer parte do fluxo
• Local: Disponível apenas dentro de um nó específico
• Sessão: Válida apenas durante a conversa atual

​

Operações com Variáveis

​

Atribuição

{{set variavel = valor}}

​

Concatenação

{{set saudacao = "Olá " + nome + "!"}}

​

Operações Matemáticas

{{set total = quantidade * preco}}

​

Condicionais

{{#if condicao}}
  Conteúdo exibido se a condição for verdadeira
{{else}}
  Conteúdo exibido se a condição for falsa
{{/if}}

​

Exemplos Práticos

​

1. Saudação Personalizada

Olá {{contato.nome}}! 
Vimos que você está falando pelo {{canal}}.
Como posso te ajudar hoje?

​

2. Condicional com Variável

{{#if contato.empresa}}
  Como vai a equipe da {{contato.empresa}} hoje?
{{else}}
  Em qual empresa você trabalha?
{{/if}}

​

3. Cálculo de Desconto

{{set valorTotal = quantidade * preco}}
{{set desconto = valorTotal * 0.1}} {{! 10% de desconto}}
{{set valorFinal = valorTotal - desconto}}

O valor total é R$ {{valorTotal}}.
Com desconto de 10%: R$ {{valorFinal}}

​

Boas Práticas

1. Nomes Descritivos: Use nomes que indiquem claramente o propósito da variável
2. Inicialização: Sempre inicialize variáveis antes de usá-las
3. Validação: Verifique se uma variável existe antes de usá-la
4. Documentação: Mantenha uma lista de variáveis usadas no fluxo
5. Limpeza: Remova variáveis temporárias quando não forem mais necessárias

​

Solução de Problemas Comuns

​

Variável não definida

{{#if variavel}}
  {{variavel}}
{{else}}
  Valor padrão
{{/if}}

​

Debug de Variáveis

{{log "Valor da variável:" variavel}}

​

Próximos Passos

• Aprenda sobre integrações avançadas com outros sistemas
• Consulte boas práticas para criar chatbots eficientes
• Veja como solucionar problemas comuns