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
| Campo | Descripción | Ejemplo |
|---|---|---|
| Nombre | Nombre visible de esta configuración SMTP | Company SMTP |
| Host | Nombre de host del servidor SMTP | smtp.gmail.com |
| Puerto | Número de puerto del servidor SMTP: 587 para STARTTLS, 465 para TLS desde el primer byte, 25 sin cifrar | 587 |
| Cifrado | El interruptor Usar TLS. Activado: STARTTLS, o TLS desde el primer byte en el puerto 465. Desactivado: texto sin cifrar | On |
| Nombre de host EHLO | Nombre 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ón | Descripción | Caso de uso |
|---|---|---|
| Usuario y contraseña | Autenticación básica | La mayoría de los servidores SMTP, contraseñas de aplicación |
| OAuth2 | Autenticación basada en tokens | Microsoft 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.
| Campo | Descripción | Ejemplo |
|---|---|---|
| Nombre de usuario | Nombre de usuario para la autenticación. Déjalo vacío si el servidor acepta correo sin inicio de sesión | your-email@gmail.com |
| Contraseña | Contraseña para la autenticación | your-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 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
- Ve a Azure Portal → Azure Active Directory → App registrations
- Haz clic en New registration
- Escribe un nombre (por ejemplo, “Notifuse SMTP”)
- Selecciona Accounts in this organizational directory only (un solo tenant)
- Haz clic en Register
- Anota el Application (client) ID y el Directory (tenant) ID
Paso 2: crea un secreto de cliente
- En el registro de tu aplicación, ve a Certificates & secrets
- Haz clic en New client secret
- Añade una descripción y elige el periodo de caducidad
- Haz clic en Add
- Copia el valor del secreto enseguida (no se volverá a mostrar)
Paso 3: añade el permiso de API
- Ve a API permissions → Add a permission
- Selecciona APIs my organization uses
- Busca Office 365 Exchange Online
- Selecciona Application permissions
- Marca SMTP.SendAsApp
- Haz clic en Add permissions
- 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:
- Ve a Azure Portal → Microsoft Entra ID → Enterprise Applications
- Busca el nombre de tu aplicación
- 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
- Ve a Users → Active users
- Selecciona el usuario remitente
- Haz clic en la pestaña Mail → Manage email apps
- Marca Authenticated SMTP
- 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
| Campo | Valor |
|---|---|
| Host | smtp.office365.com |
| Puerto | 587 |
| Usar TLS | On |
| Método | OAuth2 |
| Proveedor OAuth2 | Microsoft 365 / Office 365 |
| Dirección del buzón | Correo del remitente (por ejemplo, sender@yourdomain.com) |
| ID de tenant | El Directory (tenant) ID de Azure AD |
| ID de cliente | El Application (client) ID de Azure |
| Secreto de cliente | El 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 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
curlinstalado
Paso 1: crea un proyecto de Google Cloud
- Ve a Google Cloud Console
- Crea un proyecto nuevo o selecciona uno existente
- Activa la Gmail API:
- Ve a APIs & Services → Library
- Busca “Gmail API” y actívala
Paso 2: configura la pantalla de consentimiento OAuth
- Ve a APIs & Services → OAuth consent screen
- Selecciona el tipo de usuario External (o Internal para Workspace)
- Rellena la información de la aplicación:
- App name: “Notifuse” (o el que prefieras)
- User support email: tu correo
- Developer contact: tu correo
- Haz clic en Save and Continue
- En la página Scopes, haz clic en Add or Remove Scopes
- Añade el scope:
https://mail.google.com/ - Haz clic en Save and Continue
- En la página Test users, añade tu dirección de Gmail
- 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.
- Ve a APIs & Services → OAuth consent screen
- Haz clic en Publish App
- 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
- Ve a APIs & Services → Credentials
- Haz clic en Create Credentials → OAuth client ID
- Selecciona Web application
- Ponle un nombre (por ejemplo, “Notifuse SMTP”)
- En Authorized redirect URIs, haz clic en Add URI
- Escribe:
http://localhost - Haz clic en Create
- 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 SMTPaccess_type=offline: necesario para recibir un refresh tokenprompt=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
| Campo | Valor |
|---|---|
| Host | smtp.gmail.com |
| Puerto | 587 |
| Usar TLS | On |
| Método | OAuth2 |
| Proveedor OAuth2 | Google Workspace / Gmail |
| Dirección del buzón | Tu dirección de Gmail |
| ID de cliente | El Client ID del paso 4 |
| Secreto de cliente | El Client Secret del paso 4 |
| Token de actualización | El 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ón | Resultado |
|---|---|
| El token no se usa durante 6 meses | El token caduca |
| Cambias tu contraseña de Google | El token se revoca |
| Superas los 50 refresh tokens por cliente | El token más antiguo se revoca automáticamente |
| Revocas el acceso a mano en myaccount.google.com/permissions | El 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:
| Campo | Descripción | Ejemplo |
|---|---|---|
| Nombre | Nombre visible del remitente | Support Team |
| Correo electrónico | Dirección de correo del remitente | support@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ón | Descripción |
|---|---|
| Usar para transaccional | Restablecimientos de contraseña, confirmaciones de pedido, notificaciones |
| Usar para marketing | Newsletters, 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
| Proveedor | Host | Puerto | TLS | Tipo de autenticación |
|---|---|---|---|---|
| Gmail | smtp.gmail.com | 587 | Sí | OAuth2 (obligatorio) |
| Microsoft 365 | smtp.office365.com | 587 | Sí | OAuth2 (obligatorio) |
| Amazon SES | email-smtp.region.amazonaws.com | 587 | Sí | Basic Auth |
| SendGrid | smtp.sendgrid.net | 587 | Sí | Basic Auth |
| Mailgun | smtp.mailgun.org | 587 | Sí | 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:
- La entidad de servicio no está registrada en Exchange Online (paso 4)
- No se han concedido los permisos sobre el buzón (paso 5)
- La Dirección del buzón no coincide con el buzón autorizado
Gmail: “unauthorized_client”
Este error significa:
- El refresh token se generó con otro Client ID u otro Client Secret
- Vuelve a generar el refresh token con tus credenciales actuales
Gmail: “invalid_grant”
Este error significa:
- El refresh token ha caducado (7 días en modo Testing)
- El usuario cambió su contraseña de Google
- 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.
