Files
Autoparts-DB/docs/WHATSAPP-SETUP.md
consultoria-as 5f92fe83ba feat(pos): replace Meta Cloud API WhatsApp with Evolution API (self-hosted)
Switch from Meta Business Cloud API to Evolution API for WhatsApp integration.
Evolution API is self-hosted, free, and connects via WhatsApp Web QR code scan.

- Add docker-compose for Evolution API deployment
- Rewrite whatsapp_service.py for Evolution API endpoints
- Add instance management (create, QR, status, logout) to blueprint
- Add QR code scanning UI with connection status indicator
- Add duplicate message prevention in webhook handler
- Update config.py with EVOLUTION_API_URL/KEY (remove old Meta vars)
- Add setup documentation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-05 03:15:52 +00:00

39 lines
1.3 KiB
Markdown

# Configuracion de WhatsApp — Evolution API
## Requisitos
- Docker instalado en el servidor
- Puerto 8080 disponible
## Instalacion
1. `cd /home/Autopartes/docker`
2. `docker-compose -f docker-compose.evolution.yml up -d`
3. Esperar ~30 segundos a que inicie
## Crear base de datos para Evolution
```bash
PGPASSWORD=nexus_autoparts_2026 psql -U nexus -h localhost -c "CREATE DATABASE evolution_api OWNER nexus;"
```
## Conectar WhatsApp
1. Ir a /pos/whatsapp en el POS
2. Click "Conectar WhatsApp"
3. Escanear el QR con tu telefono (WhatsApp > Dispositivos vinculados > Vincular)
4. Listo — los mensajes empiezan a llegar
## Notas
- Cada refaccionaria puede conectar su propio numero
- La sesion se mantiene mientras el Docker este corriendo
- Si el telefono pierde internet por >14 dias, hay que re-escanear
- El nombre de la instancia se deriva del nombre de base de datos del tenant
## Variables de entorno (opcionales)
```bash
EVOLUTION_API_URL=http://localhost:8080 # URL de Evolution API
EVOLUTION_API_KEY=nexus-evolution-key-2026 # API key configurada en docker-compose
```
## Troubleshooting
- Si el QR no aparece, verificar que el contenedor este corriendo: `docker ps`
- Si el webhook no recibe mensajes, verificar que WEBHOOK_GLOBAL_URL apunte al servidor Flask
- Logs: `docker logs evolution-api`