Conteúdo dos dados de eventos publicados pelo Amazon SES no Firehose - Amazon Simple Email Service

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 dos dados de eventos publicados pelo Amazon SES no Firehose

O Amazon SES publica registros de evento de envio de e-mail no Amazon Data Firehose no formato JSON. Ao publicar eventos no Firehose, o Amazon SES adiciona no fim de cada registro JSON um caractere de nova linha.

É possível encontrar registros de exemplo para todos esses tipos de notificação em Exemplos de dados de eventos que o Amazon SES publica no Firehose.

Objeto JSON de nível superior

O objeto JSON de nível superior em um registro de evento de envio de e-mail contém os campos a seguir.

Nome do campo Descrição

eventType

Uma string que descreve o tipo de evento. Valores possíveis: Bounce, Complaint, Delivery, Send, Reject, Open, Click, Rendering Failure, DeliveryDelay ou Subscription.

Se você não configurou a publicação de eventos, este campo é chamado de notificationType.

mail

Um objeto JSON que contém informações sobre o e-mail que produziu o evento.

bounce

Esse campo estará presente apenas se eventType for Bounce. Ele contém informações sobre a devolução.

complaint

Esse campo estará presente apenas se eventType for Complaint. Ele contém informações sobre a reclamação.

delivery

Esse campo estará presente apenas se eventType for Delivery. Ele contém informações sobre a entrega.

send

Esse campo estará presente apenas se eventType for Send.

reject

Esse campo estará presente apenas se eventType for Reject. Ele contém informações sobre a rejeição.

open

Esse campo estará presente apenas se eventType for Open. Ele contém informações sobre o evento aberto.

click

Esse campo estará presente apenas se eventType for Click. Ele contém informações sobre o evento de clique.

failure

Esse campo estará presente apenas se eventType for Rendering Failure. Ele contém informações sobre o evento de Falha de renderização.

deliveryDelay

Esse campo estará presente apenas se eventType for DeliveryDelay. Ele contém informações sobre o atraso na entrega de um e-mail.

subscription

Esse campo estará presente apenas se eventType for Subscription. Ele contém informações sobre as preferências da assinatura.

Objeto de e-mail

Cada registro de evento de envio de e-mail contém informações sobre o e-mail original no objeto mail. O objeto JSON que contém informações sobre um objeto mail tem os seguintes campos.

Nome do campo Descrição

timestamp

A data e a hora, no formato ISO86 01 (YYYY-MM DDThh -:mm:ss.sz), em que a mensagem foi enviada.

messageId

Um ID exclusivo que o Amazon SES atribuiu à mensagem. O Amazon SES retornou esse valor quando você enviou a mensagem.

nota

Esse ID de mensagem foi atribuído pelo Amazon SES. Você pode encontrar o ID da mensagem do e-mail original nos campos headers e commonHeaders do objeto mail.

source

O endereço de e-mail do qual a mensagem foi enviada (o endereço MAIL FROM no envelope).

sourceArn

O nome de recurso da Amazon (ARN) da identidade que foi usada para enviar o e-mail. No caso de autorização de envio, o sourceArn é o ARN da identidade que o proprietário de identidade autorizou o remetente delegado a usar para enviar o e-mail. Para obter mais informações sobre a autorização de envio, consulte Métodos de autenticação de e-mail.

sendingAccountId

O AWS ID da conta que foi usada para enviar o e-mail. No caso de autorização de envio, sendingAccountId é o ID da conta do remetente delegado.

destination

Uma lista de endereços de e-mail que foram destinatários da mensagem original.

headersTruncated

Uma string que especifica se os cabeçalhos foram truncados na notificação, o que ocorre se os cabeçalhos tiverem mais de 10 KB. Os possíveis valores são true e false.

headers

Uma lista com os cabeçalhos originais do e-mail. Cada cabeçalho tem um campo name e um campo value.

nota

Qualquer ID de mensagem no campo headers é da mensagem original que você passou ao Amazon SES. O ID da mensagem que o Amazon SES subsequentemente atribuiu à mensagem está no campo messageId do objeto mail.

commonHeaders

Um mapeamento dos cabeçalhos de e-mail originais comumente utilizados.

nota

O ID de qualquer mensagem no campo commonHeaders é o ID da mensagem que o Amazon SES atribuiu subsequentemente à mensagem no campo messageId do objeto mail.

tags

Uma lista de tags associadas ao e-mail.

Objeto de devolução

O objeto JSON que contém informações sobre um evento Bounce tem sempre os seguintes campos.

Nome do campo Descrição

bounceType

O tipo de devolução, conforme determinado pelo Amazon SES.

bounceSubType

O subtipo da devolução, conforme determinado pelo Amazon SES.

bouncedRecipients

