Saltar al contenido

Proveedores de correo

SMTP

Configura SMTP como proveedor de correo en Notifuse con Basic Auth u OAuth2.

La integración SMTP conecta con Notifuse cualquier servicio de correo compatible con SMTP, con autenticación por contraseña o con OAuth2 para Microsoft 365 y Gmail.

Configuración

Ve a Configuración → Integraciones, haz clic en Añadir integración y elige SMTP en Envío de correos. El formulario se abre a página completa.

Ajustes básicos

CampoDescripciónEjemplo
NombreNombre visible de esta configuración SMTPCompany SMTP
HostNombre de host del servidor SMTPsmtp.gmail.com
PuertoNúmero de puerto del servidor SMTP: 587 para STARTTLS, 465 para TLS desde el primer byte, 25 sin cifrar587
CifradoEl interruptor Usar TLS. Activado: STARTTLS, o TLS desde el primer byte en el puerto 465. Desactivado: texto sin cifrarOn
Nombre de host EHLONombre de host que se envía con el comando SMTP EHLO. Si está vacío, se usa el host. Útil cuando un servidor rechaza EHLO localhost.mail.yourdomain.com

Tipo de autenticación

Elige una de las dos opciones de Método, en el panel Autenticación:

OpciónDescripciónCaso de uso
Usuario y contraseñaAutenticación básicaLa mayoría de los servidores SMTP, contraseñas de aplicación
OAuth2Autenticación basada en tokensMicrosoft 365, Gmail (obligatorio desde 2024)

Autenticación básica

Para servidores SMTP que aceptan una contraseña, o servicios que admiten contraseñas de aplicación.

CampoDescripciónEjemplo
Nombre de usuarioNombre de usuario para la autenticación. Déjalo vacío si el servidor acepta correo sin inicio de sesiónyour-email@gmail.com
ContraseñaContraseña para la autenticaciónyour-app-password

Autenticación OAuth2

Microsoft 365 y Gmail han retirado la autenticación básica, así que exigen OAuth2.

OAuth2 con Microsoft 365

Microsoft 365

Microsoft 365 usa el flujo Client Credentials para la autenticación entre servidores.

Requisitos previos

  • Una cuenta de Microsoft 365 Business (no una cuenta personal de Outlook.com)
  • Acceso de administrador a Azure AD
  • Acceso de administrador a Exchange Online

Paso 1: registra una aplicación en Azure AD

  1. Ve a Azure Portal → Azure Active Directory → App registrations
  2. Haz clic en New registration
  3. Escribe un nombre (por ejemplo, “Notifuse SMTP”)
  4. Selecciona Accounts in this organizational directory only (un solo tenant)
  5. Haz clic en Register
  6. Anota el Application (client) ID y el Directory (tenant) ID

Paso 2: crea un secreto de cliente

  1. En el registro de tu aplicación, ve a Certificates & secrets
  2. Haz clic en New client secret
  3. Añade una descripción y elige el periodo de caducidad
  4. Haz clic en Add
  5. Copia el valor del secreto enseguida (no se volverá a mostrar)

Paso 3: añade el permiso de API

  1. Ve a API permissions → Add a permission
  2. Selecciona APIs my organization uses
  3. Busca Office 365 Exchange Online
  4. Selecciona Application permissions
  5. Marca SMTP.SendAsApp
  6. Haz clic en Add permissions
  7. Haz clic en Grant admin consent for [Your Organization]

Paso 4: registra la entidad de servicio en Exchange Online

Este paso se olvida a menudo, y sin él la autenticación falla. Conéctate a Exchange Online PowerShell:

# Install module if needed
Install-Module -Name ExchangeOnlineManagement

# Connect to Exchange Online
Connect-ExchangeOnline -UserPrincipalName admin@yourdomain.com

# Register the service principal
New-ServicePrincipal -AppId <Application-Client-ID> -ObjectId <Object-ID>

Advertencia

El ObjectId tiene que venir de Enterprise Applications, no de App Registrations.

Para encontrar el Object ID correcto:

  1. Ve a Azure Portal → Microsoft Entra ID → Enterprise Applications
  2. Busca el nombre de tu aplicación
  3. Copia el Object ID de la página Overview

Paso 5: concede el permiso sobre el buzón

Concede a la entidad de servicio permiso para enviar como un buzón concreto:

# Grant full access to the mailbox
Add-MailboxPermission -Identity "sender@yourdomain.com" -User <Object-ID> -AccessRights FullAccess

# Grant send-as permission
Add-RecipientPermission -Identity "sender@yourdomain.com" -Trustee <Object-ID> -AccessRights SendAs

