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>
This commit is contained in:
38
docs/WHATSAPP-SETUP.md
Normal file
38
docs/WHATSAPP-SETUP.md
Normal file
@@ -0,0 +1,38 @@
|
||||
# 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`
|
||||
Reference in New Issue
Block a user