Saltar al contenido principal

🔧 Solución de Problemas

Problemas de Instalación​

"Cannot connect to database"​

  1. Prueba 127.0.0.1 en lugar de localhost
  2. Verifica las credenciales vía phpMyAdmin
  3. Revisa los privilegios del usuario MySQL
  4. En cPanel, el host de BD es siempre localhost

El instalador redirige a la página principal​

config/database.php ya existe de un intento anterior. Elimínalo y prueba de nuevo.

El login muestra página en blanco​

Revisa el log de errores de PHP para Fatal error o Call to undefined function. Lo más común: falta la extensión pdo_mysql.

Los Mensajes No Aparecen​

Los mensajes de webhook no llegan​

  1. ¿Está configurada la URL del webhook en el panel del proveedor?
  2. ¿La URL usa HTTPS?
  3. ¿Está activo el canal (toggle encendido)?
  4. Revisa la tabla webhook_events para entradas failed

Los mensajes de email no aparecen​

  1. ¿Está ejecutándose la tarea cron?
  2. ¿Está cargada la extensión PHP imap?
  3. ¿Son correctas las credenciales IMAP?

Las actualizaciones en tiempo real SSE no funcionan​

  1. Revisa DevTools del navegador → Red para la solicitud /sse
  2. ¿Buffering de Nginx? Establece X-Accel-Buffering: no
  3. ¿CDN/Cloudflare? Habilita el modo streaming
  4. max_execution_time de PHP debe ser al menos 60 segundos

Fallos de Envío​

La respuesta de WhatsApp no se entrega​

  1. ¿Es válido el Access Token? Los tokens temporales expiran en ~24 horas
  2. ¿El número de teléfono está en formato E.164 sin +?
  3. ¿La app de Meta sigue en modo Development?

Las respuestas de email no llegan​

PHP mail() puede no estar configurado en VPS. Configura Postfix o usa una API de email.

Errores Comunes de PHP​

ErrorSolución
Call to undefined function imap_open()Hosting compartido: cPanel → Select PHP Version → habilitar imap. VPS: sudo apt install php-imap
Permission denied: config/database.phpEstablece config/ a 755 vía Administrador de Archivos o chmod 755 config/
Maximum execution time exceededEstablece max_execution_time = 120 en php.ini

Obtener Más Ayuda​

  1. Log de Errores PHP — cPanel: Logs → Error Log. VPS: /var/log/apache2/error.log
  2. Log de Eventos Webhook — inspecciona la tabla webhook_events en phpMyAdmin
  3. Salida del Cron — visita tu URL de cron en el navegador
  4. Consola del Navegador — F12 → Consola para errores de JavaScript