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
<a name="event-publishing-retrieving-firehose-contents"></a>

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](event-publishing-retrieving-firehose-examples.md).

**Topics**
+ [Objeto JSON de nível superior](#event-publishing-retrieving-firehose-contents-top-level-json-object)
+ [Objeto de e-mail](#event-publishing-retrieving-firehose-contents-mail-object)
+ [Objeto de devolução](#event-publishing-retrieving-firehose-contents-bounce-object)
+ [Objeto de reclamação](#event-publishing-retrieving-firehose-contents-complaint-object)
+ [Objeto de entrega](#event-publishing-retrieving-firehose-contents-delivery-object)
+ [Objeto de envio](#event-publishing-retrieving-firehose-contents-send-object)
+ [Objeto de rejeição](#event-publishing-retrieving-firehose-contents-reject-object)
+ [Objeto de abertura](#event-publishing-retrieving-firehose-contents-open-object)
+ [Objeto de clique](#event-publishing-retrieving-firehose-contents-click-object)
+ [Objeto de falha de renderização](#event-publishing-retrieving-firehose-contents-failure-object)
+ [DeliveryDelay objeto](#event-publishing-retrieving-firehose-delivery-delay-object)
+ [Objeto Assinatura](#event-publishing-retrieving-firehose-subscription-object)

## Objeto JSON de nível superior
<a name="event-publishing-retrieving-firehose-contents-top-level-json-object"></a>

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 | Description | 
| --- | --- | 
|  `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](monitor-sending-using-event-publishing-setup.md), 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
<a name="event-publishing-retrieving-firehose-contents-mail-object"></a>

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 | Description | 
| --- | --- | 
|  `timestamp`  |  A data e a hora, no ISO8601 formato (*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.  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-mailUsar autorização de envio](sending-authorization.md).  | 
|  `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`.  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.  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
<a name="event-publishing-retrieving-firehose-contents-bounce-object"></a>

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


| Nome do campo | Description | 
| --- | --- | 
|  `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 ISO8601 formato (*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.  Esse campo só será exibido se uma notificação do status de entrega (DSN) tiver sido conectada à devolução.   | 

### Destinatários com mensagens devolvidas
<a name="event-publishing-retrieving-firehose-contents-bounced-recipients"></a>

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 | Description | 
| --- | --- | 
|  `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 | Description | 
| --- | --- | 
|  `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
<a name="event-publishing-retrieving-firehose-contents-bounce-types"></a>

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 | Description | 
| --- | --- | --- | 
|  `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](sending-email-suppression-list.md).   | 
| 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](sending-email-suppression-list.md). 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
<a name="event-publishing-retrieving-firehose-contents-complaint-object"></a>

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


| Nome do campo | Description | 
| --- | --- | 
|  `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, em ISO8601 formato (*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 | Description | 
| --- | --- | 
|  `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 em ISO8601 formato (*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
<a name="event-publishing-retrieving-firehose-contents-complained-recipients"></a>

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 | Description | 
| --- | --- | 
|  `emailAddress`  |  O endereço de e-mail do destinatário.  | 

### Tipos de reclamação
<a name="event-publishing-retrieving-firehose-contents-complaint-types"></a>

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](https://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2):


| Nome do campo | Description | 
| --- | --- | 
|  `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
<a name="event-publishing-retrieving-firehose-contents-delivery-object"></a>

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


| Nome do campo | Description | 
| --- | --- | 
|  `timestamp`  |  A data e a hora em que o Amazon SES entregou o e-mail ao servidor de e-mail do destinatário, no ISO8601 formato (*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
<a name="event-publishing-retrieving-firehose-contents-send-object"></a>

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

## Objeto de rejeição
<a name="event-publishing-retrieving-firehose-contents-reject-object"></a>

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


| Nome do campo | Description | 
| --- | --- | 
|  `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
<a name="event-publishing-retrieving-firehose-contents-open-object"></a>

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


| Nome do campo | Description | 
| --- | --- | 
|  `ipAddress`  |  O endereço IP do destinatário.  | 
|  `timestamp`  |  A data e a hora em que o evento aberto ocorreu no ISO8601 formato (*YYYY-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
<a name="event-publishing-retrieving-firehose-contents-click-object"></a>

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


| Nome do campo | Description | 
| --- | --- | 
|  `ipAddress`  |  O endereço IP do destinatário.  | 
|  `timestamp`  |  A data e a hora em que o evento de clique ocorreu no ISO8601 formato (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?](faqs-metrics.md#sending-metric-faqs-clicks-q5) no [Métricas de envio de e-mail do Amazon SES FAQs](faqs-metrics.md).  | 

## Objeto de falha de renderização
<a name="event-publishing-retrieving-firehose-contents-failure-object"></a>

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


| Nome do campo | Description | 
| --- | --- | 
|  `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
<a name="event-publishing-retrieving-firehose-delivery-delay-object"></a>

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


| Nome do campo | Description | 
| --- | --- | 
|  `delayType`  |  O tipo de atraso. Os valores possíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/ses/latest/dg/event-publishing-retrieving-firehose-contents.html)  | 
|  `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
<a name="event-publishing-retrieving-firehose-contents-delivery-delay-object-recipients"></a>

O objeto `delayedRecipients` contém os valores a seguir.


| Nome do campo | Description | 
| --- | --- | 
|  `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
<a name="event-publishing-retrieving-firehose-subscription-object"></a>

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


| Nome do campo | Description | 
| --- | --- | 
|  `contactList`  |  O nome da lista na qual o contato está.  | 
|  `timestamp`  |  A data e a hora, no ISO8601 formato *(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
<a name="event-publishing-retrieving-firehose-contents-subscription-object-topic-preferences"></a>

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


| Nome do campo | Description | 
| --- | --- | 
|  `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`  |