Paso 6: activa SMTP AUTH en el buzón

Activa SMTP AUTH en el buzón remitente, desde el Microsoft 365 Admin Center o con PowerShell:

Opción A: Microsoft 365 Admin Center

  1. Ve a Users → Active users
  2. Selecciona el usuario remitente
  3. Haz clic en la pestaña Mail → Manage email apps
  4. Marca Authenticated SMTP
  5. Haz clic en Save changes

Opción B: PowerShell

# Enable SMTP AUTH for the mailbox
Set-CASMailbox -Identity "sender@yourdomain.com" -SmtpClientAuthenticationDisabled $false

Advertencia

Si Security Defaults está activado en tu tenant de Microsoft Entra, SMTP AUTH queda bloqueado para toda la organización. Puede que tengas que desactivar Security Defaults o usar en su lugar directivas de acceso condicional.

Paso 7: configura Notifuse

CampoValor
Hostsmtp.office365.com
Puerto587
Usar TLSOn
MétodoOAuth2
Proveedor OAuth2Microsoft 365 / Office 365
Dirección del buzónCorreo del remitente (por ejemplo, sender@yourdomain.com)
ID de tenantEl Directory (tenant) ID de Azure AD
ID de clienteEl Application (client) ID de Azure
Secreto de clienteEl valor del secreto del paso 2

Advertencia

La Dirección del buzón tiene que coincidir con el buzón al que concediste permisos en el paso 5.


OAuth2 con Gmail

Gmail

Gmail usa el flujo Refresh Token para la autenticación.

Requisitos previos

  • Una cuenta de Google (Gmail personal o Google Workspace)
  • Acceso a Google Cloud Console
  • Un terminal con curl instalado

Paso 1: crea un proyecto de Google Cloud

  1. Ve a Google Cloud Console
  2. Crea un proyecto nuevo o selecciona uno existente
  3. Activa la Gmail API:
    • Ve a APIs & Services → Library
    • Busca “Gmail API” y actívala
  1. Ve a APIs & Services → OAuth consent screen
  2. Selecciona el tipo de usuario External (o Internal para Workspace)
  3. Rellena la información de la aplicación:
    • App name: “Notifuse” (o el que prefieras)
    • User support email: tu correo
    • Developer contact: tu correo
  4. Haz clic en Save and Continue
  5. En la página Scopes, haz clic en Add or Remove Scopes
  6. Añade el scope: https://mail.google.com/
  7. Haz clic en Save and Continue
  8. En la página Test users, añade tu dirección de Gmail
  9. Haz clic en Save and Continue para terminar el asistente

Paso 3: publica tu aplicación (necesario para tokens de larga duración)

Advertencia

En modo “Testing”, los refresh tokens caducan a los 7 días. Publica tu aplicación para obtener refresh tokens permanentes.

  1. Ve a APIs & Services → OAuth consent screen
  2. Haz clic en Publish App
  3. Confirma con Confirm

El estado de la aplicación pasa de “Testing” a “In production”.

Nota

No necesitas la verificación de Google para uso personal

Publicar tu aplicación NO requiere la verificación de Google si:

  • Tienes menos de 100 usuarios
  • La usas con fines personales o internos

Si ves un aviso de “unverified app” al autorizar, haz clic en Advanced → Go to [App Name] (unsafe) para continuar.

Paso 4: crea las credenciales OAuth

  1. Ve a APIs & Services → Credentials
  2. Haz clic en Create Credentials → OAuth client ID
  3. Selecciona Web application
  4. Ponle un nombre (por ejemplo, “Notifuse SMTP”)
  5. En Authorized redirect URIs, haz clic en Add URI
  6. Escribe: http://localhost
  7. Haz clic en Create
  8. Un cuadro de diálogo muestra tu Client ID y tu Client Secret: guarda los dos

Paso 5: obtén el código de autorización

Abre esta URL en tu navegador, con tu Client ID en lugar de YOUR_CLIENT_ID:

https://accounts.google.com/o/oauth2/v2/auth?client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost&scope=https://mail.google.com/&response_type=code&access_type=offline&prompt=consent

Parámetros importantes de la URL:

  • scope=https://mail.google.com/: necesario para el acceso SMTP
  • access_type=offline: necesario para recibir un refresh token
  • prompt=consent: obliga a Google a devolver un refresh token nuevo

Después de iniciar sesión y conceder el permiso, el navegador te redirige a algo como:

http://localhost/?code=4/0AQSTgQF...LONG_CODE...&scope=https://mail.google.com/

Copia el valor completo de code (todo lo que hay entre code= y &scope).

