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>
39 lines
1.3 KiB
Markdown
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`
|