Guía de Configuración

Marca Blanca (White-Label)

Personaliza completamente la apariencia de la plataforma para que refleje tu marca:

Desde el Panel Admin

1. Ingresa al panel como Superadmin
2. Ve a Configuración → Personalización
3. Cambia:
   • Logo principal: Se muestra en navbar y login (recomendado: 200x50 px, PNG transparente)
   • Favicon: Icono de pestaña (32x32 px)
   • Nombre del producto: Aparece en el título y breadcrumbs
   • Colores: Color primario, secundario, acento
   • Footer: Texto personalizado del pie de página
4. Guarda los cambios — se aplican inmediatamente

Desde el archivo .env

# Nombre del producto
APP_NAME="Tu Marca Aquí"

# URL base
APP_URL=https://tu-dominio.com

# Color primario (hexadecimal)
APP_PRIMARY_COLOR=#10b981

# Ruta del logo (relativa a /public)
APP_LOGO_PATH=img/logo-custom.png
APP_FAVICON_PATH=img/favicon.ico

Configuración de Dominio

Dominio Principal

# En .env
APP_URL=https://tu-dominio.com

# En Nginx (sites-available)
server_name tu-dominio.com www.tu-dominio.com;

Subdominio para Tenants (Opcional)

# Si quieres que cada tenant tenga su subdominio:
# empresa1.tu-dominio.com
# empresa2.tu-dominio.com

# Configurar wildcard DNS:
*.tu-dominio.com → IP del servidor

# En Nginx:
server_name *.tu-dominio.com;

Configuración de Idioma

La plataforma soporta 4 idiomas completamente traducidos:

Código	Idioma	Archivos
es	🇪🇸 Español	resources/lang/es/
en	🇺🇸 English	resources/lang/en/
fr	🇫🇷 Français	resources/lang/fr/
pt	🇧🇷 Português	resources/lang/pt/

# En .env — cambiar idioma predeterminado
APP_LOCALE=es
APP_FALLBACK_LOCALE=es

Configuración de Evolution API (WhatsApp)

AutomatizaNegocios utiliza Evolution API como motor de conexión con WhatsApp. Evolution API es un servicio de código abierto que gestiona las sesiones de WhatsApp, el envío y recepción de mensajes, y la administración de múltiples dispositivos.

Al centralizar la conexión en Evolution API, el sistema queda desacoplado de los cambios internos de WhatsApp. Si WhatsApp actualiza su protocolo, solo necesitarás actualizar tu instancia de Evolution API, sin modificar nada en la plataforma SaaS.

¿Qué es Evolution API?

• API REST de código abierto para WhatsApp
• Soporta múltiples instancias (un dispositivo por instancia)
• Gestión de mensajes de texto, imágenes, documentos, audio y video
• Webhooks para recibir mensajes entrantes en tiempo real
• Compatible con WhatsApp Web (escaneo QR, sin API oficial)
• GitHub: github.com/EvolutionAPI/evolution-api

Variables de entorno (.env)

# =======================================
# EVOLUTION API — Conexión con WhatsApp
# =======================================

# URL de tu instancia de Evolution API
# Puede estar en el mismo servidor o en uno separado
EVOLUTION_API_URL=https://evo.tu-dominio.com

# API Key de autenticación (la generas al instalar Evolution API)
EVOLUTION_API_KEY=tu-api-key-secreta-aqui

# Versión de la API (por defecto v2)
EVOLUTION_API_VERSION=v2

# Webhook URL (donde Evolution API notificará mensajes entrantes)
# Debe apuntar a tu instalación de AutomatizaNegocios
EVOLUTION_WEBHOOK_URL=https://tu-dominio.com/api/webhook/evolution

Instalación de Evolution API

Puedes instalar Evolution API en el mismo servidor que tu SaaS o en un servidor separado (recomendado para producción con alto volumen):

# 1. Clonar el repositorio
git clone https://github.com/EvolutionAPI/evolution-api.git
cd evolution-api

# 2. Copiar archivo de configuración
cp .env.example .env

