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

# Solución de problemas de Email

> Cómo diagnosticar y solucionar problemas comunes de email de OneSignal.

Usa esta guía para identificar y resolver los problemas de email de OneSignal más comunes, incluyendo problemas de configuración, desafíos de entregabilidad y errores de diseño.

<Note>
  Antes de solucionar problemas, revisa nuestras guías de [Configuración de Email](./email-setup) y [Entregabilidad de Email](./email-deliverability). Estas cubren las causas más comunes de problemas de email.
</Note>

## Problemas de configuración

La mayoría de los problemas de configuración provienen de registros DNS incorrectos o limitaciones de tu proveedor de servicios de Email (ESP).

### Verificar registros DNS

1. Abre tu proveedor de DNS.
2. Confirma que los registros SPF, DKIM y MX coincidan con nuestra guía de [Configuración de DNS de Email](./email-dns-configuration).
3. Permite hasta 24 horas para que los cambios de DNS se propaguen.

<Warning>
  Si los registros DNS están mal configurados, los emails pueden no enviarse, rebotar o ser marcados como spam.
</Warning>

### Límites de envío mensuales (ESPs no OneSignal)

Si usas SendGrid, Mailchimp o Mailgun directamente (no a través de OneSignal Email), tu volumen de envío está limitado por tu plan ESP.
Verifica los registros de tu proveedor:

