Conversas com o agente de IA

🛂 Permissão: dashboard.view 📍 Caminho: Operações → Conversas IA

A 365 Vendas embarca um agente conversacional (Agno + Gemini) que atende clientes pelos seguintes canais:

1. WebSocket — chat embutido na loja online (widget no canto inferior).
2. WhatsApp não-oficial — via Baileys.
3. WhatsApp oficial — via API Cloud da Meta (futuro).

O que o agente sabe fazer

• Responder dúvidas sobre catálogo (preços, estoque, descrições).
• Calcular frete com o endereço do cliente.
• Aplicar cupons e considerar promoções vigentes.
• Cadastrar o cliente (se for novo) e capturar endereço + contato.
• Gerar pedido e link de pagamento ao final.
• Consultar status de pedidos passados.
• Responder horário de funcionamento, redes sociais, endereço da loja.

Toda informação que o agente usa vem do tenant: produtos, categorias, tabelas, configs de frete, horário etc. Mantenha esses dados atualizados.

Tela de Conversas

Em Operações → Conversas IA você vê todas as sessões com:

• Cliente (se identificado) ou telefone/sessionId anônimo.
• Canal (websocket / whatsapp).
• Última mensagem.
• Status (ativa / encerrada).

Clique em uma conversa para ver o histórico completo.

Encerramento por TTL

Conversas têm um tempo de vida (session_ttl_seconds):

• Configurado em Config. da Loja → Tempo de Sessão do Chat (1–168 horas).
• Vazio = padrão de 1 hora.
• Após o TTL sem mensagem, a conversa é considerada encerrada — uma nova mensagem do mesmo cliente abre nova sessão.

Multi-canal — uma identidade só

Se o cliente conversa pela web, depois pelo WhatsApp, e mais tarde via outro canal — o agente reconhece e mantém o histórico de pedidos unificado por CPF/CNPJ + telefone. A inteligência comercial usa esse histórico para gerar recomendações.

Intervenção humana

Em qualquer conversa, um operador (vendedor) pode:

1. Abrir a conversa em Operações → Conversas IA.
2. Enviar mensagem em nome do agente (botão Responder como humano).

Quando o humano envia, o agente pausa automaticamente até o humano sair, evitando sobreposição de respostas.

Privacidade e auditoria

• Mensagens são armazenadas com timestamps.
• A conversa fica vinculada ao cliente (quando identificado) — útil para auditoria comercial.
• Para apagar uma conversa, peça ao suporte (LGPD).

Boas práticas

• Mantenha o catálogo limpo e bem descrito — o agente consegue responder muito mais.
• Capriche na descrição da loja (Configurações da loja) — define o tom de voz do agente.
• Acompanhe periodicamente as conversas perdidas (cliente desistiu) — ajuda a calibrar produtos, preços e disponibilidade.
• Para cenários onde o cliente quer falar com humano, treine a equipe a checar o painel várias vezes ao dia.

Diagnóstico rápido

Sintoma	Causa provável	Solução
Cliente manda no WhatsApp e não recebe resposta	Conexão Baileys caiu	Reconectar em WhatsApp.
Agente "não conhece" um produto	Produto inativo, sem descrição ou recém-cadastrado (cache)	Confirme is_active = true, descrição preenchida; reinicie a conversa.
Frete sai errado	Latitude/longitude da loja em branco	Configure em Configurações da loja.
Agente fala demais / pouco	Descrição da loja muito longa/curta	Ajuste o texto de descrição.