Sistema de Variáveis no Super Agentes

O sistema de variáveis permite armazenar e utilizar informações dinâmicas durante as conversas, funcionando como “memória” do agente para personalizar respostas e manter contexto.

Antes de começar

Para usar variáveis, você precisa:

Ter um agente criado
Configurar ferramentas básicas
Acesso às configurações do agente

Variáveis são específicas de cada conversa e são automaticamente removidas após 30 dias de inatividade. Não armazene informações sensíveis ou críticas apenas em variáveis.

Pré-requisitos

Antes de configurar variáveis, certifique-se de que:

Seu agente está ativo
Você tem permissões de edição
Compreende a sintaxe: {{nome_da_variavel}}
Você criou variáveis em ferramentas de variáveis.

Configurando Variáveis

Acessando o Módulo

Acesse a barra lateral do Super Agentes
Clique na aba Agentes
Selecione o agente desejado
Vá para Configurações → Ferramentas
Clique em Variáveis

Criando Variáveis Personalizadas

Adicionar Ferramenta de Variáveis

Clique em + Adicionar Ferramenta
Selecione Variáveis na lista
Clique em Conectar variáveis

Configurar Variáveis

Nome da variável: Identificador único (ex: nome_cliente)
Descrição: Explique quando e como será utilizada
- Seja específico sobre o contexto de uso
- Inclua exemplos de valores esperados

Templates Disponíveis

Template Padrão

Configuração Manual

Tipos de Variáveis

Variáveis Customizadas

Criadas por você
Específicas do seu negócio
Exemplos: {{produto_interesse}}, {{data_agendamento}}

Variáveis Globais

Capturadas automaticamente
Baseadas no canal de comunicação
Exemplos: {{user-name}}, {{user-email}}

Variáveis de Runtime

Geradas pelo sistema
Atualizadas dinamicamente
Exemplos: {{today}}, {{conversation-id}}

Variáveis Globais por Canal

Dashboard

{{user-name}} - Nome do usuário logado
{{user-email}} - E-mail do usuário logado, caso tenha conta no Super Agentes
Capturadas automaticamente da sessão

{{user-name}} - Nome do contato
{{user-phone-number}} - Número de telefone
Extraídas do perfil do WhatsApp

Variáveis de Sistema

{{today}} - Data/hora atual
{{conversation-id}} - ID da conversa
{{conversation-status}} - Status da conversa
{{conversation-channel}} - Canal de comunicação

Variáveis de Runtime (Sistema)

As variáveis de runtime são geradas automaticamente pelo sistema durante a execução das conversas. Elas fornecem informações contextuais em tempo real e não precisam ser configuradas manualmente.

Lista Completa de Variáveis de Runtime

Data e Tempo

{{today}}

Data e hora atual no formato ISO
Formato: YYYY-mm-ddTHH:MM:SS
Atualizada a cada execução
Exemplo: 2024-01-15T14:30:25

Identificação da Conversa

{{conversation-id}}

ID único da conversa
Gerado automaticamente pelo sistema
Útil para integrações e logs
Exemplo: clr8x9y2k0001abc123def456

Status da Conversa

{{conversation-status}}

Status atual da conversa
Valores possíveis: OPEN, RESOLVED, PENDING
Atualizado conforme ações do usuário
Útil para workflows condicionais

Prioridade

{{conversation-priority}}

Nível de prioridade da conversa
Valores: LOW, MEDIUM, HIGH, URGENT
Pode ser definida manualmente ou por regras
Influencia ordem de atendimento

Canal de Comunicação

{{conversation-channel}}

Canal onde a conversa está acontecendo
Valores: whatsapp, dashboard, website, api
Útil para personalizar respostas por canal
Permite lógica condicional

Métricas da Conversa

{{conversation-total-messages}}

Contagem total de mensagens na conversa
Inclui mensagens do usuário e do agente
Útil para análise de engajamento
Exemplo: 15

Data de Criação

{{conversation-created-at}}

Data e hora de início da conversa
Formato ISO: YYYY-mm-ddTHH:MM:SS
Não muda durante a conversa
Exemplo: 2024-01-15T09:15:30

Casos de Uso das Variáveis de Runtime

Personalização por Canal

Use {{conversation-channel}} para adaptar o comportamento:

{% if conversation-channel == "whatsapp" %}
Olá! Vi que você está entrando em contato pelo WhatsApp 📱
{% elif conversation-channel == "dashboard" %}
Bem-vindo ao nosso portal de atendimento!
{% endif %}

Controle de Tempo

Combine {{today}} e {{conversation-created-at}} para lógica temporal:

Prompt do sistema:
"Esta conversa foi iniciada em {{conversation-created-at}}.
Agora são {{today}}. Se a conversa tem mais de 24 horas,
pergunte se o usuário ainda precisa de ajuda."

