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**
+ [Top-level Objeto JSON](#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)

## Top-level Objeto JSON
<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`.<br />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 formato ISO8601 (*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 formato ISO8601 (*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 | saltar SubType | 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. | 
| Permanent | EmailValidationSuppressed | O Amazon SES suprimiu o envio para esse endereço porque o endereço não atingiu o limite para suas configurações de [validação de e-mail](email-validation-auto.md). | 
| Permanent | OnTenantSuppressionList | O Amazon SES suprimiu o envio para esse endereço porque ele está na lista de supressão em nível [de inquilino](sending-email-suppression-list-tenant-level.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, no formato ISO8601 (*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 no formato ISO8601 (). *YYYY-MM-DDThh:mm:ss.sZ* 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 dos ISPs oculta o endereço de e-mail do destinatário que enviou a reclamação da notificação de reclamação, esta lista contém informações sobre os destinatários que podem ter enviado a reclamação, baseado nos destinatários da mensagem original e no ISP do qual recebemos a reclamação. O Amazon SES executa uma consulta em relação 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 formato ISO8601 (). *YYYY-MM-DDThh:mm:ss.sZ* | 
| `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 formato ISO8601 (). *YYYY-MM-DDThh:mm:ss.sZ* | 
| `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 formato ISO8601 (). *YYYY-MM-DDThh:mm:ss.sZ* | 
| `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 formato ISO8601 *(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). | 

### New/old preferências de tópico
<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` |