DOCS: Adicionado proximos passos

Rafael Alves Lopes 2026-06-01 14:26:36 -03:00
parent b38ac11dcd
commit ef85a99ea6
2 changed files with 28 additions and 19 deletions

@ -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;

@ -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.