* [Feed de actividad de SendGrid](https://www.twilio.com/docs/sendgrid/ui/analytics-and-reporting/email-activity-feed)
* [Actividad e informes de Mailchimp](https://mailchimp.com/developer/transactional/docs/activity-reports/)
* [Registros de Mailgun](https://www.mailgun.com/products/send/email-analytics/logs/)

### Demasiadas búsquedas DNS

Al probar registros SPF con herramientas como [prueba URI](https://www.uriports.com/tools?method=spf\&domain=mail.daystrom-institute.com), puedes ver:

<Frame caption="Demasiadas búsquedas DNS">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/email/email-troubleshooting-too-many-dns-lookups.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=926c451d7d99431a4ed0e8092ff6b014" alt="Too many DNS lookups" width="1127" height="338" data-path="images/email/email-troubleshooting-too-many-dns-lookups.png" />
</Frame>

Esto es esperado si usas el registro SPF:

```
v=spf1 include:spf.onesignal.email include:mailgun.org ~all
```

OneSignal usa Mailgun "bajo el capó" como nuestro proveedor de servicios de Email. Esto significa que las búsquedas SPF apuntan a los mismos rangos de IP y en realidad no agregan búsquedas adicionales. Para eliminar la advertencia, puedes simplificar a:

```
v=spf1 include:mailgun.org ~all
```

Esto evitará el error y no afectará el envío de emails de OneSignal.

### Múltiples registros TXT para el dominio de remitente

Solo puedes tener **un** registro SPF para tu dominio de envío.
Verifica con [búsqueda TXT de WhatsMyDNS](https://www.whatsmydns.net/#TXT) para confirmar que no tienes múltiples entradas.

***

## Problemas de entregabilidad

Los problemas de entregabilidad incluyen envíos lentos, ubicación en la carpeta de spam y rebotes de email.

### Emails retrasados

Si tu dominio de envío es nuevo o tiene baja reputación, los ISPs (Gmail, Outlook, Yahoo) pueden retrasar la entrega. Esto se llama **limitación de tasa** o **greylisting**. Al ver tus [Informes de mensajes de Email](./email-message-reports), puedes verificar los detalles de cuánto tiempo nos tomó enviar el mensaje.

<Frame caption="Email enviado desde OneSignal en menos de 3 segundos">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/email/email-speed-message-report.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=ac366a1120913e1ee2204e7ce2baa4ed" alt="Email message report" width="2186" height="816" data-path="images/email/email-speed-message-report.png" />
</Frame>

En este ejemplo, vemos que el email fue enviado desde OneSignal en menos de 3 segundos. Lo enviamos al proveedor de servicios de Email, que luego va al ISP del destinatario. Estos servidores de email pueden retrasar el email hasta varias horas antes de que se entregue al destinatario.

<Note>
  Sigue nuestras [Mejores prácticas de reputación de Email](./email-reputation-best-practices) para acelerar la entrega.
</Note>

### Emails llegando a spam

La causa más común es una mala reputación del remitente. Sigue nuestra guía de [Entregabilidad de Email](./email-deliverability).

Si estás usando un ESP de terceros, consulta:

* [SendGrid: Listas de denegación](https://docs.sendgrid.com/ui/sending-email/deny-lists)
* [Mailgun: Información de lista negra](https://help.mailgun.com/hc/en-us/articles/115005365027-What-Is-a-Blacklist-)
* [Mailchimp: Reputación y rechazos](https://mailchimp.com/developer/transactional/docs/reputation-rejections/#rejected-emails)

### Envío y recepción desde el mismo dominio

Un solo dominio no puede usar los mismos registros MX para enviar y recibir correo simultáneamente. Si quieres **enviar** desde `@tudominio.com` y también **recibir** en el mismo dominio:

* Mantén tu DNS de envío con OneSignal.
* Apunta tus registros MX a tu proveedor de email entrante (por ejemplo, [registros MX de Google Workspace](https://support.google.com/a/topic/2683820?hl=en\&ref_topic=9202)).

### Listas de supresión

Si una dirección canceló la suscripción o te marcó como spam, tu ESP suprimirá los envíos a ella.
Para volver a suscribir:

1. Ve a **Audiencia > Suscripciones** en OneSignal.
2. Busca la dirección de email.
3. Haz clic en **Cancelar suscripción de Email** (si está suscrito) luego **Volver a suscribir a Email**.
4. Envía un email de prueba para confirmar.

### Apple Private Relay

Si envías a direcciones `@privaterelay.appleid.com`, debes verificar tu dominio de envío en tu [cuenta de desarrollador de Apple](https://developer.apple.com/help/account/configure-app-capabilities/configure-private-email-relay-service/).
Los dominios no verificados resultarán en emails descartados.

### Clave API demasiado restrictiva

Si usas SendGrid o Mailchimp, asegúrate de que tu clave API tenga los [permisos mínimos requeridos](./sendgrid-setup#what-are-the-minimum-api-restrictions-i-can-allow).

***

## Diseño de Email

Estos son problemas dentro del contenido del email en sí.

### Enlaces no funcionan

Generalmente causado por configuración CNAME faltante o incorrecta.
Si usas un ESP de terceros, sigue su configuración de dominio de seguimiento.

### Botones no hacen clic

* Asegúrate de que la URL sea correcta y comience con `https://`.
* Evita probar desde tu carpeta de spam: algunos clientes de email bloquean enlaces allí.

### Agregar imágenes al preencabezado

Gmail admite imágenes promocionales en preencabezados (anotaciones de ofertas, carruseles de productos).
Consulta el [Portal de desarrolladores de Gmail](https://developers.google.com/gmail/promotab/overview) para la configuración.

***

## Proveedores de servicios de Email (ESPs)

Preguntas o problemas comunes relacionados con el uso de nuestras integraciones con SendGrid, Mailchimp o Mailgun.

### ¿Tengo que pagar a otro proveedor por email?

Si usas la [Configuración de Email de OneSignal](./email-setup) entonces gestionaremos tus cuentas de email y no necesitas usar otro proveedor de email. Si planeas usar Sendgrid, Mailchimp o Mailgun, entonces necesitarás continuar pagando a tu proveedor de servicios de email directamente.

## ¿Cuál es el rendimiento de email de OneSignal?

OneSignal generalmente envía mensajes a una tasa de 1,000 a 5,000 por segundo al proveedor de servicios de Email. Depende de tu ESP entregar los emails a tus usuarios.

OneSignal usa Mailgun para OneSignal Email y Mailgun anuncia que pueden soportar hasta [15 millones de emails por hora](https://www.mailgun.com/blog/product/how-quickly-can-mailgun-process-my-messages-introducing-the-rapid-fire-throughput-sla/).

***
