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>
1.3 KiB
1.3 KiB
Configuracion de WhatsApp — Evolution API
Requisitos
- Docker instalado en el servidor
- Puerto 8080 disponible
Instalacion
cd /home/Autopartes/dockerdocker-compose -f docker-compose.evolution.yml up -d- Esperar ~30 segundos a que inicie
Crear base de datos para Evolution
PGPASSWORD=nexus_autoparts_2026 psql -U nexus -h localhost -c "CREATE DATABASE evolution_api OWNER nexus;"
Conectar WhatsApp
- Ir a /pos/whatsapp en el POS
- Click "Conectar WhatsApp"
- Escanear el QR con tu telefono (WhatsApp > Dispositivos vinculados > Vincular)
- 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)
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