Pular para o conteúdo principal
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çãoO que detecta
Validação de sintaxeEndereços malformados com componentes obrigatórios ausentes (ex.: @ ausente, TLD inválido)
Detecção de erros de digitaçãoErros comuns de ortografia de domínio como gnail.com ou gmail.con
Verificação de registro MXDomínios sem registro de troca de email válido; emails enviados aqui não podem ser entregues
Endereço baseado em funçãoEndereços como sales@, info@, admin@ que provavelmente não pertencem a um indivíduo
Email descartávelDomí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.
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
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
  • 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
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
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
  • 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
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:
ObjetivoColunas obrigatóriasValor
Reinscrever endereços corrigidosemail, subscribedsubscribed = yes
Cancelar inscrição de endereços sinalizadosemail, subscribedsubscribed = no
Suprimir endereços sinalizadosemail, suppressedsuppressed = 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:
ErroO que significaO que fazer
Entrada inválidaO 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 emailUma 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 encontradoO 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çãoA 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ávelO 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, os endereços inválidos são excluídos da entrega e retornados em invalid_email_tokens. 
{
  "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 ou Criar Assinatura: 
{
  "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: 
{
  "success": false,
  "errors": ["[\"Identifier invalid format.\"]"]
}
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.