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