Saltar al contenido principal
La validación de dirección de email detecta problemas comunes en las direcciones de email antes de que lleguen a tu audiencia. Señala errores tipográficos, dominios inválidos, direcciones basadas en función y servicios de email desechable que podrían aumentar tu tasa de rebote o perjudicar tu reputación de remitente. Se ejecuta automáticamente durante la importación de CSV y también está disponible como herramienta de validación masiva para tu audiencia existente.
La validación de dirección de email verifica las direcciones según los criterios de validación de OneSignal. No es una verificación de rebote en tiempo real y no garantiza la entregabilidad.

​
Verificaciones de validación

La validación de dirección de email evalúa cada dirección según las siguientes verificaciones:
VerificaciónQué detecta
Validación de sintaxisDirecciones malformadas con componentes obligatorios ausentes (ej.: @ ausente, TLD inválido)
Detección de errores tipográficosErrores ortográficos comunes de dominio como gnail.com o gmail.con
Verificación de registro MXDominios sin registro de intercambio de correo válido; los emails enviados aquí no se pueden entregar
Dirección basada en funciónDirecciones como sales@, info@, admin@ que probablemente no pertenecen a un individuo
Email desechableDominios asociados a servicios de email temporales o desechables
Los planes gratuitos incluyen validación de sintaxis y detección de errores tipográficos. Los planes de pago incluyen todo lo anterior más verificación de registros MX, detección de direcciones basadas en función y filtrado de emails desechables.
Si una dirección falla en una verificación, la validación de dirección de email devuelve un error legible que explica el problema específico. Si una dirección falla en varias verificaciones, todos los motivos de fallo se devuelven juntos.

​
Validar direcciones durante la importación CSV

Al importar un CSV, puedes configurar los ajustes de validación de dirección de email en el paso de Revisión antes de confirmar la importación.
1

Iniciar una importación CSV

Ve a Audience > Import y sube tu archivo. Completa los pasos de Upload y Map Fields. Si se detectan direcciones de email inválidas, aparecerá una advertencia en el paso Map Fields.
Paso Map Fields de importación CSV mostrando advertencia de emails inválidos detectados
2

Configurar los ajustes de validación en el paso de Revisión

En el paso de Revisión, expande Ajustes de validación de dirección de email. Las siguientes opciones están disponibles:
Paso de Revisión de importación CSV con Ajustes de validación de dirección de email expandidos
  • Validar dominios de email (registros MX): confirmar que el dominio puede recibir email
  • Excluir direcciones de email desechables: evitar direcciones temporales o de un solo uso que pueden reducir el engagement
  • Excluir direcciones de email basadas en función: evitar direcciones compartidas como info@ o support@ que generalmente tienen menor engagement
Los tres están habilitados de forma predeterminada. Desmarca cualquiera que no quieras aplicar a esta importación.
Si necesitas importar direcciones de email inválidas (por ejemplo, para actualizar el estado de supresión o suscripción), marca Permitir direcciones de email inválidas. Esto omite la validación y acepta cualquier cadena como dirección de email.
3

Confirmar e importar

Haz clic en Confirmar e Importar. Cuando se complete la importación, recibirás un email con un resumen de los resultados:
  • Suscripciones añadidas
  • Suscripciones modificadas
  • Filas no importadas, con enlace para descargar las filas rechazadas

​
Resultado

Las direcciones válidas se añaden a tu audiencia. Recibes un email cuando se completa la importación. Las direcciones que fallaron la validación se excluyen y están disponibles para descargar desde el enlace en el email de resultados.

​
Validar tu audiencia existente de forma masiva

Usa la validación masiva para verificar las direcciones de email ya presentes en tu audiencia de OneSignal. Recibes los resultados por email como exportación CSV.
1

Abrir la herramienta Validar Direcciones de Email

Ve a Audience > Subscriptions (o Audience > Users), haz clic en Update/Import Users y selecciona Validate Email Addresses.
Menú desplegable Update/Import Users con la opción Validate Email Addresses resaltada
2

