Cola y Trabajadores
Configuración → Avanzado → Cola y Trabajadores muestra el controlador de cola actual, el tipo de conexión y el estado del trabajador para tu instalación de LeadHub.
Qué Hace la Cola
La cola procesa todo el trabajo en segundo plano en LeadHub:
| Tarea | Prioridad de Cola |
|---|---|
| Enviar correos (transaccionales, secuencias) | Alta |
| Procesar webhooks entrantes de fuentes de clientes | Alta |
| Llamar APIs de integración salientes (sincronización CRM, Zapier, etc.) | Normal |
| Ejecutar pasos de automatización (retrasos, acciones) | Normal |
| Generar informes y exportaciones | Baja |
| Enviar mensajes SMS / WhatsApp | Normal |
Cuando llega un cliente o se activa una automatización, la acción se pone en cola en lugar de ejecutarse sincrónicamente. Esto evita que las llamadas lentas a APIs bloqueen la solicitud web.
Controladores de Cola
| Controlador | Descripción |
|---|---|
| Archivo (base de datos) | Predeterminado. Los trabajos se almacenan en la tabla jobs de la base de datos. Procesados por el trabajo cron. No se necesita Redis ni Supervisor. |
| Redis | Cola más rápida, en memoria. Requiere Redis y Supervisor (o Horizon) en el servidor. Recomendado para instalaciones de alto volumen. |
| Sync | Ejecuta trabajos inmediatamente en proceso. Solo usado en entornos de prueba. No usar en producción. |
Hosting compartido: La cola basada en archivos predeterminada de LeadHub funciona en cualquier plan de hosting compartido con un trabajo cron. No necesitas Redis, Supervisor ni acceso SSH.
Procesar la Cola (Trabajo Cron)
La cola es procesada por un único trabajo cron que debe configurarse en tu servidor.
Hosting Compartido con cPanel
- Inicia sesión en cPanel → Trabajos Cron.
- Establece el horario en cada minuto (
* * * * *). - Establece el comando en:
Reemplaza la ruta con la ruta absoluta a tu instalación de LeadHub.
php /home/tuusuario/public_html/cron.php >> /dev/null 2>&1
VPS / Servidor Dedicado (crontab de Linux)
* * * * * cd /var/www/leadhub && php artisan queue:work --once --max-time=55 >> /dev/null 2>&1
O usando un gestor de procesos (Supervisor):
[program:leadhub-worker]
command=php /var/www/leadhub/artisan queue:work --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
user=www-data
Página de Estado del Trabajador
La página Cola y Trabajadores en el panel de administración muestra:
| Información | Descripción |
|---|---|
| Conexión | Nombre de la conexión de cola actual (de config/queue.php) |
| Controlador | El controlador de cola en uso (database, redis, sync) |
| Horizon | Si Laravel Horizon está instalado (para monitoreo avanzado basado en Redis) |
Esta página es de solo lectura. Para cambiar el controlador de cola, actualiza
QUEUE_CONNECTIONen tu archivo.env.
Trabajos Fallidos
Si un trabajo en cola falla (p. ej., una API de integración devuelve un error), LeadHub reintenta hasta 3 veces con retroceso exponencial. Después de 3 fallos, el trabajo se marca como fallido.
Las entregas de integración fallidas son visibles en:
- Integraciones → Registro de Webhooks — para fallos de webhooks salientes
- Integraciones → Registros de Sincronización — para fallos de sincronización CRM/marketing por correo
Verificar el Estado de la Cola
Señales de que el trabajador de cola funciona correctamente:
- Las automatizaciones se activan en pocos minutos después de un evento
- Las integraciones salientes se ejecutan poco después de que llega un cliente
- Las secuencias de correo se envían según lo programado
- Las exportaciones se completan y están disponibles para descargar
Señales de que la cola NO está funcionando:
- Las automatizaciones nunca se activan
- Las sincronizaciones de integración están atascadas como "pendiente"
- Los correos nunca se envían
Solución: Verifica que tu trabajo cron esté configurado y en ejecución. Usa cPanel → Trabajos Cron para comprobar que la entrada existe y tiene la ruta correcta.
Preguntas Frecuentes
P: ¿Cuánto tiempo tarda un nuevo cliente en sincronizarse con mi CRM? La cola se ejecuta cada minuto por defecto. La mayoría de los clientes se sincronizan en 60–90 segundos después de llegar.
P: ¿Puedo ejecutar múltiples trabajadores para un procesamiento más rápido?
Sí, en servidores VPS/dedicados puedes ejecutar múltiples procesos queue:work a través de Supervisor. En hosting compartido, un único trabajo cron es el máximo.
P: ¿Necesito Redis? No. La cola basada en archivos (base de datos) está lista para producción para volúmenes típicos de clientes (hasta varios miles por día). Para volúmenes muy altos (10,000+ clientes/día), se recomienda Redis.