Uma lista que contém informações sobre os destinatários da mensagem original que foi devolvida.

timestamp

A data e a hora, no formato ISO86 01 (YYYY-MM DDThh -:mm:ss.sz), em que o ISP enviou a notificação de devolução.

feedbackId

Um ID exclusivo para a devolução.

reportingMTA

O valor do campo Reporting-MTA a partir do DSN. Esse é o valor da Message Transfer Authority (MTA) que tentou executar a operação de entrega, transmissão ou gateway descritas no DSN.

nota

Esse campo só será exibido se uma notificação do status de entrega (DSN) tiver sido conectada à devolução.

Destinatários com mensagens devolvidas

Um evento de devolução pode pertencer a um único destinatário ou a vários destinatários. O campo bouncedRecipients contém uma lista de objetos — um objeto por destinatário a quem o evento de devolução pertence — e sempre conterá o seguinte campo.

Nome do campo Descrição

emailAddress

O endereço de e-mail do destinatário. Se um DSN estiver disponível, esse será o valor do campo Final-Recipient do DSN.

Opcionalmente, se um DSN estiver conectado à devolução, os seguintes campos também poderão estar presentes.

Nome do campo Descrição

action

O valor do campo Action a partir do DSN. Isso indica a ação realizada pelo MTA que gera o relatório como resultado da sua tentativa de enviar a mensagem a esse destinatário.

status

O valor do campo Status a partir do DSN. Esse é o código de status independente do transporte por destinatário que indica o status de entrega da mensagem.

diagnosticCode

O código de status emitido pelo MTA de relatório. Esse é o valor do campo Diagnostic-Code a partir do DSN. Esse campo pode estar ausente no DSN (e, portanto, também ausente no JSON).

Tipos de devolução

Cada evento de devolução será de um dos tipos mostrados na tabela a seguir.

O sistema de publicação de eventos só publica devoluções definitivas e devoluções flexíveis que o Amazon SES não tentará mais enviar. Quando você receber devoluções marcadas como Permanent, remova os endereços de e-mail correspondentes da sua lista de e-mails; não será possível enviar para eles no futuro. As devoluções Transient são enviadas a você quando uma mensagem foi devolvida de modo condicional diversas vezes e o Amazon SES parou de tentar enviá-la. Você talvez consiga reenviar com sucesso para um endereço que inicialmente resultou em uma devolução Transient no futuro.

bounceType bounceSubType Descrição

Undetermined

Undetermined

O Amazon SES não foi capaz de determinar o motivo específico da devolução.

Permanent

General

O Amazon SES recebeu uma devolução definitiva genérica. Se você receber esse tipo de devolução, deverá remover o endereço de e-mail do destinatário da sua lista de correspondência.

Permanent

NoEmail

O Amazon SES recebeu uma devolução definitiva porque o endereço de e-mail de destino não existe. Se você receber esse tipo de devolução, deverá remover o endereço de e-mail do destinatário da sua lista de correspondência.

Permanent

Suppressed

O Amazon SES suprimiu o envio para este endereço, pois ele tem um histórico recente de devoluções como endereço inválido. Para substituir a lista de supressão global, consulte Como usar a lista de supressão do Amazon SES por conta.

Permanent OnAccountSuppressionList O Amazon SES suprimiu o envio para este endereço porque ele está na lista de supressão no nível da conta. Isso não conta para sua métrica de taxa de devolução.

Transient

General

O Amazon SES recebeu uma devolução genérica. Você pode enviar com êxito para esse destinatário no futuro.

Transient

MailboxFull

O Amazon SES recebeu uma devolução de caixa postal cheia. Você pode enviar com êxito para esse destinatário no futuro.

Transient

MessageTooLarge

O Amazon SES recebeu uma devolução de mensagem muito grande. Você pode enviar com êxito a esse destinatário se reduzir o tamanho da mensagem.

Transient

CustomTimeoutExceeded

O Amazon SES não conseguiu entregar o e-mail com êxito dentro do prazo especificado pelo remetente do e-mail. (A mensagem de devolução especificará o motivo de qualquer possível falha na tentativa de entrega dentro do TTL definido.)

Transient

ContentRejected

O Amazon SES recebeu uma devolução de conteúdo rejeitado. Você pode enviar com êxito a esse destinatário se alterar o conteúdo da mensagem.

Transient

AttachmentRejected

O Amazon SES recebeu uma devolução de anexo rejeitado. Você pode enviar com êxito a esse destinatário se remover ou alterar o anexo.

Objeto de reclamação

O objeto JSON que contém informações sobre um evento Complaint tem os seguintes campos.

Nome do campo Descrição

complainedRecipients

Uma lista que contém informações sobre os destinatários que podem ter enviado a reclamação.

