Saltar al contenido principal

Preguntas Frecuentes y Solución de Problemas

Problemas de Instalación​

La página está en blanco después de la instalación​

Una página en blanco casi siempre indica un error de PHP que está siendo suprimido silenciosamente.

  1. Abre el archivo storage/logs/laravel.log en un gestor de archivos (el Administrador de Archivos de tu panel de control de alojamiento, o FTP). Mira las últimas líneas — habrá un mensaje de error explicando qué salió mal.
  2. Causas comunes:
    • Extensiones PHP faltantes (comprueba la página de requisitos)
    • Permisos de archivo incorrectos (consulta la sección de permisos a continuación)
    • Credenciales de base de datos incorrectas en el archivo de configuración

Error 500 Internal Server Error​

Significa que el servidor encontró un error del que no pudo recuperarse.

  1. Comprueba storage/logs/laravel.log para ver el mensaje de error real.
  2. Comprueba el registro de errores de tu servidor web — en cPanel, está en Registros → Registro de Errores.
  3. Causas más comunes:
    • Credenciales de base de datos incorrectas
    • El valor APP_KEY falta o es demasiado corto en el archivo de configuración
    • Una extensión PHP requerida no está habilitada

El instalador me sigue redirigiendo al inicio​

Esto generalmente significa que el instalador no puede escribir en el disco. El proceso de instalación crea un archivo llamado storage/installed.lock cuando termina. Si no puede crear ese archivo, cree que la instalación nunca se completó.

Solución: Asegúrate de que la carpeta storage/ y todo lo que contiene sea escribible. En el gestor de archivos de tu alojamiento, haz clic derecho en la carpeta storage y establece los permisos a 755 o 775.

Error de conexión a la base de datos​

El mensaje de error en el instalador dirá "Connection refused" o "Access denied".

  • Verifica el nombre de host de la base de datos, el nombre de la base de datos, el nombre de usuario y la contraseña. Todo esto se configura cuando creas una base de datos en cPanel.
  • El nombre de host de la base de datos para alojamiento cPanel es casi siempre localhost.
  • Asegúrate de que el usuario de la base de datos tiene permisos completos en la base de datos.

Errores de permisos (no se puede escribir en storage o cache)​

LeadHub necesita escribir en ciertas carpetas. Si ves errores sobre no poder escribir archivos:

En el gestor de archivos de tu alojamiento, asegúrate de que estas carpetas tengan permiso 755 (algunos hosts necesitan 775):

  • storage/
  • storage/logs/
  • storage/framework/
  • storage/app/
  • bootstrap/cache/

Problemas de Email​

Los emails no se están enviando​

  1. Ve a Configuración → Email y comprueba que todos los campos estén correctamente completados.
  2. Haz clic en Enviar Email de Prueba e ingresa tu propia dirección de email.
  3. Si el email de prueba no llega, comprueba el archivo storage/logs/laravel.log para cualquier error SMTP.
  4. Asegúrate de que el cron job esté ejecutándose — los emails van a través de la cola de trabajos, que necesita el cron job para procesarlos. Consulta la sección de Cron Job a continuación.

Los emails van a spam​

  • La causa más común es que la dirección "From Email" no coincide con un dominio autorizado por tu proveedor SMTP.
  • Agrega registros SPF y DKIM a la configuración DNS de tu dominio. Tu proveedor de email (SendGrid, Mailgun, etc.) te dirá exactamente qué agregar.
  • Evita usar Gmail personal o direcciones de email gratuitas como dirección From para email transaccional. Usa un servicio de envío profesional.

El email de prueba falla​

  • Verifica tus credenciales SMTP — incluso un carácter incorrecto causa fallo.
  • Para Gmail, debes usar una Contraseña de Aplicación, no tu contraseña habitual.
  • El puerto 587 puede estar bloqueado en alojamiento compartido. Prueba el puerto 465 con SSL en su lugar.
  • Pregunta a tu proveedor de alojamiento si el SMTP saliente está permitido en el puerto que estás usando.

Problemas con el Cron Job​

Las automatizaciones no se ejecutan / Los informes no se entregan​

LeadHub usa un cron job para procesar todo el trabajo en segundo plano: automatizaciones, envío de emails, entrega de informes y tareas programadas.

El comando del cron job es:

php /path/to/your/leadhub/cron.php

Reemplaza /path/to/your/leadhub/ con la ruta real en tu servidor.

Para configurarlo en cPanel:

  1. Inicia sesión en cPanel.
  2. Ve a Cron Jobs.
  3. Establece la frecuencia en Cada Minuto (rellena * para los cinco campos).
  4. El comando: php /home/yourusername/public_html/cron.php
  5. Haz clic en Agregar Nuevo Cron Job.

Si no estás seguro de la ruta, consulta con tu proveedor de alojamiento, o mira la ruta completa que se muestra en el Administrador de Archivos de cPanel cuando navegas a la carpeta raíz de tu sitio.

No hay otros comandos para ejecutar. No intentes ejecutar comandos artisan desde cron — usa solo cron.php.

Cómo verificar si el cron job se está ejecutando​

