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

Iniciar uma importação CSV

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

Aviso de emails inválidos detectados na etapa Map Fields

2

Configurar definições de validação na etapa de Revisão

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

Definições de validação de endereço de email na etapa de Revisão

  • 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.
3

Confirmar e importar

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

Abrir a ferramenta Validar Endereços de Email

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

Opção Validate Email Addresses no menu Update/Import Users

2

Iniciar validação

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

Modal de confirmação de Validar Endereços de Email

3

Receber seus resultados por email

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

Email de resultados de validação da OneSignal com resumo e link Baixar Exportação CSV

  • Erros de digitação
  • Endereços baseados em função
  • Domínios descartáveis
  • Registros MX inválidos
4

Revisar e reimportar

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

Exportação CSV dos resultados de validação de email

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:

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:

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, os endereços inválidos são excluídos da entrega e retornados em invalid_email_tokens.

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 ou Criar Assinatura:

Adicionar dispositivo: API Players Legada

Quando você adiciona ou edita um registro de player com um email inválido via API Players legada:
A API Players legada está obsoleta. Migre para a API de Modelo de Usuário para receber erros de validação mais descritivos e acessar os recursos atuais.