Buscar en la base de conocimiento

Manual de configuración de Gmail OAuth 2.0 - Activa Software

¿Qué es Gmail OAuth 2.0 y para qué sirve?

Gmail OAuth 2.0 permite que Activa Software envíe correos usando Gmail sin guardar la contraseña del correo en el sistema.

En lugar de contraseña:

  • Google autoriza a Activa Software

  • Se genera un token seguro

  • El correo puede enviarse de forma estable y compatible con las políticas actuales de Google

Esto es más seguro y recomendado que SMTP con usuario/contraseña.

Requisitos antes de iniciar

Antes de comenzar, asegúrese de cumplir lo siguiente:

  1. Tener una cuenta Google válida que será usada para enviar correos
    (Gmail normal o Google Workspace).

  2. Tener acceso a:

    • Configuración de Email en Activa Software

    • Google Cloud Console con la cuenta Google emisora

  3. El dominio de su sistema está bajo:

    activasoftware.space

PARTE 1

Configuración inicial en Activa Software

Paso 1.1 – Ingresar a configuración de Email

En Activa Software vaya a:

  • Configuración → Email / SMTP

Paso 1.2 – Seleccionar el motor de correo

  • Motor de correo: PHPMailer

Paso 1.3 – Seleccionar Gmail OAuth 2.0

En Protocolo de email, seleccione:

  • ✅ Gmail OAuth 2.0

Al seleccionar esta opción, aparecerá automáticamente un campo llamado
Redirect URL.

Paso 1.4 – Copiar el Redirect URL

  • Copie exactamente el Redirect URL que se muestra en pantalla.

  • No lo modifique.

  • Guárdelo temporalmente (se usará más adelante en Google).

Este URL es único por sistema y es donde Google devolverá la autorización.

PARTE 2

Crear el proyecto en Google Cloud Console

Paso 2.1 – Ingresar a Google Cloud Console

  1. Ingrese a Google Cloud Console

  2. Inicie sesión con la cuenta Google que enviará los correos

Paso 2.2 – Crear un nuevo proyecto

  1. En la parte superior, haga clic en el selector de proyecto

  2. Seleccione Crear proyecto

  3. Nombre sugerido:

    Activa Software – Gmail OAuth

  4. Crear

Un proyecto es solo un contenedor de configuración, no afecta su cuenta Google.

Paso 2.3 – Habilitar Gmail API

  1. Menú izquierdo → APIs y servicios → Biblioteca

  2. Busque Gmail API

  3. Ingrese y haga clic en Habilitar

Esto permite que Google autorice el envío de correos desde el sistema.

PARTE 3

Configurar la pantalla de consentimiento OAuth

Paso 3.1 – Crear pantalla de consentimiento

  1. Vaya a APIs y servicios → Pantalla de consentimiento OAuth

  2. Tipo de usuario:

    • External (recomendado para todos los clientes)

Paso 3.2 – Información básica

Complete los campos:

  • Nombre de la aplicación:

    Activa Software

  • Correo de soporte: su correo

  • Correo del desarrollador: su correo

Paso 3.3 – Dominios autorizados (MUY IMPORTANTE)

En Dominios autorizados, agregue:

activasoftware.space

Esto es obligatorio para que Google acepte el Redirect URL del sistema.

Guardar y continuar.

Paso 3.4 – Permisos (Scopes)

Mantenga solo los permisos necesarios para el envío de correo.

  • No agregue permisos innecesarios.

  • Use los que Gmail solicita para enviar correos.

Guardar y continuar hasta finalizar.

Paso 3.5 – Publicar la aplicación

Asegúrese de que la aplicación esté en estado:

  • ✅ Publicada

No usar modo testing
Todos los clientes deben trabajar con la aplicación publicada para evitar bloqueos.

PARTE 4

Crear las credenciales OAuth (Client ID y Client Secret)

Paso 4.1 – Crear credenciales

  1. Vaya a APIs y servicios → Credenciales

  2. Haga clic en Crear credenciales → ID de cliente OAuth

Paso 4.2 – Tipo de aplicación

Seleccione:

  • Aplicación web

Paso 4.3 – Configurar Redirect URL

  1. En URIs de redirección autorizadas

  2. Agregue:

    • El Redirect URL copiado desde Activa Software

  3. Guardar

Paso 4.4 – Copiar credenciales

Google mostrará:

  • Client ID

  • Client Secret

Guárdelos, se usarán en el sistema.

PARTE 5

Finalizar configuración en Activa Software

Paso 5.1 – Ingresar credenciales

Regrese a Configuración de Email en Activa Software:

  • Pegue Client ID

  • Pegue Client Secret

Paso 5.2 – Parámetros SMTP estándar

Configure exactamente así:

  • Encriptación: SSL

  • Puerto SMTP: 465

  • Servidor SMTP: smtp.gmail.com

  • Email:

    • Debe ser la misma cuenta Google que se va a autenticar

Paso 5.3 – Autenticar

  1. Haga clic en Authenticate

  2. Se abrirá Google

  3. Inicie sesión con la cuenta emisora

  4. Acepte permisos

Al finalizar, Google regresará al sistema y el token quedará guardado.

PARTE 6

Enviar correo de prueba

Paso 6.1 – Prueba de envío

En la sección Enviar email de prueba:

  1. Ingrese un correo de destino

  2. Clic en Test

Paso 6.2 – Confirmación

Si el correo llega correctamente:

  • ✅ Gmail OAuth 2.0 quedó configurado

  • ✅ Activa Software puede enviar correos sin contraseñas

Recomendaciones finales

  • No cambie la cuenta Google sin re-autenticar

  • Gmail OAuth es el método recomendado por Google a largo plazo

¿Le ha resultado útil este artículo?

Articulos relacionados