Skip to main content
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:
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

Advertencia de emails inválidos detectados en el paso Map Fields

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

Ajustes de validación de dirección de email en el paso de Revisión

  • 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

Opción Validate Email Addresses en el menú Update/Import Users

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

Modal de confirmación de Validar Direcciones de Email

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

Email de resultados de validación de OneSignal con resumen y enlace 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

Exportación CSV de los resultados de validación de email

Para limpiar tu audiencia, crea un nuevo CSV con las direcciones corregidas o procesadas y reimporta usando uno de los siguientes formatos de columna:

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:

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.

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:

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