Sothis/omnichannel-backend
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
Knowledge-Base-e-Agente-Virtual.md

@ -53,7 +53,7 @@ Permite configurar o fluxo do Agente Virtual Sothis:
## Relacao com WhatsApp ## 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; 1. fluxo builder publicado;
2. fluxo configuravel legado; 2. fluxo configuravel legado;

45
Whatsapp.md

@ -2,15 +2,17 @@
Base tecnica: Base tecnica:
- Controller: `src/modules/whatsapp/whatsapp.controller.ts` - Controller: `src/modules/whatsapp/whatsapp.controller.ts`
- Service: `src/modules/whatsapp/whatsapp.service.ts` - Service: `src/modules/whatsapp/whatsapp.service.ts`
- Assignment: `src/modules/whatsapp/whatsapp-assignment.service.ts` - Attendance Assignment: `src/modules/attendance/attendance-assignment.service.ts`
- Gateway: `src/modules/whatsapp/whatsapp.gateway.ts` - Gateway: `src/modules/whatsapp/whatsapp.gateway.ts`
- Prefixo: `/whatsapp` - Prefixo: `/whatsapp`
## Responsabilidade ## 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 ## Endpoints
@ -45,13 +47,12 @@ Integra com `whatsapp-web.js`, controla chats, mensagens, midia, templates, aber
- Dispara roteamento do bot ao receber mensagem. - Dispara roteamento do bot ao receber mensagem.
- Executa abertura ativa com template. - Executa abertura ativa com template.
### `whatsapp-assignment.service.ts` ### `attendance-assignment.service.ts`
- Garante schema complementar em `onModuleInit()`. - Controla fila e atribuicao em `whatsapp_chat_atribuicoes`.
- Controla fila e atribuicao em `whatsapp_chat_atribuicoes`. - Impede envio quando atendimento ativo aguarda resposta do cliente.
- Impede envio quando atendimento ativo aguarda resposta do cliente. - Roteia conversas por area, fluxo configurado ou arvore do bot.
- Roteia conversas por area, fluxo configurado ou arvore do bot. - Monta observacao de transferencia do Agente Virtual.
- Monta observacao de transferencia do Agente Virtual.
## Eventos em tempo real ## Eventos em tempo real
@ -61,8 +62,16 @@ O `whatsapp.gateway.ts` usa Socket.IO para notificar o frontend sobre:
- atualizacoes de chat; - atualizacoes de chat;
- status/QR quando aplicavel. - status/QR quando aplicavel.
## Code review ## Code review
- `whatsapp-assignment.service.ts` concentra regra critica e deve receber testes. - `attendance-assignment.service.ts` concentra regra critica e deve receber testes.
- Permissao de agente/admin ainda precisa ser validada no backend. - 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. - `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.