Iniciar validación

En el modal, haz clic en Start validation. La validación de dirección de email se ejecuta en todas las direcciones de email de tu app.
Modal Validate Email Addresses mostrando el botón Start validation
3

Recibir tus resultados por email

Cuando se complete la validación, recibirás un email de OneSignal con un enlace Descargar Exportación CSV. El enlace está activo durante 72 horas. El email resume cuántas direcciones fallaron, desglosadas por:
Email de resultados de OneSignal mostrando resumen de validación y botón Descargar Exportación CSV
  • Errores tipográficos
  • Direcciones basadas en función
  • Dominios desechables
  • Registros MX inválidos
4

Revisar y reimportar

Descarga el CSV y revisa las direcciones marcadas.
Exportación CSV mostrando columnas email, reason, suggested_email, created_at, last_opened y last_clicked
Para limpiar tu audiencia, crea un nuevo CSV con las direcciones corregidas o procesadas y reimporta usando uno de los siguientes formatos de columna:
ObjetivoColumnas requeridasValor
Resuscribir direcciones corregidasemail, subscribedsubscribed = yes
Cancelar suscripción de direcciones marcadasemail, subscribedsubscribed = no
Suprimir direcciones marcadasemail, suppressedsuppressed = true

​
Resultado

Recibes un email con una exportación CSV de las direcciones marcadas y un resumen de los resultados de validación desglosados por tipo de error.

​
Referencia de errores de validación

Los siguientes errores pueden aparecer en los resultados de validación:
ErrorQué significaQué hacer
Entrada inválidaLa dirección está malformada y no cumple los requisitos básicos de sintaxis (ej.: @ ausente, TLD inválido).Corrige o elimina la dirección.
Error tipográfico en la dirección de emailSe detectó un probable error ortográfico en el dominio. Una corrección sugerida aparece en la columna adyacente.Aplica la corrección sugerida o elimina la dirección.
Registro MX no encontradoEl dominio no tiene un registro de intercambio de correo válido. El email no se puede entregar a esta dirección.Elimina o suprime la dirección.
Dirección de email basada en funciónLa parte local (antes de @) coincide con un patrón conocido basado en función como sales@ o support@. Es improbable que pertenezca a un individuo.Revisa si la dirección es apropiada para tu caso de uso, luego suprímela o elimínala.
Dirección de email desechableEl dominio está asociado a un servicio de email temporal o desechable.Suprime o elimina la dirección.

​
Respuestas de error de la API

La validación de dirección de email también se aplica a las direcciones enviadas a través de la API. Las secciones a continuación describen las respuestas de error que puedes encontrar.
La validación de la API solo verifica que la dirección de email tenga el formato correcto. No verifica errores tipográficos, registros MX, direcciones basadas en función o dominios desechables. Esas verificaciones solo están disponibles durante la importación CSV y la validación masiva.

​
Enviar email: Crear Mensaje

Cuando envías a una o más direcciones inválidas a través del endpoint Crear Mensaje, las direcciones inválidas se excluyen de la entrega y se devuelven en invalid_email_tokens. 
{
  "id": "",
  "errors": {
    "invalid_email_tokens": ["invalid@email"]
  }
}

​
Añadir usuario o suscripción: API de Modelo de Usuario

Cuando creas un usuario o suscripción con un email inválido a través del endpoint Crear Usuario o Crear Suscripción: 
{
  "errors": [
    {
      "title": "Invalid `token` format for device type email"
    }
  ]
}

​
Añadir dispositivo: API Players heredada

Cuando añades o editas un registro de player con un email inválido a través de la API Players heredada: 
{
  "success": false,
  "errors": ["[\"Identifier invalid format.\"]"]
}
La API Players heredada está obsoleta. Migra a la API de Modelo de Usuario para recibir errores de validación más descriptivos y acceder a las funciones actuales.