From ef85a99ea6e16953ab1fdb534210f8b6e31f3ad0 Mon Sep 17 00:00:00 2001 From: Rafael Lopes Date: Mon, 1 Jun 2026 14:26:36 -0300 Subject: [PATCH] DOCS: Adicionado proximos passos --- Knowledge-Base-e-Agente-Virtual.md | 2 +- Whatsapp.md | 45 ++++++++++++++++++------------ 2 files changed, 28 insertions(+), 19 deletions(-) diff --git a/Knowledge-Base-e-Agente-Virtual.md b/Knowledge-Base-e-Agente-Virtual.md index ff8db91..4c31f07 100644 --- a/Knowledge-Base-e-Agente-Virtual.md +++ b/Knowledge-Base-e-Agente-Virtual.md @@ -53,7 +53,7 @@ Permite configurar o fluxo do Agente Virtual Sothis: ## Relacao com WhatsApp -O WhatsApp chama `routeIncomingMessage()` em `whatsapp-assignment.service.ts`. Esse metodo tenta: +O WhatsApp chama `routeIncomingMessage()` em `attendance-assignment.service.ts`. Esse metodo tenta: 1. fluxo builder publicado; 2. fluxo configuravel legado; diff --git a/Whatsapp.md b/Whatsapp.md index 49ffbe3..27eda01 100644 --- a/Whatsapp.md +++ b/Whatsapp.md @@ -2,15 +2,17 @@ Base tecnica: -- Controller: `src/modules/whatsapp/whatsapp.controller.ts` -- Service: `src/modules/whatsapp/whatsapp.service.ts` -- Assignment: `src/modules/whatsapp/whatsapp-assignment.service.ts` -- Gateway: `src/modules/whatsapp/whatsapp.gateway.ts` -- Prefixo: `/whatsapp` +- Controller: `src/modules/whatsapp/whatsapp.controller.ts` +- Service: `src/modules/whatsapp/whatsapp.service.ts` +- Attendance Assignment: `src/modules/attendance/attendance-assignment.service.ts` +- Gateway: `src/modules/whatsapp/whatsapp.gateway.ts` +- Prefixo: `/whatsapp` ## Responsabilidade -Integra com `whatsapp-web.js`, controla chats, mensagens, midia, templates, abertura ativa, fila, atribuicao, transferencia e triagem do Agente Virtual. +Integra com `whatsapp-web.js`, controla sessao, QR Code, chats, mensagens, midia e templates do canal WhatsApp. + +Fila, atribuicao, transferencia, fechamento e triagem do atendimento ficam no modulo `attendance`, mas algumas rotas continuam expostas em `/whatsapp` por compatibilidade com o frontend. ## Endpoints @@ -45,13 +47,12 @@ Integra com `whatsapp-web.js`, controla chats, mensagens, midia, templates, aber - Dispara roteamento do bot ao receber mensagem. - Executa abertura ativa com template. -### `whatsapp-assignment.service.ts` - -- Garante schema complementar em `onModuleInit()`. -- Controla fila e atribuicao em `whatsapp_chat_atribuicoes`. -- Impede envio quando atendimento ativo aguarda resposta do cliente. -- Roteia conversas por area, fluxo configurado ou arvore do bot. -- Monta observacao de transferencia do Agente Virtual. +### `attendance-assignment.service.ts` + +- Controla fila e atribuicao em `whatsapp_chat_atribuicoes`. +- Impede envio quando atendimento ativo aguarda resposta do cliente. +- Roteia conversas por area, fluxo configurado ou arvore do bot. +- Monta observacao de transferencia do Agente Virtual. ## Eventos em tempo real @@ -61,8 +62,16 @@ O `whatsapp.gateway.ts` usa Socket.IO para notificar o frontend sobre: - atualizacoes de chat; - status/QR quando aplicavel. -## Code review - -- `whatsapp-assignment.service.ts` concentra regra critica e deve receber testes. -- Permissao de agente/admin ainda precisa ser validada no backend. -- `whatsapp-web.js` e bom para demo/MVP controlado, mas para producao robusta avaliar WhatsApp Cloud API. +## Code review + +- `attendance-assignment.service.ts` concentra regra critica e deve receber testes. +- Permissao de agente/admin ainda precisa ser validada no backend. +- `whatsapp-web.js` e bom para demo/MVP controlado, mas para producao robusta avaliar WhatsApp Cloud API. + +## Proximos passos + +- Persistir conversas e mensagens no PostgreSQL para auditoria. +- Guardar anexos fora do banco, com metadados em `message_attachments` e arquivo em VM Linux, AWS S3, Azure Blob ou SharePoint. +- Evoluir `chat` para modulo omnichannel, recebendo eventos normalizados de WhatsApp, Email, SMS e Instagram. +- Substituir `whatsapp-web.js` pela API oficial da Meta. +- Adicionar IA no primeiro atendimento, com configuracao no painel admin para escolher o provedor/modelo de IA.