> ## 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 DNS de email

> Agrega manualmente registros DNS (SPF, DKIM, DMARC, CNAME, MX) para autenticar tu dominio de envío para la entrega de email de OneSignal.

Configura los registros DNS proporcionados por OneSignal para autenticar tu dominio de envío. En la mayoría de los casos, el DNS puede configurarse automáticamente desde el dashboard de OneSignal como se describe en la guía de [Configuración de email](./email-setup). Usa esta página cuando necesites agregar registros manualmente.

## Requisitos

Para configurar manualmente los registros DNS, debes:

* Ser propietario del dominio de envío.
* Tener acceso a la configuración DNS a través de tu proveedor.

Si no tienes un dominio, recomendamos comprarlo a través de Cloudflare. Esta guía usa Cloudflare como ejemplo, pero la mayoría de los proveedores DNS funcionan de la misma manera.

<Accordion title="Registrar tu dominio con Cloudflare" icon="circle-chevron-down">
  Crea una cuenta en [Cloudflare.com](https://www.cloudflare.com/).

  Ve a **Domain Registration > Register Domains**.

  <Frame caption="Página de registro de dominio de Cloudflare">
    <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/738ee09-Register_a_Domain.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=327f5030dcc96a69aacf608556573bad" alt="Dashboard de Cloudflare mostrando la página de registro de dominios" width="1300" height="775" data-path="images/docs/738ee09-Register_a_Domain.png" />
  </Frame>

  Busca un nombre disponible y cómpralo.

  <Frame caption="Página de compra de dominio de Cloudflare">
    <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/914f661-Purchase_Domain.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=b81467e17066a8937256778554c2d014" alt="Resultados de búsqueda de dominio de Cloudflare con opción de compra" width="1386" height="542" data-path="images/docs/914f661-Purchase_Domain.png" />
  </Frame>

  Una vez comprado, tu dominio aparecerá en **Domain Registration > Managed Domains**.

  <Frame caption="Página de dominios administrados de Cloudflare">
    <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/64857b3-Domain_Active.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=a3354c52a0f2442467d289d9e8071872" alt="Lista de dominios administrados de Cloudflare mostrando el dominio activo" width="1303" height="817" data-path="images/docs/64857b3-Domain_Active.png" />
  </Frame>
</Accordion>

***

## Agregar registros DNS

Completa los pasos de [Configuración de email](./email-setup) hasta que se te solicite agregar registros DNS, luego regresa aquí o usa el botón **Auto-Configure DNS**.

Desde el dashboard de OneSignal:

* ⚠️ significa que el registro DNS actual no coincide
* ✅ significa que el registro DNS actual coincide

Cada registro DNS debe agregarse a tu proveedor DNS. La excepción es el registro MX — debes tener registros MX configurados, pero pueden apuntar a un servidor de correo diferente (por ejemplo, Gmail).

<Frame caption="Copiar registros DNS de OneSignal a tu proveedor DNS">
  <img src="https://mintcdn.com/onesignal/TrjGYudL1B3K9oZG/images/dashboard/dns-manual-configure.png?fit=max&auto=format&n=TrjGYudL1B3K9oZG&q=85&s=826b4fdef6343099bc3063dbf0dc6667" alt="Dashboard de OneSignal mostrando los registros DNS para copiar en tu proveedor" width="991" height="760" data-path="images/dashboard/dns-manual-configure.png" />
</Frame>

En la interfaz de tu proveedor DNS (por ejemplo, Cloudflare), ve a **DNS > Records** y agrega cada registro.

### Registros TXT

* **Type:** `TXT`
* **Name:** OneSignal "Hostname"
* **Content:** OneSignal "Value"
* **TTL:** Auto o el más bajo

<Warning>
  Si ya tienes un registro TXT SPF, no crees uno segundo. Agrega directivas `include:` adicionales al registro existente:

  `v=spf1 include:spf.onesignal.email include:mailgun.org include:your-other-spf-records ~all`
</Warning>

<Frame caption="Interfaz de registro DNS TXT en Cloudflare">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/476fea15213effba6c92f335f940246d1fc7d214233e5feee83b9f8a0f6390b2-Screenshot_2024-10-23_at_10.31.55_AM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=73f5e5388f8b6d5f3728aed32f03741a" alt="Interfaz de Cloudflare para agregar un registro DNS TXT con campos de hostname y valor" width="2540" height="1062" data-path="images/docs/476fea15213effba6c92f335f940246d1fc7d214233e5feee83b9f8a0f6390b2-Screenshot_2024-10-23_at_10.31.55_AM.png" />
</Frame>

#### SPF (Sender Policy Framework)

Verifica que la IP de envío está autorizada a enviar emails en nombre de tu dominio.

#### DMARC

Agrega aplicación de políticas para fallos de SPF/DKIM. **DMARC es requerido para el envío seguro de email.** Más información: [Directrices para remitentes de email](https://support.google.com/mail/answer/81126)

<Warning>
  OneSignal usa el valor `v=DMARC1; p=none;` para el registro DMARC. Si ya tienes un registro DMARC, no agregues uno duplicado — verifica que el registro existente incluya esta política.
</Warning>

### Registros CNAME

Usados para el seguimiento de aperturas, clics y cancelaciones de suscripción.

* **Type:** `CNAME`
* **Name:** OneSignal "Hostname"
* **Target:** OneSignal "Value"
* **TTL:** Auto o el más bajo

<Note>
  Si usas Cloudflare, establece **Proxy** en "DNS only" y **Flattening** en "Off" para los registros CNAME. Otros proveedores DNS generalmente no requieren estas configuraciones.
</Note>

<Frame caption="Interfaz de registro DNS CNAME en Cloudflare">
  <img src="https://mintcdn.com/onesignal/3zq1PvSaqvUE2bIx/images/docs/2e304d0eeb876a92bd325eeb490a7f8e5a7ba53d381bdc86009143146f7e6405-Screenshot_2024-10-23_at_10.36.52_AM.png?fit=max&auto=format&n=3zq1PvSaqvUE2bIx&q=85&s=c268cad031c5d52f44cd5fce1e81b105" alt="Interfaz de Cloudflare para agregar un registro CNAME con campos de hostname y destino" width="2540" height="1062" data-path="images/docs/2e304d0eeb876a92bd325eeb490a7f8e5a7ba53d381bdc86009143146f7e6405-Screenshot_2024-10-23_at_10.36.52_AM.png" />
</Frame>

#### DKIM (DomainKeys Identified Mail)

Verifica que el contenido del mensaje no fue alterado y fue enviado por ti. La clave pública está incluida en el registro DNS CNAME proporcionado por OneSignal.

### Registros MX

Recibe respuestas de email y rebotes. Incluso si solo estás enviando, los registros MX ayudan a evitar errores de verificación de dominio.

<Warning>
  Si ya usas otro proveedor de email (por ejemplo, Gmail), no sobrescribas los registros MX existentes.
</Warning>

* **Type:** `MX`
* **Name:** OneSignal "Hostname"
* **Mail server:** OneSignal "Value"
* **TTL:** Auto o el más bajo
* **Priority:** `10`

<Frame caption="Interfaz de registro DNS MX en Cloudflare">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/f267f956723811f57b5a7d5db5190619a44c7641699a0bf5b3511f617597ada1-Screenshot_2024-10-23_at_10.50.19_AM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=538fb5cd52395b619b641eeb23f4a610" alt="Interfaz de Cloudflare para agregar un registro MX con campos de servidor de correo y prioridad" width="2540" height="884" data-path="images/docs/f267f956723811f57b5a7d5db5190619a44c7641699a0bf5b3511f617597ada1-Screenshot_2024-10-23_at_10.50.19_AM.png" />
</Frame>

***

## Verificación y solución de problemas de DNS

Después de agregar los registros:

1. Regresa a tu dashboard de OneSignal.
2. Haz clic en **Check Records** o el botón de actualizar.

Los registros verificados muestran ✅. Todos los registros deben estar verificados excepto MX, que puede mostrar ⚠️ si apunta a un servidor de correo diferente (por ejemplo, Google Workspace) — esto es esperado y aceptable.

<Frame caption="Registros DNS verificados en el dashboard de OneSignal">
  <img src="https://mintcdn.com/onesignal/2-gyvU4UfJHiycCa/images/dashboard/dns-check-records.png?fit=max&auto=format&n=2-gyvU4UfJHiycCa&q=85&s=74380955130736264e42e26f2ae14a39" alt="Dashboard de OneSignal mostrando registros DNS con marcas de verificación verdes para estado verificado" width="2250" height="1290" data-path="images/dashboard/dns-check-records.png" />
</Frame>

<Warning>
  La verificación generalmente toma unos minutos pero puede tomar hasta 48 horas.
</Warning>

### Solucionar problemas de propagación DNS

1. Usa [whatsmydns.net](https://www.whatsmydns.net/) para verificar la propagación si algún registro está pendiente.
2. Para los registros que muestran ⚠️, copia el hostname del dashboard de OneSignal en la barra de búsqueda y establece el tipo DNS.
3. Revisa los resultados — ✅ significa que el registro está verificado globalmente, ❌ significa que aún no se ha propagado a ese servidor.

Si el valor mostrado en whatsmydns.net difiere de lo que proporciona OneSignal, verifica tu proveedor DNS y actualiza el registro para que coincida.

<Frame caption="Verificar propagación DNS con whatsmydns.net">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a3011bc8b7477b7a1e18cb16cfd69bba03cc1f19cf623ccddd1926722bfc585c-Screenshot_2024-10-23_at_11.02.59_AM.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=6b259000725c32c495332ec81842db00" alt="Resultados de whatsmydns.net mostrando el estado de propagación DNS global con indicadores verdes y rojos" width="2578" height="1492" data-path="images/docs/a3011bc8b7477b7a1e18cb16cfd69bba03cc1f19cf623ccddd1926722bfc585c-Screenshot_2024-10-23_at_11.02.59_AM.png" />
</Frame>

#### Errores comunes y soluciones

* **El registro TXT SPF no está verificado**
  * Probablemente tienes un registro SPF existente. Solo debes tener un registro TXT SPF — agrega directivas `include:` adicionales a su valor. Consulta la sección [Registros TXT](#registros-txt) anterior.
* **DNS no completamente propagado**
  * Si [whatsmydns.net](https://www.whatsmydns.net/) muestra una mezcla de ✅ y ❌, los registros no se han propagado completamente. Esto puede tomar hasta 48 horas. Espera y vuelve a verificar, o contacta a tu proveedor DNS.
* **El valor DNS no coincide con OneSignal**
  * Si los valores en [whatsmydns.net](https://www.whatsmydns.net/) no coinciden con lo que proporciona OneSignal:
    * Los registros MX que apuntan a otro lugar (por ejemplo, Google Mail) son esperados — está bien siempre que muestren ✅ en whatsmydns.net.
    * Verifica que el hostname sea correcto. `mail.yourdomain.com` no es lo mismo que `yourdomain.com`.
    * Contacta a tu proveedor DNS para obtener ayuda.

***

## Preguntas frecuentes

### ¿Cuánto tiempo tarda la verificación DNS?

La verificación generalmente se completa en minutos, pero la propagación DNS puede tomar hasta 48 horas dependiendo de tu proveedor y la configuración de TTL. Usa [whatsmydns.net](https://www.whatsmydns.net/) para verificar el progreso.

### ¿Qué pasa si ya tengo registros SPF o DMARC?

No crees registros duplicados. Para SPF, agrega `include:spf.onesignal.email` de OneSignal a tu registro TXT SPF existente. Para DMARC, verifica que tu registro existente incluya `v=DMARC1; p=none;` o una política más estricta.

### ¿Necesito registros MX si solo envío emails?

Los registros MX ayudan a evitar errores de verificación de dominio incluso para configuraciones de solo envío. Si ya usas un proveedor de correo como Gmail o Google Workspace, mantén tus registros MX existentes — no necesitas sobrescribirlos con los valores de OneSignal.

***

<Check>
  Regresa a [Configuración de email](./email-setup) para completar la configuración y comenzar a enviar emails.
</Check>

## Páginas relacionadas

<Columns cols={2}>
  <Card title="Configuración de email" icon="envelope" href="./email-setup">
    Configuración completa del canal de email incluyendo selección de proveedor y configuración DNS automática.
  </Card>

  <Card title="Remitentes" icon="paper-plane" href="./senders">
    Gestiona dominios de envío, direcciones de respuesta e identidades de remitente.
  </Card>

  <Card title="Guía de calentamiento de email" icon="temperature-arrow-up" href="./email-warm-up">
    Aumenta gradualmente el volumen de email para construir reputación de remitente y mejorar la entregabilidad.
  </Card>

  <Card title="Mensajería de email" icon="envelopes-bulk" href="./email-messaging">
    Crea y envía campañas de email con plantillas, personalización y programación.
  </Card>
</Columns>