Consejo

Si el código contiene %2F, sustitúyelo por / antes de usarlo.

Paso 6: cambia el código por un refresh token

Ejecuta este comando curl en tu terminal, con tus valores en lugar de los marcadores:

curl -X POST https://oauth2.googleapis.com/token \
  -d "code=YOUR_AUTHORIZATION_CODE" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "redirect_uri=http://localhost" \
  -d "grant_type=authorization_code"

Respuesta correcta:

{
  "access_token": "ya29.a0AfH6SMBx...",
  "expires_in": 3599,
  "refresh_token": "1//0eHusbKw...",
  "scope": "https://mail.google.com/",
  "token_type": "Bearer"
}

Advertencia

Guarda tu refresh_token ahora. Google solo lo devuelve en la primera autorización. Si lo pierdes, tendrás que revocar el acceso y volver a autorizar.

Paso 7: configura Notifuse

CampoValor
Hostsmtp.gmail.com
Puerto587
Usar TLSOn
MétodoOAuth2
Proveedor OAuth2Google Workspace / Gmail
Dirección del buzónTu dirección de Gmail
ID de clienteEl Client ID del paso 4
Secreto de clienteEl Client Secret del paso 4
Token de actualizaciónEl refresh token del paso 6

Duración del refresh token

Con una aplicación publicada, el refresh token sigue siendo válido indefinidamente, salvo si:

CondiciónResultado
El token no se usa durante 6 mesesEl token caduca
Cambias tu contraseña de GoogleEl token se revoca
Superas los 50 refresh tokens por clienteEl token más antiguo se revoca automáticamente
Revocas el acceso a mano en myaccount.google.com/permissionsEl token se revoca

Nota

Si tu token deja de ser válido, repite los pasos 5 y 6 para generar un refresh token nuevo.


Lista de remitentes

Añade las direcciones de remitente que puede usar esta integración SMTP:

CampoDescripciónEjemplo
NombreNombre visible del remitenteSupport Team
Correo electrónicoDirección de correo del remitentesupport@yourdomain.com

Haz clic en Añadir remitente para añadir varias direcciones de remitente.


Tipos de uso

Elige qué envía esta integración SMTP desde el menú ⋯ de su tarjeta en Configuración → Integraciones (Usar para marketing, Usar para transaccional), o en el panel Envío de correos de esa página:

OpciónDescripción
Usar para transaccionalRestablecimientos de contraseña, confirmaciones de pedido, notificaciones
Usar para marketingNewsletters, campañas promocionales, anuncios

Elige las dos opciones para enviar todos los tipos de correo con la misma configuración SMTP.


Limitaciones

SMTP no tiene webhooks, así que Notifuse no recibe de una integración SMTP actualizaciones del estado de entrega, avisos de rebote ni quejas por spam o abuso.

Info

Notifuse añade seguimiento de aperturas y clics a todos los correos, sea cual sea el proveedor de correo.

Para tener webhooks de entrega y las demás funciones de un proveedor, usa un proveedor de servicios de correo como Mailgun, Postmark o SparkPost.


Servidores SMTP habituales

ProveedorHostPuertoTLSTipo de autenticación
Gmailsmtp.gmail.com587SíOAuth2 (obligatorio)
Microsoft 365smtp.office365.com587SíOAuth2 (obligatorio)
Amazon SESemail-smtp.region.amazonaws.com587SíBasic Auth
SendGridsmtp.sendgrid.net587SíBasic Auth
Mailgunsmtp.mailgun.org587SíBasic Auth

Nota

Gmail y Microsoft 365 han retirado la autenticación básica: usa OAuth2 con ellos.


Solución de problemas

Microsoft 365: “535 5.7.3 Authentication unsuccessful”

Este error suele significar:

  1. La entidad de servicio no está registrada en Exchange Online (paso 4)
  2. No se han concedido los permisos sobre el buzón (paso 5)
  3. La Dirección del buzón no coincide con el buzón autorizado

Gmail: “unauthorized_client”

Este error significa:

  1. El refresh token se generó con otro Client ID u otro Client Secret
  2. Vuelve a generar el refresh token con tus credenciales actuales

Gmail: “invalid_grant”

Este error significa:

  1. El refresh token ha caducado (7 días en modo Testing)
  2. El usuario cambió su contraseña de Google
  3. El token se revocó o se superó el límite de 50 tokens

Solución: genera un refresh token nuevo siguiendo los pasos 5 y 6.


Pruebas

Haz clic en Enviar un correo de prueba en la parte superior del formulario de la integración, o en Enviar prueba en su tarjeta, para comprobar tu configuración.