Validação de e-mail

Este artigo de referência aborda as regras de validação da parte local e do host para endereços de e-mail. A validação é usada para endereços de e-mail do dashboard, endereços de e-mail do usuário final (seus clientes) e endereços de origem e de resposta de uma mensagem de e-mail.

Como funciona?

A validação de e-mail é realizada quando o endereço de e-mail de um usuário foi atualizado ou está sendo importado para o Braze via API, upload de CSV ou SDK, ou modificado no dashboard. Note que seus endereços de e-mail não podem incluir espaços em branco. Se estiver usando a API, os espaços em branco resultarão em um erro 400.

O Braze não aceita determinados caracteres e os reconhece como inválidos. Se um e-mail for devolvido, a Braze marcará o e-mail como inválido e o status da inscrição não será alterado.

Essa validação não deve ser confundida com um serviço de validação como o Briteverify. Essa é uma verificação para verificar se a sintaxe de um endereço de e-mail está correta. Um dos principais motivos para usar esse processo de validação é o suporte a caracteres internacionais (como UTF-8) na parte local do endereço de e-mail.

A validação da sintaxe do e-mail examina a parte local e a parte do host de um endereço de e-mail. A parte da localização é qualquer coisa antes da arroma (@), e a parte do host é qualquer coisa depois da arroba. Por exemplo, essa parte local de um endereço de e-mail pode começar e terminar com qualquer um dos caracteres permitidos, exceto um ponto (.). Observe que esse processo valida apenas a sintaxe do endereço de e-mail e não considera se o domínio tem um servidor MX válido ou se o usuário existe no domínio listado.

Se o Braze receber uma solicitação para adicionar um usuário e o endereço de e-mail for considerado inválido, você verá uma resposta de erro na API. Ao fazer upload via CSV, um usuário era criado, mas o endereço de e-mail não era adicionado.

Regras de validação de peça local

Validação geral de e-mail

Na maioria dos domínios, a parte local deve seguir esses parâmetros:

• Pode conter qualquer letra ou número, inclusive letras e números Unicode, bem como os seguintes caracteres: (+) (&) (#) (_) (-) (^) ou (/)
• Pode conter, mas não pode começar ou terminar com o seguinte caractere: (.)
• Não pode conter aspas duplas (“)
• Deve ter entre 1 e 64 caracteres de comprimento

A expressão regular a seguir pode ser usada para validar se um endereço de e-mail será considerado válido:

1
/\A([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}])(([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~\.]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}])*([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}]))?\z/

Endereços do Gmail

Se a parte do domínio for um endereço do Gmail, a parte da localização deverá ter pelo menos dois caracteres e seguir a validação de expressão regular listada acima.

Domínios da Microsoft

Se o domínio do host incluir “msn”, “hotmail”, “outlook” ou “live”, a seguinte expressão regular será usada para validar a parte da localização: /\A\w[\-\w]*(?:\.[\-\w]+)*\z/i

A parte local do endereço Microsoft deve seguir esses parâmetros:

• Pode começar com um caractere (a-z), um sublinhado (_) ou um número (0-9).
• Pode conter qualquer caractere alfanumérico (a-z ou 0-9) ou um sublinhado (_)
• Pode conter os seguintes caracteres: (.) ou (-) ou (+) ou (^)
• Não pode começar com um ponto (.)
• Não pode conter dois ou mais pontos consecutivos (.)
• Não pode terminar com um ponto (.)

Note que o teste de validação verifica se a parte da localização, que precede o “+”, corresponde à expressão regular.

Regras de validação da parte do host

Não são permitidos endereços IPv4 ou IPv6 na parte do host de um endereço de e-mail. O domínio de nível superior (como .com, .org, .net, etc.) pode não ser totalmente numérico.

A seguinte expressão regular é usada para validar o domínio:
/^[a-z\d](?:[a-z\d-]{0,61}[a-z\d])?(?:\.[a-z\d](?:[a-z\d-]{0,61}[a-z\d])?)+$/i

O nome do domínio deve seguir esses parâmetros:

• Consiste em dois ou mais rótulos separados por pontos
  • Cada parte de um nome de domínio é chamada de “rótulo”. Por exemplo, o nome de domínio “example.com” consiste no rótulo “example” e no rótulo “com”.
• Deve conter pelo menos um ponto (.)
• Não pode conter dois ou mais períodos consecutivos
• Cada rótulo separado por período deve:
  • Contém apenas caracteres alfanuméricos (a-z ou 0-9) e o hífen (-)
  • Comece com um caractere alfanumérico (a-z ou 0-9)
  • Terminar com um caractere alfanumérico (a-z ou 0-9)
  • Contém de 1 a 63 caracteres

Validação adicional necessária

O rótulo final do domínio deve ser um domínio de nível superior (TLD) válido, que é determinado por qualquer coisa após o ponto final (.). Esse TLD deve estar na lista de TLDs da ICANN. O validador de e-mail do Braze verifica apenas se a sintaxe do e-mail está correta de acordo com a expressão regular listada nesta seção. Ele não captura erros de digitação ou endereços que não existem.