Como Criar um Fluxo de Atendimento do Zero

Os 14 Nós do Pipeline de Processamento

1. 1Filtrar Status: ignora atualizações de status de entrega (só processa mensagens novas).
2. 2Parsear Mensagem: extrai tipo, conteúdo e metadados da mensagem recebida.
3. 3Verificar/Criar Cliente: busca ou cria o contato no banco de dados.
4. 4Download de Mídia: baixa áudios, imagens e documentos do WhatsApp.
5. 5Normalizar Mensagem: converte todos os tipos de mídia para texto (Whisper + Vision).
6. 6Push para Redis: enfileira a mensagem para o sistema de batching inteligente.
7. 7Salvar Mensagem do Usuário: persiste a mensagem no histórico.
8. 8Aguardar Batch (30s): agrupa mensagens enviadas em sequência rápida.
9. 9Buscar Histórico: carrega as últimas 15 mensagens para contexto da IA.
10. 10Buscar Contexto RAG: pesquisa nos documentos da base de conhecimento.
11. 11Gerar Resposta IA: chama o modelo de IA com todo o contexto.
12. 12Formatar Resposta: divide em múltiplas mensagens, remove artefatos.
13. 13Enviar e Salvar: envia pelo WhatsApp e salva no histórico simultaneamente.

Configurando o Agente — O Núcleo do Fluxo

1. 1Acesse Dashboard → Agentes → selecione ou crie um agente.
2. 2Defina o Nome do Agente (identificação interna, ex: "Assistente Principal").
3. 3Escreva o Prompt de Sistema: as instruções completas de comportamento.
4. 4Selecione o Provedor de IA: Groq (velocidade) ou OpenAI (capacidade).
5. 5Defina o modelo específico: Llama 3.3 70B, GPT-4o, GPT-4o-mini.
6. 6Configure temperatura (0.0-1.0) e máximo de tokens por resposta.
7. 7Ative ou desative ferramentas: transferência para humano, busca de documentos, TTS.
8. 8Salve e publique o agente.

Estrutura do Prompt de Sistema — Boas Práticas

• Identidade: "Você é [Nome], assistente da [Empresa]."
• Tom e estilo: "Responda sempre em português brasileiro, com tom profissional e empático."
• O que pode responder: liste os tópicos que o bot deve cobrir.
• Limitações: "Não forneça preços sem consultar o catálogo. Não discuta concorrentes."
• Quando transferir: "Se o cliente pedir para falar com humano, ou se a pergunta for sobre situações jurídicas, use a ferramenta de transferência."
• Formato de resposta: "Responda de forma concisa, máximo 3 parágrafos. Use listas quando adequado."

Testando o Fluxo

1. 1Envie uma mensagem de teste para o número de WhatsApp conectado.
2. 2Acompanhe em tempo real no Dashboard → Debug — cada nó exibe seu status (sucesso/erro).
3. 3Verifique o log de processamento para identificar se algum nó travou ou gerou erro.
4. 4Ajuste o prompt e repita o teste até o comportamento ser o esperado.