> ## 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. # Validação de endereço de email > Valide endereços de email durante a importação CSV e em massa para reduzir rejeições e proteger sua reputação de remetente. A validação de endereço de email detecta problemas comuns em endereços de email antes que cheguem ao seu público. Ela sinaliza erros de digitação, domínios inválidos, endereços baseados em função e serviços de email descartável que podem aumentar sua taxa de rejeição ou prejudicar sua reputação de remetente. Ela é executada automaticamente durante a importação de CSV e também está disponível como uma ferramenta de validação em massa para seu público existente. A validação de endereço de email verifica os endereços com base nos critérios de validação da OneSignal. Não é uma verificação de rejeição ao vivo e não garante a entregabilidade. ## Verificações de validação A validação de endereço de email avalia cada endereço com base nas seguintes verificações: | Verificação | O que detecta | | ---------------------------------- | -------------------------------------------------------------------------------------------- | | **Validação de sintaxe** | Endereços malformados com componentes obrigatórios ausentes (ex.: `@` ausente, TLD inválido) | | **Detecção de erros de digitação** | Erros comuns de ortografia de domínio como `gnail.com` ou `gmail.con` | | **Verificação de registro MX** | Domínios sem registro de troca de email válido; emails enviados aqui não podem ser entregues | | **Endereço baseado em função** | Endereços como `sales@`, `info@`, `admin@` que provavelmente não pertencem a um indivíduo | | **Email descartável** | Domínios associados a serviços de email temporários ou descartáveis | **Planos gratuitos** incluem validação de sintaxe e detecção de erros de digitação. **Planos pagos** incluem tudo isso mais verificação de registros MX, detecção de endereços baseados em função e filtragem de emails descartáveis. Se um endereço falhar em uma verificação, a validação de endereço de email retorna um erro legível explicando o problema específico. Se um endereço falhar em várias verificações, todos os motivos de falha são retornados juntos. *** ## Validar endereços durante a importação CSV Ao importar um CSV, você pode configurar as definições de validação de endereço de email na etapa de **Revisão** antes de confirmar a importação. Vá para **Audience > Import** e faça upload do seu arquivo. Conclua as etapas de **Upload** e **Map Fields**. Se endereços de email inválidos forem detectados, um aviso aparecerá na etapa **Map Fields**. Etapa Map Fields de importação CSV mostrando aviso de emails inválidos detectados Na etapa de **Revisão**, expanda **Definições de validação de endereço de email**. As seguintes opções estão disponíveis: Etapa de Revisão de importação CSV com Definições de validação de endereço de email expandidas * **Validar domínios de email (registros MX)**: confirmar que o domínio pode receber email * **Excluir endereços de email descartáveis**: evitar endereços temporários ou de uso único que podem reduzir o engajamento * **Excluir endereços de email baseados em função**: evitar endereços compartilhados como `info@` ou `support@` que geralmente têm menor engajamento Os três estão habilitados por padrão. Desmarque qualquer um que não queira aplicar a esta importação. Se precisar importar endereços de email inválidos (por exemplo, para atualizar o status de supressão ou assinatura), marque **Permitir endereços de email inválidos**. Isso ignora a validação e aceita qualquer string como endereço de email. Clique em **Confirm and Import**. Quando a importação for concluída, você receberá um email resumindo os resultados: * Assinaturas adicionadas * Assinaturas modificadas * Linhas não importadas, com link para download das linhas rejeitadas #### Resultado Endereços válidos são adicionados ao seu público. Você recebe um email quando a importação é concluída. Endereços que falharam na validação são excluídos e estão disponíveis para download pelo link no email de resultados. *** ## Validar seu público existente em massa Use a validação em massa para verificar endereços de email já presentes no seu público da OneSignal. Você recebe os resultados por email como exportação CSV. Vá para **Audience > Subscriptions** (ou **Audience > Users**), clique em **Update/Import Users** e selecione **Validate Email Addresses**. Menu suspenso Update/Import Users com a opção Validate Email Addresses destacada No modal, clique em **Start validation**. A validação de endereço de email é executada em todos os endereços de email do seu aplicativo. Modal Validate Email Addresses mostrando o botão Start validation Quando a validação for concluída, você receberá um email da OneSignal com um link **Baixar Exportação CSV**. O link fica ativo por 72 horas. O email resume quantos endereços falharam, divididos por: Email de resultados da OneSignal mostrando resumo de validação e botão Baixar Exportação CSV * Erros de digitação * Endereços baseados em função * Domínios descartáveis * Registros MX inválidos Baixe o CSV e revise os endereços sinalizados. Exportação CSV mostrando colunas email, reason, suggested_email, created_at, last_opened e last_clicked Para limpar seu público, crie um novo CSV com os endereços corrigidos ou processados e reimporte usando um dos seguintes formatos de coluna: | Objetivo | Colunas obrigatórias | Valor | | ------------------------------------------- | --------------------- | --------------------- | | Reinscrever endereços corrigidos | `email`, `subscribed` | `subscribed` = `yes` | | Cancelar inscrição de endereços sinalizados | `email`, `subscribed` | `subscribed` = `no` | | Suprimir endereços sinalizados | `email`, `suppressed` | `suppressed` = `true` | #### Resultado Você recebe um email com uma exportação CSV dos endereços sinalizados e um resumo dos resultados de validação divididos por tipo de erro. *** ## Referência de erros de validação Os seguintes erros podem aparecer nos resultados de validação: | Erro | O que significa | O que fazer | | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | **Entrada inválida** | O endereço está malformado e não atende aos requisitos básicos de sintaxe (ex.: `@` ausente, TLD inválido). | Corrija ou remova o endereço. | | **Erro de digitação no endereço de email** | Uma provável ortografia incorreta foi detectada no domínio. Uma correção sugerida aparece na coluna adjacente. | Aplique a correção sugerida ou remova o endereço. | | **Registro MX não encontrado** | O domínio não tem registro de troca de email válido. O email não pode ser entregue a este endereço. | Remova ou suprima o endereço. | | **Endereço de email baseado em função** | A parte local (antes de `@`) corresponde a um padrão baseado em função conhecido como `sales@` ou `support@`. É improvável que pertençam a um indivíduo. | Revise se o endereço é apropriado para seu caso de uso, depois suprima ou remova-o. | | **Endereço de email descartável** | O domínio está associado a um serviço de email temporário ou descartável. | Suprima ou remova o endereço. | *** ## Respostas de erro da API A validação de endereço de email também se aplica a endereços enviados pela API. As seções abaixo descrevem as respostas de erro que você pode encontrar. A validação da API verifica apenas se o endereço de email está formatado corretamente. Ela não verifica erros de digitação, registros MX, endereços baseados em função ou domínios descartáveis. Essas verificações estão disponíveis apenas durante a importação CSV e validação em massa. ### Enviar email: Criar Mensagem Quando você envia para um ou mais endereços inválidos via [endpoint Criar Mensagem](/reference/create-message), os endereços inválidos são excluídos da entrega e retornados em `invalid_email_tokens`. ```json theme={null} { "id": "", "errors": { "invalid_email_tokens": ["invalid@email"] } } ``` ### Adicionar usuário ou assinatura: API de Modelo de Usuário Quando você cria um usuário ou assinatura com um email inválido via endpoint [Criar Usuário](/reference/create-user) ou [Criar Assinatura](/reference/create-subscription): ```json theme={null} { "errors": [ { "title": "Invalid `token` format for device type email" } ] } ``` ### Adicionar dispositivo: API Players Legada Quando você adiciona ou edita um registro de player com um email inválido via [API Players legada](/reference/add-a-device): ```json theme={null} { "success": false, "errors": ["[\"Identifier invalid format.\"]"] } ``` A API Players legada está obsoleta. Migre para a [API de Modelo de Usuário](/reference/create-user) para receber erros de validação mais descritivos e acessar os recursos atuais.