Escalação por Prioridade

Use {{conversation-priority}} para workflows:

Ferramentas HTTP - Headers:
"X-Priority": "{{conversation-priority}}"
"X-Conversation-ID": "{{conversation-id}}"

Lógica no sistema externo:
- HIGH/URGENT: Notificar supervisor
- MEDIUM: Fila padrão
- LOW: Resposta automatizada

Análise de Engajamento

Use {{conversation-total-messages}} para insights:

Follow-up personalizado:
"Olá! Notei que já trocamos {{conversation-total-messages}} mensagens.
{% if conversation-total-messages > 10 %}
Que tal agendar uma conversa por telefone para resolver mais rapidamente?
{% endif %}"

Integrações com CRM

Envie contexto completo para sistemas externos:

{
  "conversation_metadata": {
    "id": "{{conversation-id}}",
    "channel": "{{conversation-channel}}",
    "status": "{{conversation-status}}",
    "priority": "{{conversation-priority}}",
    "created_at": "{{conversation-created-at}}",
    "message_count": "{{conversation-total-messages}}",
    "last_activity": "{{today}}"
  }
}

Diferenças entre Tipos de Variáveis

Tipo	Configuração	Persistência	Atualização	Exemplos
Runtime	Automática	Por conversa	Dinâmica	`{{today}}`, `{{conversation-id}}`
Global	Automática	Por conversa	No início	`{{user-name}}`, `{{user-email}}`
Customizada	Manual	Por conversa	Quando coletada	`{{nome_cliente}}`, `{{produto_interesse}}`

Limitações das Variáveis de Runtime

Não são editáveis: Valores são gerados automaticamente pelo sistema
Específicas por conversa: Cada conversa tem seus próprios valores
Dependem do contexto: Algumas podem estar vazias dependendo do canal
Formato fixo: Datas seguem sempre o padrão ISO

Monitoramento de Runtime Variables

Para visualizar os valores atuais das variáveis de runtime:

Logs da Conversa: Acesse uma conversa específica nos logs
Debug do Agente: Use o preview para ver valores em tempo real
Ferramentas HTTP: Configure endpoints de teste para capturar os valores
Perfil da Conversa: Visualize metadados na interface de logs

Boas Práticas com Runtime Variables

✅ Recomendado:

Use {{conversation-id}} para rastreamento em integrações
Combine {{today}} com lógica temporal nos prompts
Utilize {{conversation-channel}} para personalizar experiência
Aproveite {{conversation-status}} para workflows condicionais

❌ Evite:

Tentar modificar valores de runtime variables
Assumir que todas estarão sempre preenchidas
Usar em cálculos complexos de data (use sistema externo)
Depender exclusivamente delas para lógica crítica

Usando Variáveis

Em Prompts do Sistema

Acesse Configurações → Prompt
Use a sintaxe {{variavel}} no texto
Exemplo:

Você é um assistente de vendas da empresa XYZ. 
Sempre se dirija ao cliente pelo nome: {{user-name}}.
Se o cliente demonstrar interesse em {{produto_interesse}}, 
forneça informações detalhadas sobre este produto.

Em Estágios

Acesse Configurações → Estágios
Configure objetivos e instruções com variáveis
Exemplo no objetivo:

Coletar o nome completo do cliente e armazenar em {{nome_cliente}} 
para personalização das próximas interações.

Em Ferramentas HTTP

Configurar Requisição

Acesse Ferramentas → HTTP
Use variáveis no Body, Headers ou Parameters

Exemplo no Body

{
  "customer_name": "{{nome_cliente}}",
  "customer_email": "{{user-email}}",
  "product_interest": "{{produto_interesse}}",
  "conversation_id": "{{conversation-id}}"
}

Exemplo em Headers

Authorization: Bearer {{api_token}}
X-Customer-Phone: {{user-phone-number}}

Em Follow-ups

Acesse Ferramentas → Follow Up
Configure o objetivo com variáveis
Exemplo:

Verificar se {{nome_cliente}} efetuou o pagamento da parcela 
referente ao produto {{produto_interesse}} adquirido em {{data_compra}}.

Monitoramento e Status

Visualizando Variáveis Ativas

Em Conversa

Acesse uma conversa específica para ver as variáveis coletadas

Logs do Agente

Visualize o histórico de uso das variáveis nos logs

Debug Mode

Use o preview do agente para testar as substituições

Perfil do Usuário

Veja as variáveis globais capturadas por conversa

Exemplos Práticos

E-commerce

Configuração de Variáveis

Prompt do Sistema

Você é um assistente de vendas. Sempre use o nome {{nome_cliente}} 
para se dirigir ao cliente. Se ele perguntar sobre o carrinho, 
informe que tem {{produto_carrinho}} no valor de {{valor_total}}.

Follow-up (24 horas)

