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á.
# Configuração de notificações de eventos para o Amazon SES
Para enviar e-mails usando o Amazon SES, você deve ter um sistema implantado para gerenciar devoluções e reclamações. O Amazon SES pode notificar você sobre eventos de devolução ou de reclamação de três formas: enviando um e-mail de notificação, notificando um tópico do Amazon SNS ou publicando os eventos de envio. Esta seção contém informações sobre como configurar o Amazon SES para enviar determinados tipos de notificações por e-mail ou notificando um tópico do Amazon SNS. Para obter mais informações sobre como publicar eventos de envio, consulte [Monitorar o envio de e-mails usando a publicação de eventos do Amazon SES](monitor-using-event-publishing.md).
Você pode configurar notificações usando o console do Amazon SES ou a API do Amazon SES.
**Topics**
+ [
## Considerações importantes
](#monitor-sending-activity-using-notifications-considerations)
+ [
# Recebimento de notificações do Amazon SES por e-mail
](monitor-sending-activity-using-notifications-email.md)
+ [
# Recebimento de notificações do Amazon SES usando o Amazon SNS
](monitor-sending-activity-using-notifications-sns.md)
## Considerações importantes
Há vários pontos importantes a serem considerados ao configurar o Amazon SES para enviar notificações:
+ E-mail e notificações do Amazon SNS se aplicam a identidades individuais (os endereços de e-mail ou domínios verificados que você usa para enviar e-mail). Quando você ativa as notificações para uma identidade, o Amazon SES envia notificações somente para e-mails enviados dessa identidade e somente na AWS região em que você configurou as notificações.
+ Você precisa habilitar um método para recebimento de notificações de devolução ou de reclamação. Você pode enviar notificações para o domínio ou endereço de e-mail que gerou a devolução ou a reclamação ou para um tópico do Amazon SNS. Você também pode usar a [publicação de eventos](monitor-using-event-publishing.md) para enviar notificações sobre vários tipos diferentes de eventos (incluindo devoluções, reclamações, entregas e mais) para um tópico do Amazon SNS ou para um fluxo do Firehose.
Se você não configurar um desses métodos de recebimento de notificações de devolução ou reclamação, o Amazon SES encaminhará automaticamente as notificações de devolução e reclamação para o endereço Return-Path (Caminho de devolução) (ou para o endereço de origem, se você não especificar um endereço de Return-Path) no e-mail que resultou no evento de devolução ou reclamação, mesmo que você tenha desabilitado o encaminhamento de comentários de e-mail.
Se desabilitar o encaminhamento de comentários de e-mail e habitar a publicação de eventos, você deverá aplicar o conjunto de configurações que contém a regra de publicação de eventos para todos os e-mails que envia. Nessa situação, se você não usar o conjunto de configurações, o Amazon SES encaminhará automaticamente notificações de devolução e reclamação para o Return-Path ou para o endereço de origem que resultaram no evento de devolução ou reclamação.
+ Se você configurar o Amazon SES para enviar eventos de devolução e reclamação usando mais de um método (por exemplo, enviando notificações por e-mail e usando eventos de envio), você poderá receber mais de uma notificação para o mesmo evento.
# Recebimento de notificações do Amazon SES por e-mail
O Amazon SES pode enviar e-mail quando você recebe devoluções e reclamações usando um processo chamado *encaminhamento de comentários de e-mail*.
Para enviar e-mails usando o Amazon SES, você deve configurá-lo para enviar notificações de devolução e reclamação usando um dos seguintes métodos:
+ Habilitando o encaminhamento de comentários de e-mail. O procedimento para configurar esse tipo de notificação está incluído nesta seção.
+ Enviando notificações a um tópico do Amazon SNS. Para obter mais informações, consulte [Recebimento de notificações do Amazon SES usando o Amazon SNS](monitor-sending-activity-using-notifications-sns.md).
+ Publicando notificações de eventos. Para obter mais informações, consulte [Monitorar o envio de e-mails usando a publicação de eventos do Amazon SES](monitor-using-event-publishing.md).
**Importante**
Para vários pontos importantes sobre notificações, consulte [Configuração de notificações de eventos para o Amazon SES](monitor-sending-activity-using-notifications.md).
**Topics**
+ [
## Habilitar o encaminhamento de feedback de e-mail
](#monitor-sending-activity-using-notifications-email-enabling)
+ [
## Desabilitar o encaminhamento de feedback de e-mail
](#monitor-sending-activity-using-notifications-email-disabling)
+ [
## Destino do encaminhamento de feedback de e-mails
](#monitor-sending-activity-using-notifications-email-destination)
## Habilitar o encaminhamento de feedback de e-mail
O encaminhamento de feedback de e-mail está habilitado por padrão. Se você o tiver desabilitado anteriormente, poderá habilitá-lo seguindo os procedimentos nesta seção.
**Para habilitar o encaminhamento de devoluções e reclamações por e-mail usando o console do Amazon SES**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. No painel de navegação, em **Configuração**, escolha **Identidades verificadas**.
1. Na lista de endereços de e-mail ou domínios verificados, escolha o endereço de e-mail ou o domínio para o qual você deseja configurar notificações de devolução e de reclamação.
1. No painel de detalhes, expanda a seção **Notifications**.
1. Escolha **Edit Configuration**.
1. Em **Email Feedback Forwarding**, escolha **Enabled**.
**nota**
As alterações feitas nesta página podem demorar alguns minutos para entrar em vigor.
Você também pode ativar as notificações de devolução e reclamação por e-mail usando a operação da [ SetIdentityFeedbackForwardingEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityFeedbackForwardingEnabled.html)API.
## Desabilitar o encaminhamento de feedback de e-mail
Se você configurar um método diferente para fornecer notificações de devolução e de reclamação, você poderá desabilitar o encaminhamento de comentários de e-mail para não receber várias notificações quando ocorre um evento de devolução ou de reclamação.
**Para desabilitar o encaminhamento de devoluções e reclamações por e-mail usando o console do Amazon SES**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. No painel de navegação, em **Configuração**, escolha **Identidades verificadas**.
1. Na lista de endereços de e-mail ou domínios verificados, escolha o endereço de e-mail ou o domínio para o qual você deseja configurar notificações de devolução e de reclamação.
1. No painel de detalhes, expanda a seção **Notifications**.
1. Escolha **Edit Configuration**.
1. Em **Email Feedback Forwarding**, escolha **Disabled**.
**nota**
Você deve configurar um método para receber notificações de devolução e reclamação para enviar e-mail por meio do Amazon SES. Se você desabilitar o encaminhamento de comentários de e-mail, deve habilitar as notificações enviadas pelo Amazon SNS ou publicar eventos de devolução e reclamação em um tópico do Amazon SNS ou em um fluxo do Firehose usando [publicação de eventos](monitor-using-event-publishing.md). Se usar a publicação de eventos, você também deverá aplicar o conjunto de configurações que contém a regra de publicação de eventos para cada e-mail que envia. Se você não configurar um método para receber notificações de devolução e reclamação, o Amazon SES encaminhará automaticamente as notificações de comentários por e-mail para o endereço no campo Return-Path (Caminho de devolução) (ou para o campo Source (Origem), se você não especificar um endereço de Return-Path) da mensagem que resultou no evento de devolução ou reclamação. Nessa situação, o Amazon SES encaminha as notificações de devolução e reclamação, mesmo que você tenha desabilitado as notificações de feedback de e-mail.
1. Para salvar sua configuração de notificação, escolha **Save Config (Salvar configuração)**.
**nota**
As alterações feitas nessa página podem demorar alguns minutos para entrar em vigor.
Você também pode desativar as notificações de devolução e reclamação por e-mail usando a operação da [SetIdentityFeedbackForwardingEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityFeedbackForwardingEnabled.html)API.
## Destino do encaminhamento de feedback de e-mails
Quando você recebe notificações por e-mail, o Amazon SES reescreve o cabeçalho `From` e envia a notificação para você. O endereço para o qual o Amazon SES encaminha a notificação depende de como você enviou a mensagem original.
Se você usou a interface SMTP para enviar a mensagem, as notificações são entregues de acordo com as seguintes regras:
+ Se você especificou um cabeçalho `Return-Path` na seção `SMTP DATA`, as notificações são enviadas para esse endereço.
+ Do contrário, as notificações são enviadas ao endereço que você especificou ao emitir o comando MAIL FROM.
Se você usou a operação de API `SendEmail` para enviar a mensagem, as notificações são entregues de acordo com as seguintes regras:
+ Se você especificou o parâmetro opcional `ReturnPath` na chamada para a API `SendEmail`, as notificações são enviadas para esse endereço.
+ Caso contrário, as notificações são enviadas para o endereço especificado no parâmetro obrigatório `Source` de `SendEmail`.
Se você usou a operação de API `SendRawEmail` para enviar a mensagem, as notificações são entregues de acordo com as seguintes regras:
+ Se você especificou um cabeçalho `Return-Path` na mensagem bruta, as notificações são enviadas para esse endereço.
+ Do contrário, se você especificou um parâmetro `Source` na chamada para a API `SendRawEmail`, as notificações são enviadas para esse endereço.
+ Caso contrário, as notificações são enviadas para o endereço do cabeçalho `From` da mensagem bruta.
**nota**
Ao especificar um endereço `Return-Path` em um e-mail, você recebe notificações nesse endereço. No entanto, a versão da mensagem que o destinatário recebe contém um cabeçalho `Return-Path` que inclui um endereço de e-mail anonimizado (como *a0b1c2d3e4f5a6b7-c8d9e0f1-a2b3-c4d5-e6f7-a8b9c0d1e2f3-000000@amazonses.com*). Essa anonimização acontece independentemente de como o e-mail foi enviado.
# Recebimento de notificações do Amazon SES usando o Amazon SNS
Você pode configurar o Amazon SES para notificar um tópico do Amazon SNS quando você receber devoluções ou reclamações, ou quando os e-mails forem entregues. As notificações do Amazon SNS estão no formato [JavaScript Object Notation (JSON)](http://www.json.org), o que permite processá-las programaticamente.
Para enviar e-mails usando o Amazon SES, você deve configurá-lo para enviar notificações de devolução e reclamação usando um dos seguintes métodos:
+ Enviando notificações a um tópico do Amazon SNS. O procedimento para configurar esse tipo de notificação está incluído nesta seção.
+ Habilitando o encaminhamento de comentários de e-mail. Para obter mais informações, consulte [Recebimento de notificações do Amazon SES por e-mail](monitor-sending-activity-using-notifications-email.md).
+ Publicando notificações de eventos. Para obter mais informações, consulte [Monitorar o envio de e-mails usando a publicação de eventos do Amazon SES](monitor-using-event-publishing.md).
**Importante**
Consulte [Configuração de notificações de eventos para o Amazon SES](monitor-sending-activity-using-notifications.md) para obter informações importantes sobre notificações.
**Topics**
+ [
# Configuração de notificações do Amazon SNS para o Amazon SES
](configure-sns-notifications.md)
+ [
# Conteúdo das notificações do Amazon SNS para o Amazon SES
](notification-contents.md)
+ [
# Exemplos de notificação do Amazon SNS para o Amazon SES
](notification-examples.md)
# Configuração de notificações do Amazon SNS para o Amazon SES
O Amazon SES pode notificar você sobre devoluções, reclamações e entregas por meio do [Amazon Simple Notification Service (Amazon SNS)](https://aws.amazon.com/sns).
Você pode configurar notificações no console do Amazon SES ou usando a API do Amazon SES.
**Topics**
+ [
## Pré-requisitos
](#configure-feedback-notifications-prerequisites)
+ [
## Configuração de notificações usando o console do Amazon SES
](#configure-feedback-notifications-console)
+ [
## Configuração de notificações usando a API do Amazon SES
](#configure-feedback-notifications-api)
+ [
## Solução de problemas com notificações de feedback
](#configure-feedback-notifications-troubleshooting)
## Pré-requisitos
Conclua as etapas a seguir antes de configurar notificações do Amazon SNS no Amazon SES:
1. Crie um tópico do Amazon SNS. Para obter mais informações, consulte [Criar um tópico](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.
**Importante**
Quando você criar seu tópico usando o Amazon SNS, em **Type (Tipo)**, escolha apenas **Standard** (Padrão). (O SES não suporta tópicos do tipo FIFO.)
Independentemente de criar um novo tópico do SNS ou selecionar um existente, será necessário conceder acesso ao SES para publicar notificações no tópico.
Para conceder permissão ao Amazon SES para publicar notificações no tópico, na tela **Edit topic (Editar tópico)** no console do SNS, expanda **Access policy (Política de acesso)** e, em **JSON editor (Editor de JSON)**, adicione a seguinte política de permissão:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "notification-policy",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:topic_name",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:identity/identity_name"
}
}
}
]
}
```
------
Faça as seguintes alterações no exemplo de política anterior:
+ *topic\$1region*Substitua pela AWS região em que você criou o tópico do SNS.
+ Substitua *111122223333* pelo ID de sua conta da AWS .
+ *topic\$1name*Substitua pelo nome do seu tópico do SNS.
+ *identity\$1name*Substitua pela identidade verificada (endereço de e-mail ou domínio) que você está assinando no tópico do SNS.
1. Inscreva pelo menos um endpoint para o tópico. Por exemplo, se quiser receber notificações por mensagem de texto, assine um endpoint de SMS, (ou seja, um número de telefone celular) para o tópico. Para receber notificações por e-mail, inscreva um endpoint de e-mail (um endereço de e-mail) para o tópico.
Para obter mais informações, consulte [Conceitos básicos](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.
1. (Opcional) Se o tópico do Amazon SNS usa AWS Key Management Service (AWS KMS) para criptografia do lado do servidor, você precisa adicionar permissões à política de chaves. AWS KMS Você pode adicionar permissões anexando a seguinte política à política de AWS KMS chaves:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowSESToUseKMSKey",
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
## Configuração de notificações usando o console do Amazon SES
**Para configurar notificações usando o console do Amazon SES**
1. Abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. No painel de navegação, em **Configuração**, selecione **Identidades verificadas**.
1. No contêiner **Identities** (Identidades), selecione a identidade verificada para a qual você deseja receber notificações de feedback quando uma mensagem enviada dessa identidade resultar em devolução, reclamação ou entrega.
**Importante**
As configurações de notificação de domínio verificado aplicam-se a todos os e-mails enviados nesse domínio, *exceto* para endereços de e-mail que estão também verificados.
1. Na tela de detalhes da identidade verificada selecionada, escolha a guia **Notifications** (Notificações) e selecione **Edit** (Editar) no contêiner **Feedback notifications** (Notificações de feedback).
1. Expanda a caixa de listagem de tópicos do SNS de cada tipo de feedback para o qual deseja receber notificações e selecione um tópico do SNS que você possui, **No SNS topic** (Nenhum tópico do SNS) ou**SNS topic you don’t own** (Tópico do SNS que você não possui).
1. Ao escolher **SNS topic you don’t own** (Tópico do SNS que você não possui), o campo **SNS topic ARN** (ARN do tópico do SNS) será apresentado, onde deverá ser inserido o tópico do SNS que o ARN compartilhou com você pelo remetente delegado. (Somente o remetente delegado receberá essas notificações, pois ele possui o tópico do SNS. Para saber mais sobre envios delegados, consulte [Visão geral da autorização de envio](sending-authorization-overview.md).)
**Importante**
Os tópicos do Amazon SNS que você usa para notificações de devolução, reclamação e entrega devem ser os mesmos em Região da AWS que você usa o Amazon SES.
Além disso, é necessário inscrever um ou mais endpoints no tópico para receber notificações. Por exemplo, se você deseja que as notificações sejam enviadas para um endereço de e-mail, é necessário inscrever um endpoint de e-mail no tópico. Para obter mais informações, consulte [Conceitos básicos](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.
1. (Opcional) Se você quiser que a notificação de tópico inclua os cabeçalhos do e-mail original, marque a caixa **Include original email headers** (Incluir cabeçalhos de e-mail originais) diretamente abaixo do nome do tópico do SNS de cada tipo de feedback. Essa opção só está disponível se você atribuiu um tópico do Amazon SNS ao tipo de notificação associado. Para obter informações sobre o conteúdo dos cabeçalhos de e-mail originais, consulte o objeto `mail` em [Conteúdo das notificações](notification-contents.md).
1. Escolha **Salvar alterações**. As alterações feitas em suas configurações de notificação podem levar alguns minutos para ter efeito.
1. (Opcional) Se você escolher notificações de tópicos do Amazon SNS para devoluções e reclamações, poderá desabilitar as notificações de e-mail completamente para não receber notificações duplas por e-mail e notificações do SNS. Para desabilitar notificações de e-mail para devoluções e reclamações, na guia **Notifications** (Notificações), na tela de detalhes da identidade verificada, no contêiner **Email Feedback Forwarding** (Encaminhamento de feedback de e-mail), escolha **Edit** (Editar), desmarque a caixa **Enabled** (Habilitado) e escolha **Save changes** (Salvar as alterações).
Após definir as configurações, você começará a receber notificações de devolução, reclamação e/ou entrega para seus tópicos do Amazon SNS. Essas notificações estão no formato JavaScript Object Notation (JSON) e seguem a estrutura descrita em. [Conteúdo das notificações](notification-contents.md)
Você será cobrado de acordo com as taxas padrão do Amazon SNS para notificações de devolução, reclamação e entrega. Para obter mais informações, consulte a página de [Definição de preços do Amazon SNS](https://aws.amazon.com/sns/pricing).
**nota**
Se uma tentativa de publicar no seu tópico do Amazon SNS falhar porque o tópico foi excluído ou você Conta da AWS não tem mais permissões para publicar nele, o Amazon SES removerá a configuração desse tópico se ele tiver sido configurado para devoluções ou reclamações (não entregas - para notificações de entrega, o SES não excluirá a configuração do tópico do SNS). Além disso, o Amazon SES habilitará novamente as notificações por e-mail de devolução e reclamação para a identidade, e você receberá uma notificação da alteração por e-mail. Se várias identidades forem configuradas para usar o tópico, a configuração do tópico para cada identidade será alterada quando cada identidade apresentar uma falha ao publicar no tópico.
## Configuração de notificações usando a API do Amazon SES
Você também pode configurar notificações de devolução, reclamação e entrega usando a API do Amazon SES. Para configurar notificações, use as operações a seguir:
+ [SetIdentityNotificationTopic](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityNotificationTopic.html)
+ [SetIdentityFeedbackForwardingEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityFeedbackForwardingEnabled.html)
+ [GetIdentityNotificationAttributes](https://docs.aws.amazon.com/ses/latest/APIReference/API_GetIdentityNotificationAttributes.html)
+ [SetIdentityHeadersInNotificationsEnabled](https://docs.aws.amazon.com/ses/latest/APIReference/API_SetIdentityHeadersInNotificationsEnabled.html)
Você pode usar essas ações de API para escrever um aplicativo front-end personalizado para notificações. Para obter uma descrição completa das ações de API relacionadas à verificação de domínio, consulte a [Referência da API do Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/).
## Solução de problemas com notificações de feedback
**Notificações não estão sendo recebidas**
Se você não estiver recebendo notificações, certifique-se de ter inscrito um endpoint no tópico pelo qual as notificações são enviadas. Ao enviar um endpoint de e-mail em um tópico, você recebe um e-mail solicitando a confirmação da inscrição. É necessário confirmar a inscrição antes de começar a receber notificações por e-mail. Para obter mais informações, consulte [Conceitos básicos](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.
**Erro `InvalidParameterValue` ao escolher um tópico**
Se você receber uma mensagem de erro informando que ocorreu um erro `InvalidParameterValue`, verifique se o tópico do Amazon SNS está criptografado usando AWS KMS. Se estiver, você precisará modificar a política da AWS KMS chave. Consulte [Pré-requisitos](#configure-feedback-notifications-prerequisites) para obter um exemplo de política.
# Conteúdo das notificações do Amazon SNS para o Amazon SES
As notificações de devolução, reclamação e entrega são publicadas nos tópicos do [Amazon Simple Notification Service (Amazon SNS) no formato JavaScript Object Notation (JSON)](https://aws.amazon.com/sns). O objeto JSON de nível superior contém uma string `notificationType`, um objeto `mail` e um objeto `bounce`, um objeto `complaint` ou um objeto `delivery`.
Consulte as seções a seguir para obter descrições dos diferentes tipos de objetos:
+ [Objeto JSON de nível superior](#top-level-json-object)
+ [Objeto `mail`](#mail-object)
+ [Objeto `bounce`](#bounce-object)
+ [Objeto `complaint`](#complaint-object)
+ [Objeto `delivery`](#delivery-object)
A seguir estão algumas importantes observações sobre o conteúdo das notificações do Amazon SNS para o Amazon SES:
+ Para determinado tipo de notificação, você pode receber uma notificação do Amazon SNS para vários destinatários ou receber uma única notificação do Amazon SNS por destinatário. Seu código deve ser capaz de analisar a notificação do Amazon SNS e lidar com ambos os casos. O SES não oferece garantias de ordenação ou colocação em lotes para notificações enviadas por meio do Amazon SNS. No entanto, diferentes tipos de notificação do Amazon SNS (por exemplo, devoluções e reclamações) nunca são reunidos em uma única notificação.
+ Você pode receber vários tipos de notificações do Amazon SNS para um só destinatário. Por exemplo, o servidor de e-mail de recebimento pode aceitar o e-mail (acionando uma notificação de entrega), mas depois de processar o e-mail, acabar determinando que o e-mail, na verdade, resulta em uma devolução (acionando uma notificação de devolução). Mas essas notificações sempre são notificações separadas porque são tipos distintos de notificação.
+ O SES se reserva o direito de adicionar mais campos às notificações. Dessa forma, aplicações que analisam essas notificações devem ser flexíveis o suficiente para lidar com campos desconhecidos.
+ O SES sobrescreve os cabeçalhos da mensagem ao enviar o e-mail. Você pode recuperar os cabeçalhos da mensagem original dos campos `headers` e `commonHeaders` do objeto `mail`.
## Objeto JSON de nível superior
O objeto JSON de nível superior em uma notificação do SES contém os campos a seguir.
| Nome do campo | Description |
| --- | --- |
| notificationType | Uma string que contém o tipo de notificação representado pelo objeto JSON. Os valores são `Bounce`, `Complaint` ou `Delivery`. Se você [configurou a publicação de eventos](monitor-sending-using-event-publishing-setup.md), este campo é chamado de `eventType`. |
| mail | Um objeto JSON que contém informações sobre o e-mail original ao qual a notificação pertence. Para obter mais informações, consulte [Objeto de e-mail](#mail-object). |
| bounce | Este campo estará presente somente se `notificationType` for `Bounce` e contiver um objeto JSON que contém informações sobre a devolução. Para obter mais informações, consulte [Objeto de devolução](#bounce-object). |
| complaint | Este campo estará presente somente se `notificationType` for `Complaint` e contiver um objeto JSON que contém informações sobre a reclamação. Para obter mais informações, consulte [Objeto de reclamação](#complaint-object). |
| delivery | Este campo estará presente somente se `notificationType` for `Delivery` e contiver um objeto JSON que contém informações sobre a entrega. Para obter mais informações, consulte [Objeto de entrega](#delivery-object). |
## Objeto de e-mail
Cada notificação de devolução, reclamação ou entrega 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 hora em que a mensagem original foi enviada (em ISO8601 formato). |
| messageId | Um ID exclusivo que o SES atribuiu à mensagem. O SES retornou esse valor quando você enviou a mensagem. Esse ID de mensagem foi atribuído pelo SES. Você pode encontrar o ID da mensagem do e-mail original no campo `headers` do objeto `mail`. |
| source | O endereço de e-mail do qual a mensagem original 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). |
| sourceIp | O endereço IP público de origem do cliente que realizou a solicitação de envio de e-mail ao SES. |
| sendingAccountId | O Conta da 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. |
| callerIdentity | A identidade do IAM do usuário do SES que enviou o e-mail. |
| destination | Uma lista de endereços de e-mail que foram destinatários da mensagem original. |
| headersTruncated | Esse objeto só está presente se você definiu as configurações de notificação para incluir os cabeçalhos de e-mail originais. Indica se os cabeçalhos estão truncados na notificação. O SES trunca os cabeçalhos na notificação quando os cabeçalhos da mensagem original têm 10 KB ou mais. Os possíveis valores são `true` e `false`. |
| headers | Esse objeto só está presente se você definiu as configurações de notificação para incluir os cabeçalhos de e-mail originais. 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 objeto `headers` é da mensagem original que você enviou ao SES. O ID de mensagem que o SES subsequentemente atribuiu à mensagem está no campo `messageId` do objeto `mail`. |
| commonHeaders | Esse objeto só está presente se você definiu as configurações de notificação para incluir os cabeçalhos de e-mail originais. Inclui informações sobre cabeçalhos de e-mail comuns do e-mail original, incluindo os campos From (De), To (Para) e Subject (Assunto). Dentro desse objeto, cada cabeçalho é uma chave. Os campos From (De) e To (Para) são representados por matrizes que podem conter vários valores. Para eventos, qualquer ID de mensagem no campo `commonHeaders` é o ID da mensagem que o Amazon SES atribuiu subsequentemente à mensagem no campo `messageId` do objeto de e-mail. As notificações conterão o ID da mensagem do e-mail original. |
Veja a seguir um exemplo de um objeto `mail` que inclui os cabeçalhos de e-mail originais. Quando esse tipo de notificação não estiver configurado para incluir cabeçalhos de e-mail originais, o objeto `mail` não incluirá os campos `headersTruncated`, `headers` e `commonHeaders`.
```
{
"timestamp":"2018-10-08T14:05:45 +0000",
"messageId":"000001378603177f-7a5433e7-8edb-42ae-af10-f0181f34d6ee-000000",
"source":"sender@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"destination":[
"recipient@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"Sender Name\" "
},
{
"name":"To",
"value":"\"Recipient Name\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Mon, 08 Oct 2018 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"Sender Name "
],
"date":"Mon, 08 Oct 2018 14:05:45 +0000",
"to":[
"Recipient Name "
],
"messageId":" custom-message-ID",
"subject":"Message sent using SES"
}
}
```
## Objeto de devolução
O objeto JSON que contém informações sobre devoluções contém os campos a seguir.
| Nome do campo | Description |
| --- | --- |
| bounceType | O tipo de falha de entrega, conforme determinado pelo SES. Para obter mais informações, consulte [Tipos de devolução](#bounce-types). |
| bounceSubType | O subtipo da falha de entrega, conforme determinado pelo SES. Para obter mais informações, consulte [Tipos de devolução](#bounce-types). |
| bouncedRecipients | Uma lista que contém informações sobre os destinatários da mensagem original que foi devolvida. Para obter mais informações, consulte [Destinatários com mensagens devolvidas](#bounced-recipients). |
| timestamp | A data e a hora em que a devolução foi enviada (em ISO8601 formato). Observe que essa é a hora em que a notificação foi enviada pelo ISP, não a hora em que foi recebida pelo SES. |
| feedbackId | Um ID exclusivo para a devolução. |
Se o SES conseguir entrar em contato com o agente de transferência de mensagens (MTA), o campo a seguir também estará presente.
| Nome do campo | Description |
| --- | --- |
| remoteMtaIp | O endereço IP do MTA para o qual o SES tentou entregar o e-mail. |
Se uma notificação do status de entrega (DSN) tiver sido anexada à devolução, o campo a seguir também estará presente.
| Nome do campo | Description |
| --- | --- |
| reportingMTA | O valor do campo `Reporting-MTA` a partir do DSN. Esse é o valor da MTA que tentou executar a operação de entrega, transmissão ou gateway descritas no DSN. |
Veja a seguir um exemplo de um objeto `bounce`.
```
{
"bounceType":"Permanent",
"bounceSubType": "General",
"bouncedRecipients":[
{
"status":"5.0.0",
"action":"failed",
"diagnosticCode":"smtp; 550 user unknown",
"emailAddress":"recipient1@example.com"
},
{
"status":"4.0.0",
"action":"delayed",
"emailAddress":"recipient2@example.com"
}
],
"reportingMTA": "example.com",
"timestamp":"2012-05-25T14:59:38.605Z",
"feedbackId":"000001378603176d-5a4b5ad9-6f30-4198-a8c3-b1eb0c270a1d-000000",
"remoteMtaIp":"127.0.2.0"
}
```
### Destinatários com mensagens devolvidas
Uma notificação 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 para cada destinatário ao qual a notificação de devolução pertence – e sempre conterá o campo a seguir.
| 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). |
Veja a seguir um exemplo de um objeto que pode estar na lista `bouncedRecipients`.
```
{
"emailAddress": "recipient@example.com",
"action": "failed",
"status": "5.0.0",
"diagnosticCode": "X-Postfix; unknown user"
}
```
### Tipos de devolução
O objeto de falha de entrega contém um tipo de falha de entrega `Undetermined`, `Permanent` *(permanente)* ou `Transient` *(temporária)*. Os tipos de falha de entrega `Permanent` *(permanente)* e `Transient` *(temporária)* também podem conter um dos vários subtipos de falha de entrega.
Ao receber uma notificação de falha de entrega com um tipo de falha de entrega `Transient` *(temporária)*, você poderá enviar e-mails para esse destinatário no futuro se o problema que gerava a mensagem de falha de entrega for resolvido.
Quando você recebe uma notificação de falha de entrega com um tipo de falha de entrega `Permanent` *(permanente)*, é improvável que possa enviar e-mails para esse destinatário no futuro. Por esse motivo, você deve remover imediatamente de sua listas de endereços o destinatário cujo endereço gerou a devolução.
**nota**
Quando ocorre uma *falha de entrega temporária* (uma falha de entrega relacionada a um problema temporário, como quando a caixa de entrada do destinatário está cheia), o SES tenta enviar o e-mail durante um período específico. Ao final desse período, se o SES ainda assim não conseguir entregar o e-mail, deixará de tentar.
O SES fornece notificações para falhas de entrega permanentes, bem como para falhas de entrega temporárias que parou de tentar entregar. Se quiser receber uma notificação sempre que ocorrer uma devolução flexível, [habilite a publicação de eventos](monitor-sending-using-event-publishing-setup.md) e configure-a para enviar notificações quando ocorrerem eventos de atraso de entrega.
| bounceType | bounceSubType | Description |
| --- | --- | --- |
| Undetermined | Undetermined | O provedor de e-mail do destinatário enviou uma mensagem de devolução. A mensagem de falha de entrega não contém informações suficientes para o SES determinar o motivo da falha. O e-mail de devolução, que foi enviado ao endereço no cabeçalho Return-Path do e-mail que provocou a devolução, pode conter informações adicionais sobre o problema que fez o e-mail ser devolvido. |
| Permanent | General | O provedor de e-mail do destinatário enviou uma mensagem de devolução definitiva. Quando você recebe esse tipo de notificação de devolução, deve remover imediatamente o endereço de e-mail do destinatário de sua lista de endereços. O envio de mensagens para endereços que geram devoluções definitivas pode afetar negativamente sua reputação como remetente. Se continuar a enviar e-mails para endereços que geram devoluções definitivas, provavelmente teremos de pausar o envio de e-mails subsequentes. Consulte [Como usar a lista de supressão do Amazon SES por conta](sending-email-suppression-list.md). |
| Permanent | NoEmail | Não foi possível recuperar o endereço de e-mail do destinatário da mensagem de devolução. |
| Permanent | Suppressed | O endereço de e-mail do destinatário está na lista de supressão do SES porque tem um histórico recente de gerar falhas de entrega permanentes. 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 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 | UnsubscribedRecipient | Esse tipo de falha de entrega ocorre quando o contato do destinatário cancelou a assinatura do tópico e um e-mail é enviado a ele usando as [opções de gerenciamento de listas](sending-email-list-management.md#configuring-list-management-list-contacts). O SES respeita a preferência de contato e não tenta realizar a entrega. Além disso, essa falha de entrega não afeta a reputação do remetente, já que a entrega não foi tentada, e o contato do destinatário também não é adicionado a uma lista de supressão devido à falha. É recomendável que você se inscreva em UnsubscribedRecipient eventos para evitar o envio contínuo para destinatários não inscritos. Considere [Uso do gerenciamento de listas](sending-email-list-management.md). O gerenciamento de listas deve ser a fonte da verdade para a sua lista de assinantes. Do ponto de vista da imposição do SES, se você continuar enviando para destinatários suprimidos ou não inscritos, terá a reputação de não seguir as práticas recomendadas de envio de e-mails. |
| Transient | General | O provedor de e-mail do destinatário enviou uma mensagem de devolução genérica. Você pode enviar uma mensagem para o mesmo destinatário no futuro se o problema que gerou a mensagem de devolução for resolvido. Se enviar um e-mail para um destinatário que tem uma regra de resposta automática (como uma mensagem "fora do escritório"), você poderá receber esse tipo de notificação. Mesmo que a resposta tenha um tipo de notificação `Bounce`, o SES não contabilizará respostas automáticas ao calcular a taxa de falha de entrega para a sua conta. |
| Transient | MailboxFull | O provedor de e-mail do destinatário enviou uma mensagem de devolução porque a caixa de entrada do destinatário está cheia. Você poderá enviar mensagens para esse mesmo destinatário no futuro quando a caixa postal não estiver mais cheia. |
| Transient | MessageTooLarge | O provedor de e-mail do destinatário enviou uma mensagem de devolução porque a mensagem que você enviou era muito grande. Você poderá enviar uma mensagem a esse mesmo destinatário se diminuir o tamanho da mensagem. |
| Transient | ContentRejected | O provedor de e-mail do destinatário enviou uma mensagem de devolução porque o conteúdo da mensagem que você enviou não é permitido pelo provedor. Você poderá enviar uma mensagem para esse mesmo destinatário se alterar o conteúdo da mensagem. |
| Transient | AttachmentRejected | O provedor de e-mail do destinatário enviou uma mensagem de devolução porque a mensagem continha um anexo inaceitável. Por exemplo, alguns provedores de e-mail podem rejeitar mensagens com anexos de determinado tipo de arquivo ou mensagens com anexos muito grandes. Você poderá enviar uma mensagem para esse mesmo destinatário se remover ou alterar o conteúdo da mensagem. |
## Objeto de reclamação
O objeto JSON que contém informações sobre reclamações tem os campos a seguir.
| Nome do campo | Description |
| --- | --- |
| complainedRecipients | Uma lista que contém informações sobre os destinatários que podem ter sido responsáveis pela reclamação. Para obter mais informações, consulte [Destinatários que reclamaram](#complained-recipients). |
| timestamp | A data e a hora, no formato ISO 8601, em que o ISP enviou a notificação de reclamação. A data e hora nesse campo podem não ser iguais à data e hora em que o SES recebeu a notificação. |
| feedbackId | Um ID exclusivo associado à reclamação. |
| complaintSubType | O valor do campo `complaintSubType` pode ser nulo ou `OnAccountSuppressionList`. Se o valor é `OnAccountSuppressionList`, o SES aceitou a mensagem, mas não tentou enviá-la porque ela estava na [lista de supressão no nível da conta](sending-email-suppression-list.md). |
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). Esse campo pode estar ausente no relatório (e, portanto, também ausente no JSON). |
Veja a seguir um exemplo de um objeto `complaint`.
```
{
"userAgent":"ExampleCorp Feedback Loop (V0.01)",
"complainedRecipients":[
{
"emailAddress":"recipient1@example.com"
}
],
"complaintFeedbackType":"abuse",
"arrivalDate":"2009-12-03T04:24:21.000-05:00",
"timestamp":"2012-05-25T14:59:38.623Z",
"feedbackId":"000001378603177f-18c07c78-fa81-4a58-9dd1-fedc3cb8f49a-000000"
}
```
### Destinatários que reclamaram
O campo `complainedRecipients` contém uma lista de destinatários que podem ter enviado a reclamação. Você deve usar essas informações para determinar qual destinatário enviou a reclamação, depois remover esse destinatário imediatamente de suas listas de endereços.
**Importante**
A maioria ISPs remove o endereço de e-mail do destinatário que enviou a reclamação da notificação de reclamação. Por esse motivo, 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 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. |
Veja a seguir um exemplo de um objeto de uma reclamação do destinatário.
```
{ "emailAddress": "recipient1@example.com" }
```
**nota**
Por conta desse comportamento, você pode ter mais certeza quais endereços de e-mail reclamaram sobre sua mensagem se limitar seu envio para uma mensagem por destinatário (em vez de enviar uma mensagem com 30 diferentes endereços de e-mail na linha CCO).
#### 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](http://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2):
+ `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 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 entregas sempre tem os campos a seguir.
| Nome do campo | Description |
| --- | --- |
| timestamp | A hora em que o SES entregou o e-mail ao servidor de e-mail do destinatário (em ISO8601 formato). |
| processingTimeMillis | O tempo, em milissegundos, entre o momento em que SES aceitou a solicitação do remetente até transmitir a mensagem para o servidor de e-mail do destinatário. |
| recipients | Uma lista dos destinatários pretendidos do e-mail ao qual a notificação de entrega se aplica. |
| smtpResponse | A mensagem de resposta SMTP do ISP remoto que aceitou o e-mail do SES. Essa mensagem varia de acordo com o e-mail, o servidor de e-mail de recebimento e o ISP de recebimento. |
| reportingMTA | O nome de host do servidor de e-mail do SES que enviou o e-mail. |
| remoteMtaIp | O endereço IP do MTA para o qual o SES entregou o e-mail. |
Veja a seguir um exemplo de um objeto `delivery`.
```
{
"timestamp":"2014-05-28T22:41:01.184Z",
"processingTimeMillis":546,
"recipients":["success@simulator.amazonses.com"],
"smtpResponse":"250 ok: Message 64111812 accepted",
"reportingMTA":"a8-70.smtp-out.amazonses.com",
"remoteMtaIp":"127.0.2.0"
}
```
# Exemplos de notificação do Amazon SNS para o Amazon SES
As seções a seguir oferecem exemplos de três tipos de notificações:
+ Para exemplos de notificação de devolução, consulte [Exemplos de notificação de devolução do Amazon SNS](#notification-examples-bounce).
+ Para exemplos de notificação de reclamação, consulte [Exemplos de notificação de reclamação do Amazon SNS](#notification-examples-complaint).
+ Para exemplos de notificação de entrega, consulte [Exemplo de notificação de entrega do Amazon SNS](#notification-examples-delivery).
## Exemplos de notificação de devolução do Amazon SNS
Esta seção contém exemplos de notificações de devolução com e sem uma notificação de status de entrega (DSN) fornecida pelo receptor do e-mail que enviou o feedback.
### Notificação de devolução com um DSN
A seguir está um exemplo de uma notificação de devolução que contém um DSN e os cabeçalhos de e-mail originais. Quando as notificações de devolução não estiverem configuradas para incluir os cabeçalhos de e-mail originais, o objeto `mail` dentro da notificação não incluirá os campos `headersTruncated`, `headers` e `commonHeaders`.
```
{
"notificationType":"Bounce",
"bounce":{
"bounceType":"Permanent",
"reportingMTA":"dns; email.example.com",
"bouncedRecipients":[
{
"emailAddress":"jane@example.com",
"status":"5.1.1",
"action":"failed",
"diagnosticCode":"smtp; 550 5.1.1 ... User"
}
],
"bounceSubType":"General",
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"00000138111222aa-33322211-cccc-cccc-cccc-ddddaaaa068a-000000",
"remoteMtaIp":"127.0.2.0"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"messageId":"00000138111222aa-33322211-cccc-cccc-cccc-ddddaaaa0680-000000",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
### Notificação de devolução sem um DSN
Veja a seguir um exemplo de uma notificação de devolução que inclui cabeçalhos de e-mail originais, mas não um DSN. Quando as notificações de devolução não estiverem configuradas para incluir os cabeçalhos de e-mail originais, o objeto `mail` dentro da notificação não incluirá os campos `headersTruncated`, `headers` e `commonHeaders`.
```
{
"notificationType":"Bounce",
"bounce":{
"bounceType":"Permanent",
"bounceSubType": "General",
"bouncedRecipients":[
{
"emailAddress":"jane@example.com"
},
{
"emailAddress":"richard@example.com"
}
],
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"00000137860315fd-869464a4-8680-4114-98d3-716fe35851f9-000000",
"remoteMtaIp":"127.0.2.0"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"00000137860315fd-34208509-5b74-41f3-95c5-22c1edc3c924-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
## Exemplos de notificação de reclamação do Amazon SNS
Esta seção contém exemplos de notificações de reclamação com e sem um relatório de feedback fornecido pelo receptor do e-mail que enviou o feedback.
### Notificação de reclamação com um relatório de feedback
A seguir está um exemplo de uma notificação de reclamação que contém um relatório de feedback e os cabeçalhos de e-mail originais. Quando as notificações de reclamação não estiverem configuradas para incluir os cabeçalhos de e-mail originais, o objeto `mail` dentro da notificação não incluirá os campos `headersTruncated`, `headers` e `commonHeaders`.
```
{
"notificationType":"Complaint",
"complaint":{
"userAgent":"AnyCompany Feedback Loop (V0.01)",
"complainedRecipients":[
{
"emailAddress":"richard@example.com"
}
],
"complaintFeedbackType":"abuse",
"arrivalDate":"2016-01-27T14:59:38.237Z",
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"000001378603177f-18c07c78-fa81-4a58-9dd1-fedc3cb8f49a-000000"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"000001378603177f-7a5433e7-8edb-42ae-af10-f0181f34d6ee-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
### Notificação de reclamação sem um relatório de feedback
Veja a seguir um exemplo de uma notificação de reclamação que inclui cabeçalhos de e-mail originais, mas não um relatório de feedback. Quando as notificações de reclamação não estiverem configuradas para incluir os cabeçalhos de e-mail originais, o objeto `mail` dentro da notificação não incluirá os campos `headersTruncated`, `headers` e `commonHeaders`.
```
{
"notificationType":"Complaint",
"complaint":{
"complainedRecipients":[
{
"emailAddress":"richard@example.com"
}
],
"timestamp":"2016-01-27T14:59:38.237Z",
"feedbackId":"0000013786031775-fea503bc-7497-49e1-881b-a0379bb037d3-000000"
},
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"0000013786031775-163e3910-53eb-4c8e-a04a-f29debf88a84-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com",
"mary@example.com",
"richard@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" , \"Mary Doe\" , \"Richard Doe\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Wed, 27 Jan 2016 14:05:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:05:45 +0000",
"to":[
"Jane Doe , Mary Doe , Richard Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
}
}
```
## Exemplo de notificação de entrega do Amazon SNS
Veja a seguir um exemplo de uma notificação de entrega que inclui os cabeçalhos de e-mail originais. Quando as notificações de entrega não estiverem configuradas para incluir os cabeçalhos de e-mail originais, o objeto `mail` dentro da notificação não incluirá os campos `headersTruncated`, `headers` e `commonHeaders`.
```
{
"notificationType":"Delivery",
"mail":{
"timestamp":"2016-01-27T14:59:38.237Z",
"messageId":"0000014644fe5ef6-9a483358-9170-4cb4-a269-f5dcdf415321-000000",
"source":"john@example.com",
"sourceArn": "arn:aws:ses:us-east-1:888888888888:identity/example.com",
"sourceIp": "127.0.3.0",
"sendingAccountId":"123456789012",
"callerIdentity": "IAM_user_or_role_name",
"destination":[
"jane@example.com"
],
"headersTruncated":false,
"headers":[
{
"name":"From",
"value":"\"John Doe\" "
},
{
"name":"To",
"value":"\"Jane Doe\" "
},
{
"name":"Message-ID",
"value":"custom-message-ID"
},
{
"name":"Subject",
"value":"Hello"
},
{
"name":"Content-Type",
"value":"text/plain; charset=\"UTF-8\""
},
{
"name":"Content-Transfer-Encoding",
"value":"base64"
},
{
"name":"Date",
"value":"Wed, 27 Jan 2016 14:58:45 +0000"
}
],
"commonHeaders":{
"from":[
"John Doe "
],
"date":"Wed, 27 Jan 2016 14:58:45 +0000",
"to":[
"Jane Doe "
],
"messageId":"custom-message-ID",
"subject":"Hello"
}
},
"delivery":{
"timestamp":"2016-01-27T14:59:38.237Z",
"recipients":["jane@example.com"],
"processingTimeMillis":546,
"reportingMTA":"a8-70.smtp-out.amazonses.com",
"smtpResponse":"250 ok: Message 64111812 accepted",
"remoteMtaIp":"127.0.2.0"
}
}
```