> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

| 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](https://www.notifuse.com/docs/assets/microsoft-365-icon.svg)

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](https://portal.azure.com) → **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:

```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>
```

> [!WARNING]
>
> 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:

```powershell
# 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**

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

> [!WARNING]
>
> 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                             |

> [!WARNING]
>
> 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](https://www.notifuse.com/docs/assets/gmail-icon.svg)

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](https://console.cloud.google.com)
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

#### Paso 2: configura la pantalla de consentimiento OAuth

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)

> [!WARNING]
>
> 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".

> [!NOTE]
>
> **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`).

> [!TIP]
>
> 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:

```bash
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:

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

> [!WARNING]
>
> **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](https://myaccount.google.com/permissions) | El token se revoca                             |

> [!NOTE]
>
> 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.

> [!NOTE]
>
> 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](https://www.notifuse.com/es/docs/integrations/mailgun.md), [Postmark](https://www.notifuse.com/es/docs/integrations/postmark.md) o [SparkPost](https://www.notifuse.com/es/docs/integrations/sparkpost.md).

---

## 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            |

> [!NOTE]
>
> 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.
