> ## 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. # Validación de dirección de email > Valida direcciones de email durante la importación CSV y de forma masiva para reducir rebotes y proteger tu reputación de remitente. 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ón | Qué detecta | | ------------------------------------- | ----------------------------------------------------------------------------------------------------- | | **Validación de sintaxis** | Direcciones malformadas con componentes obligatorios ausentes (ej.: `@` ausente, TLD inválido) | | **Detección de errores tipográficos** | Errores ortográficos comunes de dominio como `gnail.com` o `gmail.con` | | **Verificación de registro MX** | Dominios sin registro de intercambio de correo válido; los emails enviados aquí no se pueden entregar | | **Dirección basada en función** | Direcciones como `sales@`, `info@`, `admin@` que probablemente no pertenecen a un individuo | | **Email desechable** | Dominios 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. 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 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. 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. 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 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 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 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: | Objetivo | Columnas requeridas | Valor | | -------------------------------------------- | --------------------- | --------------------- | | Resuscribir direcciones corregidas | `email`, `subscribed` | `subscribed` = `yes` | | Cancelar suscripción de direcciones marcadas | `email`, `subscribed` | `subscribed` = `no` | | Suprimir direcciones marcadas | `email`, `suppressed` | `suppressed` = `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: | Error | Qué significa | Qué hacer | | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | | **Entrada inválida** | La 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 email** | Se 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 encontrado** | El 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ón** | La 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 desechable** | El 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](/reference/create-message), las direcciones inválidas se excluyen de la entrega y se devuelven en `invalid_email_tokens`. ```json theme={null} { "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](/reference/create-user) o [Crear Suscripción](/reference/create-subscription): ```json theme={null} { "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](/reference/add-a-device): ```json theme={null} { "success": false, "errors": ["[\"Identifier invalid format.\"]"] } ``` La API Players heredada está obsoleta. Migra a la [API de Modelo de Usuario](/reference/create-user) para recibir errores de validación más descriptivos y acceder a las funciones actuales.