Conteúdo de notificações para o recebimento de e-mails do Amazon SES - Amazon Simple Email Service
Objeto JSON de nível superiorreceipt objectmail object

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conteúdo de notificações para o recebimento de e-mails do Amazon SES

Todas as notificações de recebimento de e-mails são publicadas em tópicos do Amazon Simple Notification Service (Amazon SNS) no formato JavaScript Object Notation (JSON).

Por exemplos de notificação, consulte Exemplos de notificação .

Objeto JSON de nível superior

O objeto JSON de nível superior contém os seguintes campos.

Nome do campo Descrição
notificationType

O tipo de notificação. Para esse tipo de notificação, o valor é sempre Received.

receipt

O objeto que contém informações sobre a entrega de e-mails.

mail

O objeto que contém informações sobre o e-mail associado à notificação.

content

String que contém o e-mail bruto, não modificado, normalmente no formato Multipurpose Internet Mail Extensions (MIME). Para obter mais informações sobre o formato MIME, consulte RFC 2045.

nota

Este campo só está presente somente se a notificação foi acionada por uma ação do SNS. As notificações acionadas por todas as outras ações não contêm esse campo.

receipt object

O objeto receipt tem os seguintes campos.

Nome do campo Descrição

action

O objeto que encapsula informações sobre a ação que foi executada. Para obter uma lista de valores possíveis, consulte action object.

dkimVerdict

O objeto que indica se a verificação DomainKeys Identified Mail (DKIM) foi bem-sucedida. Para obter uma lista de valores possíveis, consulte dkimVerdict object.
dmarcPolicy

Indica as configurações de Domain-based Message Authentication, Reporting & Conformance (DMARC) para o domínio de envio. Esse campo só será exibido se a mensagem não passar na autenticação de DMARC.

Os valores possíveis para esse campo são:

  • none: o proprietário das solicitações de domínio de envio que nenhuma ação específica seja executada em mensagens que falharem na autenticação DMARC.

  • quarantine: o proprietário das solicitações de domínio de envio que mensagens que falharem na autenticação DMARC sejam tratadas pelos receptores como suspeitos.

  • reject: o proprietário das solicitações do domínio de envio que as mensagens que falharem na autenticação DMARC sejam rejeitadas.
dmarcVerdict O objeto que indica se a verificação de Domain-based Message Authentication, Reporting & Conformance (DMARC) foi bem-sucedida. Para obter uma lista de valores possíveis, consulte dmarcVerdict object.
processingTimeMillis

Sequência que especifica o período, em milissegundos, do momento em que o Amazon SES recebeu a mensagem até o momento em que ele acionou a ação.
recipients

Uma lista de destinatários (especificamente, os endereços de RCPT TO do envelope) que foram correspondidos pela regra de recebimento ativa. Os endereços listados aqui podem ser diferentes daqueles listados no campo destination no mail object.

spamVerdict

O objeto que indica se a mensagem é spam. Para obter uma lista de valores possíveis, consulte spamVerdict object.

spfVerdict

O objeto que indica se a verificação Sender Policy Framework (SPF) foi bem-sucedida. Para obter uma lista de valores possíveis, consulte spfVerdict object.
timestamp

Sequência que especifica a data e a hora em que a ação foi acionada, no formato ISO 8601.

virusVerdict

O objeto que indica se a mensagem contém vírus. Para obter uma lista de valores possíveis, consulte virusVerdict object.

action object

O objeto action tem os seguintes campos.

Nome do campo Descrição
type

String que indica o tipo de ação que foi executada. Os valores possíveis são S3, SNS, Bounce, Lambda, Stop e WorkMail.
topicArn

Sequência que contém o nome do recurso da Amazon (ARN) do tópico do Amazon SNS no qual a notificação foi publicada.
bucketName

Sequência que contém o nome do bucket do Amazon S3 no qual a mensagem foi publicada. Presente apenas para o tipo de ação do S3.
objectKey

Sequência que contém um nome que identifica exclusivamente o e-mail no bucket do Amazon S3. Ela é igual ao messageId em mail object. Presente apenas para o tipo de ação do S3.
smtpReplyCode

String que contém o código de resposta SMTP, conforme definido pelo RFC 5321. Presente apenas para o tipo de ação de devolução.
statusCode

String que contém o código de status aprimorado SMTP, conforme definido pelo RFC 3463. Presente apenas para o tipo de ação de devolução.
message

String que contém o texto legível a ser incluído na mensagem de devolução. Presente apenas para o tipo de ação de devolução.
sender

String que contém o endereço do remetente do e-mail que foi devolvido. Esse é o endereço de e-mail a partir do qual a mensagem de devolução foi enviada. Presente apenas para o tipo de ação de devolução.
functionArn

Sequência que contém o ARN da função do Lambda que foi acionada. Presente apenas para o tipo de ação do Lambda.
invocationType

Sequência que contém o tipo de invocação da função do Lambda. Os possíveis valores são RequestResponse e Event. Presente apenas para o tipo de ação do Lambda.
organizationArn

