Saltar al contenido principal

Solución de problemas

Si tienes problemas para conectar tu cuenta de correo o sincronizar correos, sigue esta lista de verificación para investigar y resolver problemas comunes.

1. Revisar el registro de actividad​

Ve a Utilidades → Registro de actividad dentro de Perfex CRM para ver mensajes de error relacionados con la conexión IMAP o fallos de sincronización.

2. Activar modo depuración​

Para obtener una salida de errores más detallada:

  1. Abre index.php en la raíz de tu instalación de Perfex CRM
  2. Localiza la línea:
define('ENVIRONMENT', 'production');
  1. Cámbiala por:
define('ENVIRONMENT', 'development');
  1. Guarda el archivo y recarga la página para ver los mensajes de error detallados
aviso

¡No olvides volver a cambiarlo a production después de las pruebas!

3. Revisar los registros de errores del hosting​

Si la pantalla se queda en blanco o no aparecen errores en Perfex:

  1. Accede al panel de control de tu hosting (por ejemplo, cPanel o Plesk)
  2. Busca "Registro de errores", normalmente en la sección "Métricas" o "Registros"
  3. Busca errores recientes como "memoria agotada", "tiempo de espera agotado" o problemas relacionados con IMAP

4. Verificar la configuración de cron​

Asegúrate de que las tareas cron están ejecutándose. Sin ellas, el módulo Mailbox no puede sincronizar correos.

Consulta la documentación de Perfex CRM o a tu administrador de servidor para solucionar problemas de cron.

5. OAuth vs autenticación por contraseña​

El módulo Mailbox admite dos métodos de autenticación:

Autenticación OAuth2 (recomendada)​

Para usuarios de Gmail y Outlook, OAuth2 es el método recomendado. Es más seguro y no requiere almacenar contraseñas.

Problemas comunes con OAuth:

IncidenciaSolución
"OAuth connection failed"Verifica las credenciales OAuth en Configuración → Ajustes → Ajustes de Mailbox. Comprueba la configuración del URI de redirección. Asegúrate de que la app OAuth tiene los permisos necesarios.
"Token expired"Los tokens OAuth se actualizan automáticamente. Prueba desconectar y volver a conectar. Para Gmail: los tokens caducan a los 7 días en apps no verificadas.
"OAuth not available"OAuth solo está disponible para Gmail y Outlook. Usa autenticación por contraseña para otros proveedores.

Autenticación por contraseña​

Para proveedores que no admiten OAuth2, usa autenticación por contraseña.

Comprueba si tu proveedor requiere una contraseña de aplicación

Algunos proveedores de correo, como Gmail, Yahoo y Outlook, requieren que uses una contraseña de aplicación en lugar de la contraseña real de tu cuenta, especialmente si tienes 2FA (autenticación de dos factores) activada.

Ejemplo: usuarios de Gmail

  1. Ve a https://myaccount.google.com/security
  2. Activa Verificación en dos pasos, si no está ya activada
  3. En "Iniciar sesión en Google", localiza Contraseñas de aplicaciones
  4. Genera una nueva contraseña de aplicación para "Correo"
  5. Usa esa contraseña en Configuración de Mailbox del módulo en lugar de tu contraseña normal de Gmail
aviso

No usar una contraseña de aplicación cuando es requerida provocará errores de autenticación o intentos de inicio de sesión bloqueados.

tip

Para Gmail y Outlook, recomendamos encarecidamente usar OAuth2 en lugar de contraseñas de aplicación para mayor seguridad y facilidad de uso. Consulta Configuración OAuth de Gmail o Configuración OAuth de Outlook.

6. Ajustes por personal vs globales​

El módulo admite ajustes IMAP tanto por personal como globales:

  • Ajustes por personal: Cada miembro del personal puede configurar su propio servidor IMAP, puerto, cifrado y mapeo de carpetas
  • Ajustes globales: Configuración de respaldo cuando no hay ajustes por personal configurados

Si los correos no se sincronizan:

  1. Revisa tu página Configuración de Mailbox para los ajustes por personal
  2. Verifica que el servidor IMAP, puerto y cifrado sean correctos
  3. Comprueba el mapeo de carpetas (especialmente si usas nombres de carpetas no estándar)
  4. Revisa el registro de actividad para mensajes de error específicos

7. Problemas de sincronización del estado de lectura​

Si has activado "Sincronizar estado de lectura con el servidor de correo" pero los cambios no se reflejan en Gmail/Outlook:

  • Correos antiguos: Los correos importados antes de la versión 2.1.7 pueden no tener UID almacenado. Solo los correos nuevos sincronizarán el estado de lectura.
  • UID faltante: Busca en el registro de actividad mensajes "Email ID XXX has no UID stored" (es normal para correos antiguos).
  • OAuth requerido: La sincronización del estado de lectura funciona mejor con autenticación OAuth.
  • Sincronización manual: Usa el botón Sincronización manual en Ajustes para probar la conexión.

¿Sigues necesitando ayuda?​

Si estás atascado o no puedes resolver un problema, nuestro equipo de soporte está aquí para ayudarte. Abre un ticket a través del Portal de soporte de Themesic y te ayudaremos lo antes posible.