a92a7efccc
- README principal con descripción del proyecto - Documento de diseño completo (arquitectura, DB, flujos) - Documentación de API REST y WebSocket - Guía del Flow Builder (30+ tipos de nodos) - Documentación de integración con Odoo - Guía de despliegue con Docker - Esquema de base de datos - Estructura de carpetas del proyecto - Archivo .env.example con todas las variables Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
142 lines
5.5 KiB
Markdown
142 lines
5.5 KiB
Markdown
# WhatsApp Centralizado
|
|
|
|
Plataforma de mensajería centralizada con automatización de chatbots, gestión multi-agente e integración profunda con Odoo.
|
|
|
|
## Descripción
|
|
|
|
WhatsApp Centralizado es una solución empresarial similar a Kommo, Wasapi, ManyChat y Brevo, diseñada para:
|
|
|
|
- **Automatizar conversaciones** con un potente Flow Builder visual (drag & drop)
|
|
- **Gestionar equipos de agentes** con colas inteligentes, SLA y métricas
|
|
- **Integrar con Odoo** de forma bidireccional (CRM, Ventas, Inventario, Helpdesk, etc.)
|
|
- **Conectar múltiples números** de WhatsApp desde una sola plataforma
|
|
|
|
## Características Principales
|
|
|
|
### Flow Builder Visual
|
|
- 30+ tipos de nodos (mensajes, lógica, validación, acciones)
|
|
- Editor drag & drop con React Flow
|
|
- Variables y contexto de conversación
|
|
- A/B Testing integrado
|
|
- Integración con IA (GPT, Claude, Ollama)
|
|
- Sub-flujos reutilizables
|
|
|
|
### Gestión Multi-Agente
|
|
- Sistema de colas (Ventas, Soporte, etc.)
|
|
- Asignación inteligente (round-robin, least-busy, skill-based)
|
|
- Transferencia bot → humano → bot
|
|
- Panel de supervisor en tiempo real
|
|
- SLA tracking con alertas
|
|
- Encuestas CSAT integradas
|
|
|
|
### Integración Odoo
|
|
- Conexión bidireccional via XML-RPC
|
|
- 8 módulos soportados (Contactos, CRM, Ventas, Inventario, Helpdesk, Facturación, Calendario, Productos)
|
|
- 20+ acciones disponibles en flujos
|
|
- Automatizaciones Odoo → WhatsApp
|
|
- Módulo Odoo con widget de chat
|
|
|
|
## Stack Tecnológico
|
|
|
|
| Componente | Tecnología |
|
|
|------------|------------|
|
|
| WhatsApp Core | Node.js + TypeScript + Baileys |
|
|
| API Gateway | Python + FastAPI |
|
|
| Flow Engine | Python |
|
|
| Frontend | React + TypeScript |
|
|
| Base de Datos | PostgreSQL + Redis |
|
|
| Despliegue | Docker + Docker Compose |
|
|
|
|
## Arquitectura
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ FRONTEND (React) │
|
|
│ Dashboard │ Inbox Chat │ Flow Builder (React Flow) │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ API GATEWAY (FastAPI) │
|
|
│ JWT Auth │ REST API │ WebSocket (tiempo real) │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
┌───────────────┼───────────────┐
|
|
▼ ▼ ▼
|
|
┌──────────────────┐ ┌──────────────┐ ┌──────────────────────────┐
|
|
│ WHATSAPP CORE │ │ FLOW ENGINE │ │ INTEGRATIONS │
|
|
│ (Node.js) │ │ (Python) │ │ (Python) │
|
|
│ Baileys │ │ Motor bot │ │ Odoo, Webhooks │
|
|
└──────────────────┘ └──────────────┘ └──────────────────────────┘
|
|
│
|
|
┌─────────┴─────────┐
|
|
▼ ▼
|
|
┌──────────┐ ┌──────────┐
|
|
│PostgreSQL│ │ Redis │
|
|
└──────────┘ └──────────┘
|
|
```
|
|
|
|
## Inicio Rápido
|
|
|
|
### Requisitos
|
|
- Docker 24.0+
|
|
- Docker Compose 2.20+
|
|
- 4GB RAM mínimo (8GB recomendado)
|
|
|
|
### Instalación
|
|
|
|
```bash
|
|
# Clonar repositorio
|
|
git clone https://git.consultoria-as.com/tu-usuario/WhatsAppCentralizado.git
|
|
cd WhatsAppCentralizado
|
|
|
|
# Copiar configuración
|
|
cp .env.example .env
|
|
|
|
# Editar variables de entorno
|
|
nano .env
|
|
|
|
# Iniciar servicios
|
|
docker-compose up -d
|
|
|
|
# Aplicar migraciones
|
|
docker-compose exec api-gateway alembic upgrade head
|
|
|
|
# Crear usuario admin
|
|
docker-compose exec api-gateway python scripts/create_admin.py
|
|
```
|
|
|
|
### Acceso
|
|
- Frontend: http://localhost:3000
|
|
- API: http://localhost:8000
|
|
- Docs API: http://localhost:8000/docs
|
|
|
|
## Documentación
|
|
|
|
- [Diseño del Sistema](docs/plans/2026-01-29-whatsapp-centralizado-design.md)
|
|
- [Arquitectura](docs/architecture/README.md)
|
|
- [API Reference](docs/api/README.md)
|
|
- [Flow Builder](docs/flow-builder/README.md)
|
|
- [Integración Odoo](docs/odoo-integration/README.md)
|
|
- [Guía de Despliegue](docs/deployment/README.md)
|
|
|
|
## Roadmap
|
|
|
|
- [x] Diseño y arquitectura
|
|
- [ ] Fase 1: Fundación (WhatsApp Core + API + Frontend básico)
|
|
- [ ] Fase 2: Flow Engine Básico
|
|
- [ ] Fase 3: Inbox Avanzado + Multi-agente
|
|
- [ ] Fase 4: Flow Engine Avanzado
|
|
- [ ] Fase 5: Integración Odoo Completa
|
|
- [ ] Fase 6: Módulo Odoo
|
|
- [ ] Fase 7: Reportes y Analytics
|
|
- [ ] Fase 8: Multi-canal (Email, SMS)
|
|
|
|
## Licencia
|
|
|
|
Propietario - Todos los derechos reservados.
|
|
|
|
## Contacto
|
|
|
|
Desarrollado para uso interno empresarial.
|