# 3. Configurar las variables en .env:
#    - SERVER_URL=https://evo.tu-dominio.com
#    - AUTHENTICATION_API_KEY=tu-api-key-secreta
#    - DATABASE_CONNECTION_URI=mongodb://localhost:27017

# 4. Instalar dependencias e iniciar
npm install
npm run build
npm start

# O con Docker (recomendado):
docker compose up -d

Configuración Recomendada

Variable	Descripción	Ejemplo
EVOLUTION_API_URL	URL base donde corre Evolution API	https://evo.miempresa.com
EVOLUTION_API_KEY	API Key para autenticación	B6D711FC...
EVOLUTION_API_VERSION	Versión de la API	v2
EVOLUTION_WEBHOOK_URL	Webhook para mensajes entrantes	https://app.com/api/webhook/evolution

Verificar la Conexión

Desde el Panel Admin → Configuración → WhatsApp puedes verificar el estado de la conexión con Evolution API:

1. Ingresa la URL y API Key
2. Haz clic en "Probar conexión"
3. Si la conexión es exitosa, verás un indicador verde ✅
4. Si falla, verifica:
   • Que la URL sea accesible desde el servidor
   • Que el API Key sea correcto
   • Que Evolution API esté corriendo (pm2 status o docker ps)
   • Que los puertos estén abiertos en el firewall

# Verificar manualmente desde terminal:
curl -X GET https://evo.tu-dominio.com/instance/fetchInstances \
  -H "apikey: tu-api-key-aqui"

# Respuesta esperada: lista de instancias (array JSON)
# Si obtienes error 401: API Key incorrecta
# Si obtienes timeout: URL inaccesible

Arquitectura de la Conexión

┌──────────────────────┐
│   AutomatizaNegocios │  ← Tu plataforma SaaS
│   (Laravel + Vue.js) │
└──────────┬───────────┘
           │ REST API
           ▼
┌──────────────────────┐
│    Evolution API      │  ← Motor de WhatsApp
│   (Node.js + MongoDB) │
└──────────┬───────────┘
           │ WebSocket
           ▼
┌──────────────────────┐
│   WhatsApp Web        │  ← Sesión de WhatsApp
│   (Multi-dispositivo) │
└──────────────────────┘

Cada tenant puede tener múltiples dispositivos. Cada dispositivo crea una instancia en Evolution API con su propia sesión de WhatsApp.

Configuración de Email (SMTP)

Métodos de Pago

Desde el panel Admin → Configuración → Pagos:

• Transferencia bancaria: Configura número de cuenta, banco, titular
• Yape: Número y nombre (solo Perú)
• Plin: Número y nombre (solo Perú)
• Nequi: Número (Colombia)
• PayPal: Email de PayPal
• Stripe: Próximamente

Configurar Planes de Precios

1. Ve a Admin → Planes
2. Crea un nuevo plan:
   • Nombre: Ej. "Emprendedor"
   • Precio: En tu moneda local
   • Límite de mensajes: Número o -1 para ilimitado
   • Límite de dispositivos: Número o -1 para ilimitado
   • Período: Mensual o Anual
   • Destacado: Marcar como "recomendado"
3. Activa el plan — los clientes podrán verlo al registrarse

Modo Oscuro / Claro

Los usuarios pueden cambiar entre tema claro y oscuro desde su perfil. El admin puede configurar el tema predeterminado:

# En .env
APP_DEFAULT_THEME=light  # o 'dark'

Seguridad Avanzada

# Rate limiting (intentos por minuto)
APP_RATE_LIMIT=60

# Tiempo de expiración del token (minutos)
PASSPORT_TOKEN_EXPIRATION=60
PASSPORT_REFRESH_TOKEN_EXPIRATION=43200

# Forzar HTTPS
FORCE_HTTPS=true

Zona Horaria

# En .env
APP_TIMEZONE=America/Lima

# Zonas horarias comunes en LATAM:
# America/Lima         (UTC-5)
# America/Bogota       (UTC-5)
# America/Mexico_City  (UTC-6)
# America/Santiago     (UTC-3/-4)
# America/Buenos_Aires (UTC-3)
# America/Sao_Paulo    (UTC-3)