Sessão do agente vs conversa: como a IA lembra o cliente

Na WhatsWave existem dois conceitos que parecem iguais, mas fazem trabalhos diferentes:

• Conversa — o histórico do WhatsApp/Instagram na Central de Conversas
• Sessão do agente — a memória de curto prazo da IA com aquele contato naquele número

Entender essa diferença evita surpresas do tipo “o bot esqueceu o que o cliente disse ontem”.

Em uma frase

A conversa é a pasta do cliente no atendimento. A sessão é o turno atual do robô dentro dessa pasta — e esse turno pode reiniciar sem apagar as mensagens do WhatsApp.

Comparativo rápido

Como a sessão funciona na prática

1. O contato envia uma mensagem para um número com agente ativo
2. O WhatsWave abre (ou reutiliza) uma sessão daquele agente + contato + instância
3. As respostas da IA usam o histórico dessa sessão
4. A sessão pode pausar (atendente humano, mensagem manual, transferência) ou encerrar
5. Na próxima mensagem após o encerramento, nasce uma nova sessão — a IA não carrega o diálogo curto anterior

Importante: memórias do agente (política, catálogo, FAQ) continuam disponíveis. O que se perde é o fio da conversa daquela sessão — não o conhecimento do negócio.

Onde configurar o tempo da sessão

O Tempo da Sessão fica no vínculo agente ↔ instância:

1. Vá em Instâncias
2. No card do número, abra Configurar agente
3. Ajuste Tempo da Sessão (presets de 1 hora a 7 dias, ou nunca expirar)

Depois desse período sem continuidade na sessão, uma nova é criada e o contexto curto da IA é resetado.

Outras opções no mesmo dialog (avançado):

• Palavra para Finalizar (padrão /fim) — o contato encerra a sessão na hora
• Parar Bot com Minhas Mensagens — quando você responde manualmente, a IA pausa
• Tempo de Pausa — quanto tempo a IA fica quieta após intervenção humana

Veja o passo a passo completo em Como associar um agente de IA a uma instância.

Onde ver as sessões

• Agente → aba Sessões — lista, tokens, testes e simulações
• Contato → aba Sessões IA — histórico de atendimentos automáticos daquele telefone
• Central de Conversas — pausar/retomar o bot sem apagar a conversa

Detalhes no contato: Histórico de conversas do contato.

Cenários práticos

Cliente some e volta depois

Com TTL de 24 horas, quem some um dia e retorna tende a cair em nova sessão — a IA pede de novo dados que já tinha na sessão anterior. Com 7 dias (padrão), o contexto curto costuma sobreviver a pausas de fim de semana.

Escolha o TTL conforme o seu funil: suporte rápido → TTL menor; venda consultiva → TTL maior.

Atendente manda mensagem no meio

A conversa continua normal no inbox. A sessão pode pausar (se “Parar Bot com Minhas Mensagens” estiver ativo). Quando a pausa acaba — ou alguém retoma o bot — a IA volta na mesma sessão, se ela ainda não tiver expirado.

Cliente envia /fim

A sessão encerra. A próxima pergunta abre contexto novo. Útil para “quero falar de outro assunto” sem misturar pedidos.

Vários agentes no mesmo número

Cada agente tem sessões próprias. Trocar de agente (ou usar sub-agentes) não é a mesma coisa que fechar a conversa no WhatsApp.

Sessão pausada ≠ conversa fechada

Na transferência IA → humano, a sessão costuma pausar para o bot não falar por cima do atendente. A conversa permanece aberta na Central.

Saiba mais: Transferência de IA para humano e Como configurar transferência para humano.

Não confundir com outros “sessões”

Tokens e o gráfico de sessões

Na página do agente, o gráfico Sessões por Período conta quantas sessões de IA foram abertas — incluindo conversas reais, testes e alguns processos automatizados. Não é a mesma métrica que “conversas abertas” no inbox.

→ Tokens e custo por conversa

Próximos passos

• O que é o Agente de IA
• Como associar um agente de IA a uma instância
• Configurações gerais do agente (tamanho do histórico / resumo)
• Agente de IA não responde
• Workflows avançados: Nó Session