String que contém o Nome de recurso da Amazon (ARN) da organização do Amazon WorkMail. Presente apenas para o tipo de ação WorkMail.

dkimVerdict object

O objeto dkimVerdict tem os seguintes campos.

Nome do campo Descrição
status

String que contém o veredicto do DKIM. Os valores possíveis são:

  • PASS: a mensagem passou na autenticação DKIM.

  • FAIL: a mensagem não passou na autenticação DKIM.

  • GRAY: a mensagem não é assinada pelo DKIM ou o domínio de origem e o domínio de assinatura DKIM não correspondem.

  • PROCESSING_FAILED: há um problema que impede o Amazon SES de verificar a assinatura DKIM. Por exemplo, consultas de DNS estão falhando ou o cabeçalho da assinatura do DKIM não está formatado corretamente.

dmarcVerdict object

O objeto dmarcVerdict tem os seguintes campos.

Nome do campo Descrição
status

String que contém o veredicto do DMARC. Os valores possíveis são:

  • PASS: a mensagem passou na autenticação DMARC.

  • FAIL: a mensagem falhou na autenticação DMARC.

  • GRAY: pelo menos um dos SPF ou DKIM passou na autenticação, mas o domínio de envio não tem uma política DMARC ou usa a política p=none.

  • PROCESSING_FAILED: há um problema que impede que o Amazon SES forneça um veredicto do DMARC.

spamVerdict object

O objeto spamVerdict tem os seguintes campos.

Nome do campo Descrição
status

String que contém o resultado da verificação de spam. Os valores possíveis são:

  • PASS: a verificação de spam determinou que é improvável que a mensagem contenha spam.

  • FAIL: a verificação de spam determinou que é provável que a mensagem contenha spam.

  • GRAY: o Amazon SES examinou o e-mail, mas não pôde determinar com segurança se ele é spam.

  • PROCESSING_FAILED: o Amazon SES não pôde examinar o e-mail. Por exemplo, o e-mail não é uma mensagem MIME válida.

spfVerdict object

O objeto spfVerdict tem os seguintes campos.

Nome do campo Descrição
status

String que contém o veredicto do SPF. Os valores possíveis são:

  • PASS: a mensagem passou na autenticação SPF.

  • FAIL: a mensagem não passou na autenticação SPF.

  • GRAY: O resultado do SPF énone, softfail ou neutral.

  • PROCESSING_FAILED: há um problema que impede o Amazon SES de verificar o registro do SPF. Por exemplo, há falhas nas consultas de DNS.

virusVerdict object

O objeto virusVerdict tem os seguintes campos.

Nome do campo Descrição
status

String que contém o resultado da verificação de vírus. Os valores possíveis são:

  • PASS: a mensagem não contêm vírus.

  • FAIL: a mensagem contém vírus.

  • GRAY: o Amazon SES examinou o e-mail, mas não pôde determinar com segurança se ele contém um vírus.

  • PROCESSING_FAILED: o Amazon SES não pode examinar o conteúdo do e-mail. Por exemplo, o e-mail não é uma mensagem MIME válida.

mail object

O objeto mail tem os seguintes campos.

Nome do campo Descrição
destination

Uma lista completa de todos os endereços de destinatários (incluindo os destinatários Para: e Cc:) dos cabeçalhos MIME dos e-mails de entrada.
messageId

Sequência que contém o ID exclusivo atribuído ao e-mail pelo Amazon SES. Se o e-mail foi entregue ao Amazon S3, o ID da mensagem também é a chave de objeto do Amazon S3 que foi usada para gravar a mensagem em seu bucket do Amazon S3.
source

Sequência que contém o endereço de e-mail (especificamente o endereço MAIL FROM (E-MAIL DE) do envelope) do qual o e-mail foi enviado.
timestamp

String que contém o horário em que o e-mail foi recebido, no formato ISO8601.
headers

Uma lista de cabeçalhos do Amazon SES e seus cabeçalhos personalizados. Cada cabeçalho tem os seguintes campos: name e value.

commonHeaders

Uma lista de cabeçalhos comuns a todos os e-mails. Cada cabeçalho tem os seguintes campos: name e value.
headersTruncated

Sequência que especifica se os cabeçalhos foram truncados na notificação, o que acontece se os cabeçalhos tiverem mais do que 10 KB. Os possíveis valores são true e false.

commonHeaders object

O objeto commonHeaders pode ter os campos mostrados na tabela a seguir. Os campos presentes neste objeto variam de acordo com quais campos estavam presentes no e-mail recebido.

Nome do campo Descrição
messageId

O ID da mensagem original.
date

A data e hora em que o Amazon SES recebeu a mensagem.
to

O cabeçalho To do e-mail.
cc

O cabeçalho CC do e-mail.
bcc

O cabeçalho BCC do e-mail.
from

O cabeçalho From do e-mail.
sender

O cabeçalho Sender do e-mail.
returnPath

O cabeçalho Return-Path do e-mail.
replyTo

O cabeçalho Reply-To do e-mail.
subject

O cabeçalho Subject do e-mail.