DOCS: Adicionado proximos passos
parent
b38ac11dcd
commit
ef85a99ea6
@ -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;
|
||||
|
||||
45
Whatsapp.md
45
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.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user