Integraciones

Conectar Gmail / Outlook (OAuth) y sincronizar correos

Conecta tu cuenta de Google Workspace (Gmail) o Microsoft 365 (Outlook) mediante OAuth, usando la app OAuth de tu propia organización, y registra los correos automáticamente como actividades en los contactos.

💡 ¿Correos antiguos aparecían cortados? Después de conectar, haz clic en "Buscar historial completo" en la tarjeta: el CRM vuelve a traer el texto íntegro de los mensajes antiguos que solo tenían la vista previa. Es seguro repetirlo (nunca acorta lo que ya está completo). Los adjuntos de los correos también se descargan y guardan.

Puedes conectar tu bandeja de correo de Google Workspace (Gmail) o de Microsoft 365 (Outlook) al CRM. Una vez conectada, el CRM lee los correos recientes y, por cada mensaje cuyo remitente o destinatario coincida con un Contacto o Lead (por el correo), registra una actividad de tipo "correo" en la línea de tiempo de ese registro.

El modelo es BYO ("trae el tuyo"): usas la app OAuth de TU propia organización. Nunca vemos tus credenciales y no hay costo de nuestra parte. La integración nace inerte: no ocurre nada hasta que configures la app OAuth y conectes la cuenta.

Requisitos previos

Una cuenta de Google Workspace (Gmail) O de Microsoft 365 (Outlook), que puede ser tu cuenta de trabajo habitual.
Permiso para crear una app OAuth en tu organización: acceso a la Google Cloud Console (Gmail) o al Portal de Azure / Microsoft Entra ID (Outlook). En empresas, esto suele requerir un administrador de TI.
En Sellio, ser administrador (permiso para gestionar la configuración) para guardar las credenciales de la app en Configuración → Integraciones. La conexión de la bandeja en sí (Paso 3) la hace cada usuario para su propia cuenta.

Paso 1: crea la app OAuth de tu organización

Google Workspace (Gmail): en la Google Cloud Console, crea un proyecto, configura la pantalla de consentimiento OAuth, habilita la API de Gmail y crea una credencial de tipo "ID de cliente OAuth" (Aplicación web). Copia el Client ID y el Client Secret.

Microsoft 365 (Outlook): en el Portal de Azure, ve a Microsoft Entra ID → Registros de aplicaciones → Nuevo registro. En "Certificados y secretos", genera un Client Secret. En "Permisos de API", agrega Microsoft Graph con los permisos delegados Mail.Read y User.Read. Copia el Client ID (ID de la aplicación) y el Client Secret.

💡 En ambos proveedores, registra EXACTAMENTE el URI de redireccionamiento que se muestra en la tarjeta de la integración (termina en /api/oauth/google/callback o /api/oauth/microsoft/callback). Debe ser idéntico, de lo contrario el proveedor rechaza la conexión.

Paso 2: pega las credenciales en el CRM

Abre Configuración → Integraciones y localiza la tarjeta "Google Workspace (Gmail)" o "Microsoft 365 (Outlook)".
Copia el URI de redireccionamiento que se muestra y regístralo en tu app OAuth (Paso 1).
Pega el Client ID y el Client Secret y haz clic en "Guardar credenciales de la app". El Client Secret se guarda cifrado y nunca se muestra de vuelta.

Paso 3: conecta tu cuenta

Aún en la tarjeta, haz clic en "Conectar". Te llevará a la pantalla de consentimiento del proveedor, ya con la sesión iniciada en tu cuenta.
Autoriza el acceso de lectura al correo. Vuelves al CRM y la tarjeta pasa a mostrar "Conectado como" con la dirección de la cuenta.
Haz clic en "Sincronizar correos" para traer los correos recientes ahora. El CRM informa cuántos correos leyó y cuántas actividades creó.

Cada usuario conecta su propia bandeja: la sincronización se ejecuta en el contexto de quien la conectó. Los correos se convierten en actividades solo cuando el remitente o destinatario coincide con un Contacto o Lead existente (por el campo de correo). Los correos que no coinciden con ningún registro se ignoran.

Seguridad y privacidad

Los tokens de acceso y de actualización (refresh) se guardan cifrados y nunca se muestran. El token de acceso se renueva automáticamente al vencer, sin un nuevo inicio de sesión. La conexión de correo es totalmente independiente del inicio de sesión del CRM: conectar o desconectar aquí no cambia cómo ingresas al sistema.

💡 Para revocar el acceso, haz clic en "Desconectar" en la tarjeta y los tokens guardados se eliminan. Puedes reconectar en cualquier momento. Si la conexión vence (por ejemplo, tras cambiar la contraseña de la cuenta), usa "Reconectar".

Ejemplo: URI de redireccionamiento a registrar: https://app.tuempresa.com/api/oauth/google/callback (Google) o https://app.tuempresa.com/api/oauth/microsoft/callback (Microsoft).

Cómo probar

Después de conectar (Paso 3), confirma que la tarjeta muestra "Conectado como" con la dirección correcta.
Haz clic en "Sincronizar correos": el CRM informa cuántos correos leyó y cuántas actividades creó.
Abre un Contacto o Lead que sepas que intercambió correos recientemente y revisa la línea de tiempo: debe aparecer una actividad de tipo "Correo".

Solución de problemas

Error "redirect_uri_mismatch" o el proveedor rechaza la conexión: el URI de redireccionamiento registrado en la app OAuth es distinto del que se muestra en la tarjeta. Cópialo de nuevo y pégalo EXACTAMENTE igual (mismo dominio, misma barra final).
401/invalid_client al conectar: Client ID o Client Secret incorrectos. Vuelve a registrar las credenciales en la tarjeta (el Secret nunca vuelve del servidor, así que pégalo completo de nuevo).
Conecta, pero no crea actividades: los correos solo se convierten en actividad cuando el remitente/destinatario coincide con un Contacto o Lead por el campo de correo. Los correos sin coincidencia se ignoran; registra el correo en el registro.
"Acceso denegado" / pantalla de consentimiento bloqueada: en Google, publica la pantalla de consentimiento OAuth (o agrega al usuario como probador); en Azure, concede el consentimiento de administrador a los permisos.
La conexión dejó de funcionar (ej.: tras cambiar la contraseña de la cuenta): haz clic en "Reconectar" en la tarjeta para rehacer el consentimiento y renovar los tokens.

Abrir este artículo dentro del sistema →