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

1.3 KiB

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

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)

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