IMAP en Gmail + Contraseña de aplicación — Guía rápida
En esta guía aprenderás a habilitar IMAP y generar una Contraseña de Aplicación (App Password) para conectar Gmail con Pxsol.
Qué necesitas saber antes de empezar.
- IMAP habilitado en Gmail.
- 2FA (Verificación en 2 pasos) obligatorio.
- Crear Contraseña de aplicación (16 caracteres) aquí: https://myaccount.google.com/apppasswords
- Cuentas personales (@gmail.com): el usuario realiza todo.
- Google Workspace (dominio propio): el administrador debe permitir 2FA y App Passwords.
Cuentas personales vs Workspace
Diferencias de configuración según el tipo de cuenta.
Tipo de cuenta
Quién actúa
2FA
App Passwords
Nota
@gmail.com (personal)
Usuario
Requerido
Disponible tras 2FA
Sigue los pasos de esta guía.
Google Workspace
Usuario + Admin
Requerido
El Admin debe permitir
Si no aparece, solicita al Admin habilitarlo.
Requisitos
Verifica estas condiciones previas.
- Acceso a https://mail.google.com y https://myaccount.google.com/security
- 2FA activado (sin 2FA no aparece “App Passwords”).
- En Workspace, que el administrador permita 2FA, App Passwords e IMAP.
Habilitar IMAP en Gmail
Necesario para lectura de correo por aplicaciones.
- Abre https://mail.google.com
- ⚙️ Configuración → Ver todos los ajustes
- Pestaña Reenvío y correo POP/IMAP
- Acceso IMAP → Verificar que esté activo el acceso o Habilitar IMAP → Guardar cambios


Activar Verificación en 2 pasos (2FA)
Requisito para generar App Passwords.
- Abre https://myaccount.google.com/security

- Acceso a Google → Verificación en dos pasos → Activar


Crear App Password (IMAP/SMTP)
Contraseña específica de 16 caracteres para Pxsol.
- Entra a https://myaccount.google.com/apppasswords
- Confirma 2FA si se solicita
- Escribe el nombre de la aplicación: Pxsol
- Crear → copia la contraseña de 16 caracteres (sin espacios)


Usa esta App Password como contraseña en Pxsol. Tu usuario es tu email completo.
Pasos a seguir para Admin (Workspace):
- Consola de administración → Seguridad → Verificación en 2 pasos: permitir 2FA y Contraseñas de aplicaciones.
- Apps → Google Workspace → Gmail → Configuración del usuario: IMAP habilitado.
Configurar Pxsol
Valores típicos de servidor.
IMAP (lectura)
- Servidor: imap.gmail.com
- Puerto: 993
- Seguridad: SSL/TLS
- Usuario: tu email completo
- Contraseña: App Password
SMTP (envío)
- Servidor: smtp.gmail.com
- Puerto: 465 (SSL) o 587 (STARTTLS)
- Usuario: tu email completo
- Contraseña: App Password
Solución de problemas
Pasos rápidos ante errores comunes.
- No aparece “App Passwords” → Activa 2FA; en Workspace, solicita al Admin permitir App Passwords.
- “Contraseña incorrecta” → Pega los 16 caracteres sin espacios; regenera si es necesario.
Checklist final
Verifica que todo quede listo.
- IMAP habilitado en Gmail
- 2FA activado
- (Workspace) Admin permite 2FA, App Passwords e IMAP
- App Password creada
- Pxsol configurado con App Password