timestamp

A data e a hora, no formato ISO86 01 (YYYY-MM DDThh -:mm:ss.sz), em que o ISP enviou a notificação de reclamação.

feedbackId

Um ID exclusivo para a reclamação.

complaintSubType

O subtipo da reclamação, conforme determinado pelo Amazon SES.

Além disso, se um relatório de feedback estiver conectado à reclamação, os campos a seguir poderão estar presentes.

Nome do campo Descrição

userAgent

O valor do campo User-Agent do relatório de feedback. Isso indica o nome e versão do sistema que gerou o relatório.

complaintFeedbackType

O valor do campo Feedback-Type do relatório de feedback recebido do ISP. Aí está contido o tipo de feedback.

arrivalDate

O valor do Received-Date campo Arrival-Date ou do relatório de feedback no formato ISO86 01 (YYYY-MM-:mm:ss.sz). DDThh Esse campo pode estar ausente no relatório (e, portanto, também ausente no JSON).

Destinatários que reclamaram

O campo complainedRecipients contém uma lista de destinatários que podem ter enviado a reclamação.

Importante

Como a maioria ISPs retira o endereço de e-mail do destinatário que enviou a reclamação a partir da notificação de reclamação, essa lista contém informações sobre os destinatários que podem ter enviado a reclamação, com base nos destinatários da mensagem original e no ISP do qual recebemos a reclamação. O Amazon SES realiza uma consulta para a mensagem original para determinar a lista de destinatários.

Os objetos JSON desta lista contêm o seguinte campo.

Nome do campo Descrição

emailAddress

O endereço de e-mail do destinatário.

Tipos de reclamação

Você pode ver os seguintes tipos de reclamação no campo complaintFeedbackType conforme atribuído pelo ISP que gerou o relatório, de acordo com o site da Internet Assigned Numbers Authority:

Nome do campo Descrição

abuse

Indica e-mail não solicitado ou algum outro tipo de abuso de e-mail.

auth-failure

Relatório de falha de autenticação de e-mail.

fraud

Indica algum tipo de atividade de phishing ou fraude.

not-spam

Indica que a entidade que fornece o relatório não considera a mensagem como spam. Isso pode ser usado para corrigir uma mensagem que foi incorretamente marcada ou classificada como spam.

other

Indica qualquer outro feedback que não se adequa a outros tipos registrados.

virus

Reporta que um vírus foi encontrado na mensagem de origem.

Objeto de entrega

O objeto JSON que contém informações sobre um evento Delivery tem sempre os seguintes campos.

Nome do campo Descrição

timestamp

A data e a hora em que o Amazon SES entregou o e-mail ao servidor de e-mail do destinatário, no formato ISO86 01 (YYYY-MM-:mm:ss.sz). DDThh

processingTimeMillis

O tempo em milissegundos entre quando o Amazon SES aceitou a solicitação do remetente até quando o Amazon SES passou a mensagem para o servidor de e-mail do destinatário.

recipients

Uma lista dos destinatários previstos à qual o evento de entrega se aplica.

smtpResponse

A mensagem de resposta SMTP do ISP remoto que aceitou o e-mail do Amazon SES. Esta mensagem poderá variar por e-mail, por servidor de e-mail de recebimento e por ISP de recebimento.

reportingMTA

O nome de host do servidor de e-mail do Amazon SES que enviou o e-mail.

remoteMtaIp

O endereço IP da MTA à qual o Amazon SES entregou o e-mail.

Objeto de envio

O objeto JSON que contém informações sobre um evento send está sempre vazio.

Objeto de rejeição

O objeto JSON que contém informações sobre um evento Reject tem sempre os seguintes campos.

Nome do campo Descrição

reason

O motivo pelo qual o e-mail foi rejeitado. O único valor possível é Bad content, o que significa que o Amazon SES detectou que o e-mail continha vírus. Quando uma mensagem é rejeitada, o Amazon SES interrompe o seu processamento e não tenta entregá-la ao servidor de e-mail do destinatário.

Objeto de abertura

O objeto JSON que contém informações sobre um evento Open tem sempre os seguintes campos.

Nome do campo Descrição

ipAddress

O endereço IP do destinatário.

timestamp

A data e a hora em que o evento aberto ocorreu no formato ISO86 01 (AAAA-MM -:MM:ss.sz). DDThh

userAgent

O agente do usuário do dispositivo ou cliente de e-mail que o destinatário usou para abrir o e-mail.

Objeto de clique

O objeto JSON que contém informações sobre um evento Click tem sempre os seguintes campos.

Nome do campo Descrição

ipAddress

O endereço IP do destinatário.

timestamp

A data e a hora em que o evento de clique ocorreu no formato ISO86 01 (AAAA-MM -:MM:ss.sz). DDThh