Agendamento de Consultas

Variáveis Necessárias

Estágio de Coleta

Objetivo: Coletar nome, tipo de consulta e data preferida

Instruções:

1. Pergunte: 'Qual seu nome completo?' → armazene em {{nome_paciente}}
2. Pergunte: 'Que tipo de consulta precisa?' → armazene em {{tipo_consulta}}
3. Pergunte: 'Qual data prefere?' → armazene em {{data_preferencia}}

Integração HTTP

Suporte Técnico

Sistema de Protocolos

Prompt Personalizado

Você é um assistente de suporte técnico. Sempre se apresente como:
'Olá {{user-name}}, sou seu assistente de suporte.'
Quando um problema for relatado, armazene em {{problema_relatado}} 
e gere um protocolo em {{numero_protocolo}}.

Follow-up Automático

Olá {{user-name}}, este é um follow-up do protocolo {{numero_protocolo}}. 
O problema '{{problema_relatado}}' foi resolvido? O técnico {{tecnico_responsavel}} 
está disponível para mais esclarecimentos.

Boas Práticas

1. Nomenclatura

Use nomes descritivos: {{nome_cliente}} ao invés de {{n}}
Use snake_case: {{data_nascimento}} ao invés de {{dataNascimento}}
Evite caracteres especiais e espaços
Mantenha consistência entre variáveis relacionadas

2. Descrições e Documentação

Sempre forneça descrições detalhadas das variáveis
Explique quando e como a variável será utilizada
Inclua exemplos de valores esperados
Mantenha documentação interna atualizada

3. Segurança e Privacidade

Não armazene informações sensíveis em variáveis
Cuidado com dados pessoais (LGPD/GDPR)
Use variáveis apenas para informações necessárias
Monitore o acesso e uso das variáveis

4. Performance e Organização

Evite criar muitas variáveis desnecessárias
Reutilize variáveis globais quando possível
Agrupe variáveis relacionadas com prefixos
Teste sempre antes de colocar em produção

Solução de Problemas

Variável não está sendo substituída

Variável aparece vazia

Erro em ferramentas HTTP

Variáveis não aparecem no dropdown

Perguntas Frequentes

Quantas variáveis posso criar por agente?

As variáveis persistem entre diferentes conversas?

Como monitorar o uso das variáveis?

Posso importar/exportar configurações de variáveis?

Variáveis funcionam em todos os canais?

SuperAgentes

​Sistema de Variáveis no Super Agentes

Antes de começar

​Pré-requisitos

​Configurando Variáveis

​Acessando o Módulo

​Criando Variáveis Personalizadas

​Tipos de Variáveis

Variáveis Customizadas

Variáveis Globais

Variáveis de Runtime

​Variáveis Globais por Canal

Dashboard

WhatsApp

Variáveis de Sistema

​Variáveis de Runtime (Sistema)

​Lista Completa de Variáveis de Runtime

Data e Tempo

Identificação da Conversa

Status da Conversa

Prioridade

Canal de Comunicação

Métricas da Conversa

Data de Criação

​Casos de Uso das Variáveis de Runtime

​Diferenças entre Tipos de Variáveis

​Limitações das Variáveis de Runtime

​Monitoramento de Runtime Variables

​Boas Práticas com Runtime Variables

​Usando Variáveis

​Em Prompts do Sistema

​Em Estágios

​Em Ferramentas HTTP

​Em Follow-ups

​Monitoramento e Status

​Visualizando Variáveis Ativas

Em Conversa

Logs do Agente

Debug Mode

Perfil do Usuário

​Exemplos Práticos

​E-commerce

​Agendamento de Consultas

​Suporte Técnico

​Boas Práticas

​1. Nomenclatura

​2. Descrições e Documentação

​3. Segurança e Privacidade

​4. Performance e Organização

​Solução de Problemas

​Perguntas Frequentes

Sistema de Variáveis no Super Agentes

Pré-requisitos

Configurando Variáveis

Acessando o Módulo

Criando Variáveis Personalizadas

Tipos de Variáveis

Variáveis Globais por Canal

Variáveis de Runtime (Sistema)

Lista Completa de Variáveis de Runtime

Casos de Uso das Variáveis de Runtime

Diferenças entre Tipos de Variáveis

Limitações das Variáveis de Runtime

Monitoramento de Runtime Variables

Boas Práticas com Runtime Variables

Usando Variáveis

Em Prompts do Sistema

Em Estágios

Em Ferramentas HTTP

Em Follow-ups

Monitoramento e Status

Visualizando Variáveis Ativas

Exemplos Práticos

E-commerce

Agendamento de Consultas

Suporte Técnico

Boas Práticas

1. Nomenclatura

2. Descrições e Documentação

3. Segurança e Privacidade

4. Performance e Organização

Solução de Problemas

Perguntas Frequentes