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

# Configuración de Mailgun

> Guía paso a paso para configurar Mailgun con OneSignal para enviar mensajes de email. Incluye verificación DNS, configuración de credenciales SMTP, generación de clave API e instrucciones de integración con OneSignal.

<Warning>
  Esta guía de configuración es si ya tienes Mailgun y deseas integrarlo con OneSignal. Si no tienes una cuenta de Mailgun, puedes usar [OneSignal Email](./email-setup) en su lugar.
</Warning>

## Requisitos

* [Cuenta de Mailgun](https://www.mailgun.com)
* API **US** de Mailgun (la región EU no es compatible)
* [Cuenta de OneSignal](https://onesignal.com)
* Un dominio que poseas y acceso a su proveedor DNS

***

## Configuración

### 1. Agregar un nuevo dominio en Mailgun

Omite este paso si tu dominio ya está configurado en la región US.

1. Ve a la página **Domains** en el panel de Mailgun.

<Frame caption="Navegar a la página Domains">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6e14df8-01_-_Navigate_to_sending_domains.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=542d06f8870b8e98cdb276d475cb2d99" width="1328" height="1124" data-path="images/docs/6e14df8-01_-_Navigate_to_sending_domains.png" />
</Frame>

2. Haz clic en **Add new domain**.

<Frame caption="Abrir formulario Add New Domain">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/403bd98-01.2_-_Click_Add_new_domain_button.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=d0d94e8e010730d7f80fb782f0bf3557" width="1328" height="1124" data-path="images/docs/403bd98-01.2_-_Click_Add_new_domain_button.png" />
</Frame>

3. Ingresa un subdominio (por ejemplo, `mail.tudominio.com`) y asegúrate de que la región sea **US**.

<Frame caption="Especificar subdominio y seleccionar región US">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/ad8dca5-01.3_-_Add_new_domain.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=fa477b2191c6b916fb4e16a9bf457161" width="1328" height="1124" data-path="images/docs/ad8dca5-01.3_-_Add_new_domain.png" />
</Frame>

### 2. Verificar configuración DNS

Mailgun proporciona los siguientes registros DNS:

* 2 **TXT** (SPF y DKIM)
* 2 **MX**
* 1 **CNAME**

Actualiza estos en tu proveedor DNS. La propagación puede tardar hasta 48 horas. Mailgun te notificará por email una vez verificado.

Para verificar:

* Ve a **Mailgun > Sending > Domain Settings > Your Domain > DNS Records**
* Busca marcas de verificación verdes junto a cada registro

<Frame caption="Verificar configuración DNS">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/ddbf617-01.5_-_Verified_DNS_settings.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=26bd8596b9ac4b96089b8225c00fa94d" width="1328" height="1124" data-path="images/docs/ddbf617-01.5_-_Verified_DNS_settings.png" />
</Frame>

<Info>
  Si CNAME no está configurado correctamente, el seguimiento de clics, aperturas y cancelación de suscripción de email no funcionará.
</Info>

***

### 3. Configurar credenciales SMTP

1. Ve a **Sending > Domain Settings > SMTP credentials** en Mailgun.

<Frame caption="Navegar a SMTP Credentials">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/963d676-02_-_Add_SMTP_creds.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=2cb892039a5cfee55aa25da01ae438e1" width="1328" height="1124" data-path="images/docs/963d676-02_-_Add_SMTP_creds.png" />
</Frame>

2. Haz clic en **Add new SMTP user**.

<Frame caption="Agregar nuevas credenciales SMTP">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b2108d4-02.1_-_Click_Add_new_SMTP_user.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=79537c0dae456ed4320ad09647db4d87" width="1328" height="1124" data-path="images/docs/b2108d4-02.1_-_Click_Add_new_SMTP_user.png" />
</Frame>

3. Establece un nombre de inicio de sesión y guarda las credenciales.

<Frame caption="Crear usuario SMTP">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/be7540c-03_-_New_SMTP_creds.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=53a10a727d7dbb9a8234332e50e3308e" width="1328" height="1124" data-path="images/docs/be7540c-03_-_New_SMTP_creds.png" />
</Frame>

4. Haz clic en el ícono **copiar** para guardar la contraseña de forma segura.

<Frame caption="Copiar contraseña SMTP">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/ab32f9b-03.1_-_Copy_SMTP_user_pass.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=51aeb4db620490e077f63465619e2711" width="1328" height="1124" data-path="images/docs/ab32f9b-03.1_-_Copy_SMTP_user_pass.png" />
</Frame>

### 4. Obtener una clave API de Mailgun

1. En el panel de Mailgun, desplázate hacia abajo y haz clic en **API Keys**.

<Frame caption="Navegar a API Keys">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/430314e-42fc46d-step-1-50.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=f80af7cfcfe4be2d94418b6f15448097" width="1616" height="1365" data-path="images/docs/430314e-42fc46d-step-1-50.png" />
</Frame>

2. Haz clic en **Add new key**

<Frame caption="Agregar nueva clave">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6390d56-93a49a5-step-2-50.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=45c91e47914b90b577388c8c26fc9538" width="1616" height="1365" data-path="images/docs/6390d56-93a49a5-step-2-50.png" />
</Frame>

3. Nombra la clave y haz clic en **Create Key**.

<Frame caption="Crear clave">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/09dd33b-6faf199-step-3-50.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=87af7bad8fc8363e916e5673779a65ea" width="1616" height="1365" data-path="images/docs/09dd33b-6faf199-step-3-50.png" />
</Frame>

4. Copia la clave API generada y guárdala de forma segura.

<Frame caption="Copiar clave API">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1350337-cb5aeba-step-4-50.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=d4f1a03d0287b8c3169bda289b839cfa" width="1616" height="1365" data-path="images/docs/1350337-cb5aeba-step-4-50.png" />
</Frame>

***

### 5. Configurar Mailgun en OneSignal

1. En OneSignal, ve a **Configuración > Plataformas > Email** y elige **Mailgun**.

<Frame caption="Configuración de email de app">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/9341a6c-01_-_App_setup_email.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=2c645ab6c1107ed5bb1122aacff78d17" width="1328" height="1124" data-path="images/docs/9341a6c-01_-_App_setup_email.png" />
</Frame>

2. Selecciona **Mailgun** como el proveedor.

<Frame caption="Configuración de email de app">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4a2a57c-02_-_App_Setup_Email_Mailgun.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=d7bcb86f6bc0d15df9b49a147d132959" width="1328" height="1124" data-path="images/docs/4a2a57c-02_-_App_Setup_Email_Mailgun.png" />
</Frame>

3. Ingresa:

* El dominio del [Paso 1](#1-add-a-new-domain-in-mailgun)
* Credenciales SMTP del [Paso 3](#3-set-up-smtp-credentials)
* Clave API del [Paso 4](#4-get-a-mailgun-api-key)

<Frame caption="Configurar proveedor">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/07c6b2f-03_-_Configure_provider.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=a3cb35435c5496d52c08135bed6c99d0" width="1328" height="1124" data-path="images/docs/07c6b2f-03_-_Configure_provider.png" />
</Frame>

4. Establece el nombre del remitente predeterminado y la dirección de email `from`.

<Frame caption="Configurar ajustes adicionales">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9e6af63-04_-_Configure_additional_settings.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=7c34b6e400662d67808226872626e1de" width="1328" height="1124" data-path="images/docs/9e6af63-04_-_Configure_additional_settings.png" />
</Frame>

### 6. Agregar webhooks de OneSignal a Mailgun

Navega a **Mailgun > Sending > Webhooks > Your Domain > Webhooks** y agrega:

```
https://onesignal.com/email/hooks/mailgun
```

<Frame caption="Agregar webhook">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/d81f4cc-Screenshot_2023-01-25_at_3.48.04_PM.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=30721d7d06a88cae8fc244577f767a89" width="1534" height="1212" data-path="images/docs/d81f4cc-Screenshot_2023-01-25_at_3.48.04_PM.png" />
</Frame>

### 7. Cambiar protocolo de seguimiento a HTTPS

Asegúrate de que los destinatarios sean dirigidos a URLs seguras.

1. Ve a la configuración de tu dominio en Mailgun.
2. Bajo **Tracking > Tracking Protocol**, cambia de **HTTP** a **HTTPS**.

<Frame caption="Cambiar protocolo de seguimiento">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/e79e542-Screenshot_2023-01-25_at_3.52.26_PM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=bfb73b54c1f4a81ae480cdfda0413966" width="2228" height="632" data-path="images/docs/e79e542-Screenshot_2023-01-25_at_3.52.26_PM.png" />
</Frame>

### 8. Enviar un email de prueba

1. Ve a **OneSignal > Mensajes > Email**, haz clic en **Nuevo Email**.
2. Agrega un asunto, haz clic en **Enviar email de prueba**, ingresa tu email y presiona **Enviar mensaje de prueba**.

<Frame caption="Enviar email de prueba">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/46aaab5-Screen_Shot_2021-11-18_at_6.00.46_PM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=5d3969be38e8e9caea691fdb094a54c7" width="1806" height="598" data-path="images/docs/46aaab5-Screen_Shot_2021-11-18_at_6.00.46_PM.png" />
</Frame>

Deberías recibir el email de prueba en breve.

***

## Solución de problemas

Consulta nuestras [Preguntas frecuentes sobre Email](./email-troubleshooting)

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please include:

  * Details of the issue you're experiencing and steps to reproduce if available
  * Your OneSignal App ID
  * The External ID or Subscription ID if applicable
  * The URL to the message you tested in the OneSignal Dashboard if applicable
  * Any relevant [logs or error messages](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>

***

<Check>
  ¡Configuración de email completa!
  **Próximos pasos:**

  * Regresa a la [guía de Configuración de Email](./email-setup) para explorar las capacidades de OneSignal Email.
</Check>

***