userAgent

O agente do usuário do cliente que o destinatário usou para clicar em um link no e-mail.

link

O URL do link em que o destinatário clicou.

linkTags

Uma lista de tags que foram adicionadas ao link usando o atributo ses:tags. Para obter mais informações sobre como adicionar tags aos links nos seus e-mails, consulte P5. Posso usar tags em links com identificadores exclusivos? no Métricas de envio de e-mail do Amazon SES FAQs.

Objeto de falha de renderização

O objeto JSON que contém informações sobre um evento Rendering Failure tem os seguintes campos.

Nome do campo Descrição

templateName

O nome do modelo usado para enviar o e-mail.

errorMessage

Uma mensagem que fornece mais informações sobre a Falha de renderização.

DeliveryDelay objeto

O objeto JSON que contém informações sobre um evento DeliveryDelay tem os seguintes campos.

Nome do campo Descrição

delayType

O tipo de atraso. Os valores possíveis são:

  • InternalFailure— Um problema interno do Amazon SES fez com que a mensagem fosse adiada.

  • General: ocorreu uma falha genérica durante a conversa SMTP.

  • MailboxFull— A caixa de correio do destinatário está cheia e não consegue receber mensagens adicionais.

  • SpamDetected— O servidor de e-mail do destinatário detectou uma grande quantidade de e-mails não solicitados da sua conta.

  • RecipientServerError— Um problema temporário com o servidor de e-mail do destinatário está impedindo a entrega da mensagem.

  • IPFailure— O endereço IP que está enviando a mensagem está sendo bloqueado ou limitado pelo provedor de e-mail do destinatário.

  • TransientCommunicationFailure— Houve uma falha temporária de comunicação durante a conversa SMTP com o provedor de e-mail do destinatário.

  • BYOIPHostNameLookupUnavailable— O Amazon SES não conseguiu pesquisar o nome do host DNS para seus endereços IP. Esse tipo de atraso só ocorre quando o recurso Traga seu próprio IP é usado.

  • Undetermined o Amazon SES não conseguiu determinar o motivo do atraso na entrega.

  • SendingDeferral— O Amazon SES considerou apropriado adiar internamente a mensagem.

delayedRecipients

Um objeto que contém informações sobre o destinatário do e-mail.

expirationTime

A data e a hora em que o Amazon SES deixará de tentar entregar a mensagem. Esse valor é mostrado no formato ISO 8601.

reportingMTA

O endereço IP do Message Transfer Agent (MTA) que relatou o atraso.

timestamp

A data e a hora em que ocorreu o atraso, mostradas no formato ISO 8601.

Destinatários com mensagens atrasadas

O objeto delayedRecipients contém os valores a seguir.

Nome do campo Descrição

emailAddress

O endereço de e-mail que resultou no atraso na entrega da mensagem.

status

O código de status SMTP associado ao atraso de entrega.

diagnosticCode

O código de diagnóstico fornecido pelo Message Transfer Agent (MTA) receptor.

Objeto Assinatura

O objeto JSON que contém informações sobre um evento Subscription tem os seguintes campos.

Nome do campo Descrição

contactList

O nome da lista na qual o contato está.

timestamp

A data e a hora, no formato ISO86 01 (YYYY-MM DDThh -:mm:ss.sz), em que o ISP enviou a notificação de assinatura.

source

O endereço de e-mail do qual a mensagem foi enviada (o endereço MAIL FROM no envelope).

newTopicPreferences

Uma estrutura de dados JSON (mapa) que especifica o status da assinatura de todos os tópicos na lista de contatos, indicando o status após uma alteração (contato assinado ou cancelado).

oldTopicPreferences

Uma estrutura de dados JSON (mapa) que especifica o status da assinatura de todos os tópicos na lista de contatos, indicando o status antes da alteração (contato assinado ou cancelado).

Preferências de tópicos novos/antigos

Os objetos newTopicPreferences e oldTopicPreferences contêm os valores a seguir.

Nome do campo Descrição

unsubscribeAll

Especifica se o contato cancelou a assinatura de todos os tópicos da lista de contatos.

topicSubscriptionStatus

Especifica o status da assinatura do tópico no campo topicName indicando se ele está atualmente inscrito para receber notificações do SES para o tipo de evento especificado. Os valores possíveis são OptIn(inscrito) ou OptOut(não inscrito) no campo. subscriptionStatus

topicDefaultSubscriptionStatus

Especifica o status padrão da assinatura do tópico no campo topicName determinando se novos tópicos adicionados ao destino de evento serão inscritos ou não inscritos por padrão. Os valores possíveis são OptIn(assinados por padrão) ou OptOut(não assinados por padrão) no campo. subscriptionStatus