En cPanel, ve a Cron Jobs y mira el cron job que creaste. Si está listado allí, está programado. Para verificar que se está ejecutando realmente, puedes agregar temporalmente >> /tmp/crontest.log 2>&1 al final del comando, esperar un minuto y luego revisar el archivo para ver la salida.

Problemas con Fuentes de Leads​

El webhook no recibe leads​

  1. Verifica que la URL del webhook que configuraste en el servicio externo (Facebook, Typeform, etc.) sea exactamente correcta, incluido el token al final.
  2. En LeadHub, ve a la configuración de integración o fuente de leads y busca un botón "Test" o "Ping" — úsalo para verificar la conexión.
  3. Comprueba storage/logs/laravel.log para cualquier error de webhook entrante.
  4. Asegúrate de que tu servidor sea accesible desde internet (no detrás de un firewall que bloquee las conexiones entrantes).

La bandeja de entrada IMAP no está siendo consultada​

El sondeo IMAP (verificar una bandeja de entrada de email en busca de leads) requiere que el cron job esté ejecutándose. Consulta la sección de Cron Job anterior. Si el cron job se está ejecutando pero IMAP aún no está sondeando:

  1. Comprueba la configuración de conexión IMAP en la configuración de integración.
  2. Asegúrate de que la extensión PHP php-imap esté instalada en tu servidor.
  3. Comprueba storage/logs/laravel.log para errores de conexión IMAP.

Problemas de Rendimiento en Alojamiento Compartido​

La aplicación es lenta o se agota el tiempo​

El alojamiento compartido tiene recursos limitados. Algunas cosas que puedes hacer:

Aumentar el límite de memoria PHP: Agrega esta línea al archivo .htaccess en la carpeta raíz de tu sitio:

php_value memory_limit 256M

O pide a tu proveedor de alojamiento que lo aumente en tu configuración PHP.

Habilitar caché: Asegúrate de que tu archivo de configuración tenga CACHE_DRIVER=file o CACHE_DRIVER=database. Estos funcionan en alojamiento compartido sin configuración adicional.

Reducir el tamaño de los lotes de cola: Si tu servidor está teniendo problemas con importaciones grandes u operaciones masivas, procesa lotes más pequeños.

Cómo Ver los Registros​

El archivo de registro principal está en:

storage/logs/laravel.log

Puedes verlo en el gestor de archivos de tu alojamiento navegando hasta él y haciendo clic para abrirlo. Mira la parte inferior del archivo — ahí es donde aparecen los errores más recientes.

El archivo de registro puede crecer con el tiempo. Puedes eliminarlo de forma segura (la aplicación crea uno nuevo automáticamente).

Cómo Limpiar el Caché​

Si ves datos desactualizados o páginas que no reflejan cambios recientes, limpiar el caché puede ayudar.

Haz esto a través del gestor de archivos de tu alojamiento:

  1. Navega a bootstrap/cache/
  2. Elimina todos los archivos dentro de esta carpeta (pero no la carpeta en sí)
  3. Navega a storage/framework/cache/data/
  4. Elimina todos los archivos y subcarpetas dentro de esta carpeta

El caché se reconstruye automáticamente en la próxima carga de página.

No elimines las carpetas en sí — solo el contenido.

Cómo Re-ejecutar el Instalador​

Si necesitas pasar por el asistente de instalación nuevamente (por ejemplo, después de mover a una nueva base de datos):

  1. En el gestor de archivos de tu alojamiento, navega a la carpeta storage/.
  2. Elimina el archivo llamado installed.lock.
  3. Visita tu sitio en un navegador — el instalador comenzará automáticamente.

Esto no elimina tus datos. Solo permite que el instalador se ejecute nuevamente. Tu base de datos y archivos permanecen intactos.

Errores Comunes en el Archivo de Configuración​

El archivo de configuración (.env) en la carpeta raíz de tu sitio controla muchas configuraciones. Errores comunes:

  • APP_KEY faltante — debe ser una cadena aleatoria de 32 caracteres. Si falta o es incorrecta, la aplicación no iniciará.
  • DB_HOST incorrecto — para alojamiento compartido, esto es casi siempre localhost. No uses el nombre de tu dominio.
  • Espacios alrededor de = — el formato es KEY=value sin espacios. KEY = value no funciona.
  • Valores con caracteres especiales sin comillas — si tu contraseña de base de datos contiene # o &, envuelve todo el valor entre comillas dobles: DB_PASSWORD="my#p@ss&word"

Obtener Ayuda​

Si no puedes resolver un problema usando esta documentación:

  1. Comprueba el archivo de registro en storage/logs/laravel.log primero. El mensaje de error allí a menudo te dice exactamente qué está mal.
  2. Busca en los comentarios de CodeCanyon en la página del producto LeadHub — muchos problemas comunes han sido respondidos allí.
  3. Abre un ticket de soporte en CodeCanyon yendo a la página del producto LeadHub y haciendo clic en Soporte. Adjunta la sección relevante de tu archivo de registro al hacerlo.

Al contactar soporte, siempre incluye:

  • Tu entorno de alojamiento (alojamiento compartido / VPS, qué proveedor)
  • La versión de PHP que ejecuta tu servidor
  • Las últimas líneas de storage/logs/laravel.log