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á.
# Monitoramento da atividade de envio do Amazon SES
O Amazon SES fornece métodos de monitorar sua atividade de envio usando eventos, métricas e estatísticas. Um evento é algo que acontece relacionado à sua atividade de envio que você especificou para ser rastreada como uma métrica. Uma métrica representa um conjunto ordenado de pontos de dados que representam os valores de um tipo de evento monitorado que produz estatísticas. As estatísticas são conjuntos de dados de métrica por um período especificado, indo até o presente.
Esses métodos de monitoramento ajudam a manter o controle de medidas importantes, como as taxas de devolução, reclamação e rejeição da sua conta. Taxas de devolução e reclamação excessivamente altas podem prejudicar sua capacidade de enviar e-mails usando o SES. Esses métodos também podem ser usados para medir as taxas nas quais seus clientes se envolvem com os e-mails que você envia, ajudando você a identificar suas taxas gerais de abertura e cliques, utilizando a publicação de eventos e domínios personalizados associados a conjuntos de configurações. Consulte [Configurar domínios personalizados para lidar com rastreamento de abertura e clique](configure-custom-open-click-domains.md).
A primeira etapa na configuração do monitoramento é identificar os tipos de eventos de e-mail relacionados à sua atividade de envio que você deseja medir e monitorar usando SES. É possível escolher os seguintes tipos de eventos para monitorar no SES:
+ **Send** (Envio): a solicitação de envio foi bem-sucedida e o Amazon SES tentará entregar a mensagem ao servidor de e-mail do destinatário. (Se a supressão global ou no nível da conta estiver sendo usada, o SES ainda contará como um envio, mas a entrega está suprimida.)
+ **RenderingFailure**: o e-mail não foi enviado devido a um problema de renderização do modelo. Esse tipo de evento pode ocorrer quando estão faltando dados no modelo ou quando há uma incompatibilidade entre os parâmetros e os dados do modelo. (Esse tipo de evento só ocorre quando você envia e-mails usando as operações de API [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) ou [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html))
+ **Reject (Rejeição)**: o Amazon SES aceitou o e-mail, mas determinou que ele continha um vírus e não tentou entregá-lo ao servidor de e-mail do destinatário.
+ **Delivery** (Entrega): o Amazon SES entregou com êxito o e-mail ao servidor de e-mail do destinatário.
+ **Devolução**: uma *devolução definitiva* em que o servidor de e-mail do destinatário rejeitou permanentemente o e-mail. (As *falhas de entrega temporárias* só são incluídas quando o SES não tenta mais entregar o e-mail. Em geral, essas falhas de entrega temporárias indicam uma falha na entrega, embora em alguns casos uma falha de entrega temporária possa ser retornada mesmo quando o e-mail chega à caixa de entrada do destinatário com sucesso. Isso ocorre geralmente quando o destinatário envia uma resposta automática de ausência do escritório. Saiba mais sobre falhas de entrega temporárias neste [artigo do AWS re:POST](https://repost.aws/knowledge-center/ses-understand-soft-bounces).)
+ **Complaint** (Reclamação): o e-mail foi entregue com sucesso ao servidor de e-mail do destinatário, mas o destinatário marcou-o como spam.
+ **DeliveryDelay**: o e-mail não foi entregue ao servidor de e-mail do destinatário porque ocorreu um problema temporário. Atrasos de entrega podem ocorrer, por exemplo, quando a caixa de entrada do destinatário está cheia ou quando o servidor de recebimento de e-mail enfrenta um problema transitório.
+ **Subscription** (Assinatura): o e-mail foi entregue com êxito, mas o destinatário atualizou as preferências de assinatura clicando em `List-Unsubscribe` no cabeçalho do e-mail ou no link `Unsubscribe` no rodapé.
+ **Open** (Abertura): o destinatário recebeu a mensagem e a abriu em seu cliente de e-mail.
+ **Click** (Clique): o destinatário clicou em um ou mais links no e-mail.
Você pode monitorar eventos de envio de e-mail de várias maneiras. O método escolhido depende do tipo de evento que você deseja monitorar, da granularidade e do nível de detalhes com os quais deseja monitorá-lo e do local onde você deseja que o SES publique os dados. Você precisa usar notificações de comentários ou a publicação de eventos para rastrear eventos de devolução e de reclamação. Você também pode optar por usar vários métodos de monitoramento. As características de cada método são listadas na tabela a seguir.
| Método de monitoramento | Eventos que você pode monitorar | Como acessar os dados | Nível de detalhe | Granularity |
| --- | --- | --- | --- | --- |
| Console do SES | Integridade da conta, e-mails enviados, cota usada, solicitações de envio bem-sucedidas, rejeições, devoluções e reclamações *(histórico recente para a reputação atual)* | [Página Painel da conta](monitor-sending-activity-console.md) no console do SES | Número e porcentagem | Em toda a conta da AWS |
| Console do SES | Saúde da conta, e-mails enviados, devoluções e reclamações *(reputação atual)* | [Página Métricas de reputação](reputation-dashboard-dg.md) no console do SES | Somente para taxas calculadas | Em toda a conta da AWS |
| Virtual Deliverability Manager | Estatísticas de contas, ISP, identidades de envio, conjuntos de configurações, enviados, entregues, reclamações, devoluções transitórias e permanentes, aberturas e cliques, capacidade de entrega e reputação. | [Painel do Virtual Deliverability Manager](vdm-dashboard.md) no console do SES [Consultor do Virtual Deliverability Manager](vdm-advisor.md) no console do SES | Número e porcentagem | Em toda a conta da AWS |
| API do SES | Entregas, devoluções, reclamações e rejeições | [https://docs.aws.amazon.com/ses/latest/APIReference/API_GetSendStatistics.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_GetSendStatistics.html) Operação de API | Somente para contagem | Em toda a conta da AWS |
| Console do Amazon CloudWatch | Envios, entregas, aberturas, cliques, devoluções, taxa de devolução, reclamações, taxa de reclamação, rejeições, falhas de processamento e IPs colocados em listas de restrições. | Console do CloudWatch Algumas métricas não aparecem no CloudWatch até que o evento associado ocorra. Por exemplo, as métricas de devolução não aparecem no CloudWatch até que pelo menos um e-mail enviado seja devolvido ou até que seja gerado um evento de devolução simulado usando o [simulador de caixa postal](send-an-email-from-console.md). | Somente para contagem | Em toda a conta da AWS |
| Notificações de feedback | Entregas, devoluções e reclamações | Notificação do Amazon SNS (entregas, devoluções e reclamações) ou e-mail (devoluções e reclamações apenas). Consulte [Configuração de eventos e notificações](monitor-sending-activity-using-notifications.md). | Detalhes sobre cada evento | Em toda a conta da AWS |
| Publicação de evento | Envios, entregas, aberturas, cliques, devoluções, reclamações, rejeições e falhas de renderização. | Amazon CloudWatch ou Amazon Data Firehose ou por notificação do Amazon SNS, consulte [Monitorar o envio de e-mails usando a publicação de eventos](monitor-using-event-publishing.md). *(Sujeito a cobranças adicionais; consulte [Preço por métrica para o CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing).)* | Detalhes sobre cada evento | Minucioso (com base nas características de e-mail definidas pelo usuário) |
| Publicação de eventos utilizando domínios personalizados associados a conjuntos de configurações.[Mais informações](configure-custom-open-click-domains.md) | Abra e clique no rastreamento. | Amazon CloudWatch ou Amazon Data Firehose ou por notificação do Amazon SNS. *(Sujeito a cobranças adicionais; consulte [Preço por métrica para o CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing).)* | Detalhes sobre cada evento | Minucioso (com base nas características de e-mail definidas pelo usuário) |
**nota**
As métricas avaliadas por eventos de envio de e-mail podem não se alinhar perfeitamente com suas cotas de envio. Essa discrepância pode ser causada por devoluções e rejeições de e-mail ou por usar o simulador de caixa de entrada do SES. Para saber se você está próximo de atingir suas cotas de envio, consulte [Monitoramento de cotas de envio](manage-sending-quotas-monitor.md).
**Topics**
+ [Monitoramento de suas estatísticas de envio com o uso do console do Amazon SES](monitor-sending-activity-console.md)
+ [Monitoramento de suas estatísticas de uso usando a API do Amazon SES](monitor-sending-activity-api.md)
+ [Monitorar o envio de e-mails usando a publicação de eventos do Amazon SES](monitor-using-event-publishing.md)
# Monitoramento de suas estatísticas de envio com o uso do console do Amazon SES
Nas páginas **Painel da conta**, **Métricas de reputação** e **Configurações SMTP** do console do Amazon SES, é possível monitorar os seguintes dados de e-mail: envio, uso, estatísticas, configurações SMTP, integridade geral da conta e métricas de reputação. As seções a seguir descrevem as métricas e as estatísticas fornecidas em cada uma dessas páginas do console.
É necessário observar que, embora as duas páginas [Painel da conta](#account-dashboard) e [Métricas de reputação](#reputation-metrics) do console contenham métricas de devolução e reclamação, há uma diferença sutil entre esses dois conjuntos de taxas de devolução e reclamação, conforme explicado abaixo:
+ **Account dashboard page** (Página Painel da conta): com base no intervalo de datas selecionado, você pode ver quais eram as taxas de rejeição e reclamação no passado, mostrando a progressão métrica da mudança que aconteceu anteriormente.
+ **Página de métricas de reputação** — taxas de rejeição e reclamação com base nos dados mais recentes recebidos do cálculo de sua média histórica geral em um alto nível (isso não deve ser confundido com sua bounce/complaint taxa normal, que corresponde a bounce/complaint eventos precisos, pois eles ocorrem em tempo real, conforme mostrado na página do **painel da conta**).
Vejamos um exemplo simples de comparação das taxas de falha de entrega ou reclamação entre a página **Métricas de reputação** e a página **Painel da conta**. Se a taxa foi de 2% ontem e for de 1% agora, na página **Métricas de reputação**, você verá apenas a taxa atual de 1%, mas na página **Painel da conta**, os grafos traçarão a progressão gráfica mostrando uma taxa de 2% para ontem e 1% para hoje.
## Painel da conta
Você pode monitorar o número de e-mails enviados de sua conta, bem como a porcentagem de sua cota de envio que foi usada, diretamente na página **Account dashboard** (Painel da conta) do console do Amazon SES no painel *Daily email usage* (Uso diário de e-mail). As taxas de entrega e rejeição da sua conta podem ser monitoradas no painel *Sending Statistics* (Estatísticas de envio), bem como outros fatores-chave relacionados ao envio de e-mail nos seguintes painéis:
+ **Sending limits** (Limites do envio): contém as seguintes cotas aplicáveis ao envio de e-mails pelo SES:
+ *Daily sending quota* (Cota de envio diário): o número máximo de e-mails que você pode enviar em um período de 24 horas.
+ *Maximum send rate* (Taxa máxima de envio): o número máximo de e-mails que podem ser enviados da sua conta por segundo.
+ **Account health** (Integridade da conta): o status da conta do SES:
+ `Healthy`: não há problemas relacionados à reputação que atualmente impactem sua conta.
+ `Under review`: foram identificados problemas potenciais com sua conta do SES. A conta ficará sob análise enquanto você trabalha na correção dos problemas.
+ `Paused`: no momento, sua conta está pausada devido a um problema com um e-mail enviado de sua conta. Quando o problema for corrigido, você poderá solicitar que a capacidade da conta para enviar e-mails seja retomada.
+ **Daily email usage** (Uso diário de e-mails): para verificar seu uso diário e garantir que você não esteja se aproximando dos limites de envio:
+ *Emails sent* (E-mails enviados): número total de e-mails enviados em um período de 24 horas.
+ *Remaining sends* (Envios restantes): o número total de e-mails restantes disponíveis a serem enviados no período de 24 horas.
+ *Sending quota used* (Cota de envio usada): porcentagem da cota de envio diária usada.
+ **Sending statistics** (Estatísticas de envios): compostas de grafos que mostram a progressão de quatro métricas essenciais em um conjunto de pontos de dados ordenados por tempo. Eles representam os valores de um tipo de evento monitorado produzindo estatísticas para o intervalo de datas selecionado que usa um período de agregação de *1 hora*. Você pode selecionar um intervalo de dados com valores iniciais de `Last 1 day` a `Last 14 days` para filtrar os gráficos abaixo:
+ *Sends* (Envios): a soma das solicitações de envio de e-mail bem-sucedidas durante o intervalo de datas selecionado.
+ *Rejects* (Rejeições): a taxa média de solicitações de envio rejeitadas pelo SES com base em `Rejects/Sends * 100` para o intervalo de datas selecionado.
+ *Bounces* (Devoluções): a taxa média derivada de suas métricas históricas gerais de reputação do remetente mostrando a progressão para o intervalo de datas selecionado.
+ *Complaints* (Reclamações): a taxa média derivada de suas métricas históricas gerais de reputação do remetente mostrando a progressão para o intervalo de datas selecionado.
Cada um desses gráficos contém um CloudWatch botão **Visualizar em** que abrirá a respectiva métrica no CloudWatch console da Amazon, permitindo a visualização de dados detalhados, a execução de cálculos métricos personalizados e [a criação de alarmes](reputationdashboard-cloudwatch-alarm.md). CloudWatch
## Métricas de reputação
Além das taxas de devolução e reclamação, a página **Reputation metrics** (Métricas de reputação) também oferece visibilidade detalhada de outros fatores que afetam sua reputação, consistindo nos seguintes painéis:]
+ **Summary** (Resumo): fornece uma visão geral da sua reputação de integridade.
+ *Status*: a integridade geral da reputação com base nas taxas históricas de devolução e reclamação:
+ `Healthy`: ambas as métricas estão dentro dos níveis normais.
+ `Under review`: uma ou ambas as métricas fizeram com que sua conta fosse colocada sob análise automaticamente.
+ `At risk`: uma ou ambas as métricas atingiram níveis de não integridade e a capacidade da sua conta de enviar e-mails pode estar em risco.
+ *E-mails enviados (últimas 24 horas)*: número total de e-mails enviados nas últimas 24 horas.
+ *Envios restantes*: o número total de e-mails restantes disponíveis a serem enviados no período de 24 horas.
+ *Cota de envio usada*: porcentagem da cota de envio diária usada.
+ **Conteúdo da guia no nível da conta:**
+ Taxa de devolução
+ *Status*: indica a integridade da taxa de devolução usando os mesmos valores descritos para o painel Summary (Resumo).
+ *Historic bounce rate* (Taxa de devolução histórica): porcentagem de e-mails da conta que ocasionaram uma devolução definitiva, calculada usando sua média histórica geral com base em um volume representativo de suas práticas de envio típicas.
+ Taxa de reclamações
+ *Status*: indica a integridade da taxa de reclamações usando os mesmos valores descritos para o painel Summary (Resumo).
+ *Historic bounce rate* (Taxa de devolução histórica): porcentagem de e-mails enviados da sua conta que ocasionaram uma denúncia de spam por parte do destinatário, calculada usando sua média histórica geral com base em um volume que representa suas práticas de envio típicas.
+ **Conteúdo da guia do conjunto de configurações:**
+ Reputação por conjunto de configurações
+ *Configuration set* (Conjunto de configurações): permite que você digite ou selecione um conjunto de configurações que tenha métricas de reputação habilitadas para que você possa ver dados de resumo, devolução e reclamação com base nos e-mails enviados usando o conjunto de configurações selecionado. Os painéis resultantes exibidos após a seleção de um conjunto de configurações são os mesmos descritos acima para a página Reputation metrics (Métricas de reputação), exceto que eles são baseados apenas no e-mail enviado com o conjunto de configurações selecionado, e não nas métricas gerais de envio no nível da conta.
## Configurações SMTP
Esta página lista as configurações SMTP necessárias para usar a interface SMTP do Amazon SES por meio da API do SES ou de forma programática, e fornece links para criar e gerenciar suas credenciais SMTP:
+ **SMTP settings** (Configurações de SMTP): se você quiser usar uma linguagem de programação, um servidor de e-mail ou uma aplicação habilitada para SMTP a fim de se conectar à interface SMTP do Amazon SES, as seguintes informações serão fornecidas:
+ Endpoint de SMTP
+ Porta STARTTLS
+ Transport Layer Security (TLS)
+ Porta do TLS Wrapper
+ Links de autenticação fornecidos para criação e gerenciamento de credenciais do SMTP e do IAM
## Usar o console para monitorar métricas de envio e reputação
Os procedimentos a seguir ajudarão você a começar a explorar suas métricas de envio e reputação usando a página **Account dashboard** (Painel da conta), para métricas baseadas no histórico recente (até 14 dias), ou usando a página **Reputation metrics** (Métricas de reputação), para métricas baseadas em seu histórico geral até o presente momento.
**Para visualizar os e-mails enviados e a cota de envio usada**
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, escolha **Account dashboard (Painel da conta)**. Suas estatísticas de uso são mostradas em **Daily email usage** (Uso diário de e-mail).
**Para visualizar a contagem de envios, taxas de rejeições e reclamações**
1. No painel de navegação, escolha **Account dashboard (Painel da conta)**.
1. Na seção **Sending statistics** (Estatísticas de envios), use o **Date range** (Faixa de datas) lista suspensa para selecionar um valor inicial para um intervalo de datas para filtrar os quatro gráficos diretamente abaixo da seção **Sending statistics** (Estatísticas de envios).
1. Página Account dashboard: com base no intervalo de datas selecionado, você pode ver quais eram as taxas de rejeição e reclamação no passado, mostrando a progressão métrica da mudança que aconteceu anteriormente.
1. Em qualquer um dos gráficos, escolha o CloudWatch botão **Visualizar em** para abrir a respectiva métrica no CloudWatch console da **Amazon**, onde você pode visualizar dados detalhados, realizar cálculos métricos personalizados e [criar alarmes de monitoramento](reputationdashboard-cloudwatch-alarm.md). CloudWatch
**Como visualizar taxas históricas gerais de devolução e reclamação**
1. No painel de navegação à esquerda, escolha **Reputation metrics** (Métricas de reputação).
1. No painel **Bounce rate** (Taxa de devolução), é possível visualizar a porcentagem de e-mails enviados de sua conta que resultaram em uma devolução definitiva. No painel **Complaint rate** (Taxa de reclamação), é possível visualizar a porcentagem de e-mails enviados de sua conta que resultaram em denúncias de spam por parte dos destinatários; ambas as métricas são calculadas usando um volume representativo de e-mails com base em suas práticas de envio típicas.
1. Em qualquer um dos painéis, escolha o CloudWatch botão **Visualizar em** para abrir a respectiva métrica no CloudWatch console da **Amazon**, onde você pode visualizar dados detalhados, realizar cálculos métricos personalizados e [criar alarmes de monitoramento](reputationdashboard-cloudwatch-alarm.md). CloudWatch
**Como visualizar métricas de reputação por conjuntos de configurações**
1. No painel de navegação à esquerda, escolha **Reputation metrics** (Métricas de reputação).
1. Na página Reputation metrics (Métricas de reputação), selecione a guia **Configuration set** (Conjunto de configurações).
1. No painel **Reputation by configuration set** (Reputação por conjunto de configurações), clique no campo **Configuration set** (Conjunto de configurações), e selecione ou comece a digitar o nome de um conjunto de configurações que tenha métricas de reputação habilitadas.
1. Depois de selecionar o conjunto de configurações, os painéis Summary (Resumo), Bounce (Devolução) e Complaint (Reclamação) serão carregados mostrando métricas com base somente no e-mail enviado com o conjunto de configurações selecionado.
# Monitoramento de suas estatísticas de uso usando a API do Amazon SES
A API do Amazon SES fornece a operação `GetSendStatistics`, que retorna informações sobre seu uso do serviço. Recomendamos que você verifique regularmente suas estatísticas de envio, para que possa fazer ajustes, se necessário.
Quando você chama a operação `GetSendStatistics`, recebe uma lista de pontos de dados que representa as duas últimas semanas de sua atividade de envio. Cada ponto de dados na lista representa 15 minutos de atividade e contém as seguintes informações desse período:
+ O número de devoluções definitivas
+ O número de reclamações
+ O número de tentativas de entrega (corresponde ao número de e-mails que você enviou)
+ O número de tentativas de envio rejeitadas
+ Um carimbo de data e hora do período de análise
Para obter uma descrição detalhada da operação `GetSendStatistics`, consulte a [Referência da API do Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/GetSendStatistics.html).
Nesta seção, você encontrará os seguintes tópicos:
+ [Chamando a operação `GetSendStatistics` da API usando o AWS CLI](#monitor-sending-activity-api-cli)
+ [Chamar a operação `GetSendStatistics` de forma programática](#monitor-sending-activity-api-sdk)
## Chamando a operação `GetSendStatistics` da API usando o AWS CLI
A maneira mais fácil de chamar a operação da API `GetSendStatistics` é usar a [AWS Command Line Interface](https://aws.amazon.com/cli) (AWS CLI).
**Para chamar a operação `GetSendStatistics` da API usando o AWS CLI**
1. Se você ainda não tiver feito isso, instale a AWS CLI. Para obter mais informações, consulte "[Instalando o AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)" no *Guia AWS Command Line Interface do usuário*.
1. Se você ainda não tiver feito isso, configure o AWS CLI para usar suas AWS credenciais. Para obter mais informações, consulte "[Configurando o AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)" no *Guia do AWS Command Line Interface usuário*.
1. Na linha de comando, execute o seguinte comando:
```
aws ses get-send-statistics
```
Se o AWS CLI estiver configurado corretamente, você verá uma lista de estatísticas de envio no formato JSON. Cada objeto JSON inclui estatísticas de envio agregadas para um período de 15 minutos.
## Chamar a operação `GetSendStatistics` de forma programática
Você também pode chamar a `GetSendStatistics` operação usando AWS SDKs o. Esta seção inclui exemplos de código AWS SDKs para Go, PHP, Python e Ruby. Escolha um dos seguintes links para visualizar exemplos de código da linguagem:
+ [Exemplo de código do AWS SDK para Go](#code-example-getsendstatistics-golang)
+ [Exemplo de código do AWS SDK para PHP](#code-example-getsendstatistics-php)
+ [Exemplo de código do AWS SDK para Python (Boto)](#code-example-getsendstatistics-python)
+ [Exemplo de código do AWS SDK para Ruby](#code-example-getsendstatistics-ruby)
**nota**
Esses exemplos de código pressupõem que você criou um arquivo de credenciais AWS compartilhado que contém sua ID de chave de AWS acesso, sua chave de acesso AWS secreta e sua AWS região preferida. Para obter mais informações, consulte [Credenciais e arquivos de configuração compartilhados](https://docs.aws.amazon.com/credref/latest/refdocs/creds-config-files.html).
### Chamando `GetSendStatistics` usando o AWS SDK para Go
```
1. package main
2.
3. import (
4. "fmt"
5.
6. //go get github.com/aws/aws-sdk-go/...
7. "github.com/aws/aws-sdk-go/aws"
8. "github.com/aws/aws-sdk-go/aws/session"
9. "github.com/aws/aws-sdk-go/service/ses"
10. "github.com/aws/aws-sdk-go/aws/awserr"
11. )
12.
13. const (
14. // Replace us-west-2 with the AWS Region you're using for Amazon SES.
15. AwsRegion = "us-west-2"
16. )
17.
18. func main() {
19.
20. // Create a new session and specify an AWS Region.
21. sess, err := session.NewSession(&aws.Config{
22. Region:aws.String(AwsRegion)},
23. )
24.
25. // Create an SES client in the session.
26. svc := ses.New(sess)
27. input := &ses.GetSendStatisticsInput{}
28.
29. result, err := svc.GetSendStatistics(input)
30.
31. // Display error messages if they occur.
32. if err != nil {
33. if aerr, ok := err.(awserr.Error); ok {
34. switch aerr.Code() {
35. default:
36. fmt.Println(aerr.Error())
37. }
38. } else {
39. // Print the error, cast err to awserr.Error to get the Code and
40. // Message from an error.
41. fmt.Println(err.Error())
42. }
43. return
44. }
45.
46. fmt.Println(result)
47. }
```
### Chamando `GetSendStatistics` usando o AWS SDK para PHP
```
1. 'latest',
16. 'region' => REGION
17. ));
18.
19. try {
20. $result = $client->getSendStatistics([]);
21. echo($result);
22. } catch (Exception $e) {
23. echo($e->getMessage()."\n");
24. }
25.
26. ?>
```
### Chamando `GetSendStatistics` usando o AWS SDK para Python (Boto)
```
1. import boto3 #pip install boto3
2. import json
3. from botocore.exceptions import ClientError
4.
5. client = boto3.client('ses')
6.
7. try:
8. response = client.get_send_statistics(
9. )
10. except ClientError as e:
11. print(e.response['Error']['Message'])
12. else:
13. print(json.dumps(response, indent=4, sort_keys=True, default=str))
```
### Chamando `GetSendStatistics` usando o AWS SDK para Ruby
```
1. require 'aws-sdk' # gem install aws-sdk
2. require 'json'
3.
4. # Replace us-west-2 with the AWS Region you're using for Amazon SES.
5. awsregion = "us-west-2"
6.
7. # Create a new SES resource and specify a region
8. ses = Aws::SES::Client.new(region: awsregion)
9.
10. begin
11.
12. resp = ses.get_send_statistics({
13. })
14. puts JSON.pretty_generate(resp.to_h)
15.
16. # If something goes wrong, display an error message.
17. rescue Aws::SES::Errors::ServiceError => error
18. puts error
19.
20. end
```
# Monitorar o envio de e-mails usando a publicação de eventos do Amazon SES
Para permitir que você acompanhe seu envio de e-mail em um nível granular, você pode configurar o Amazon SES para publicar *eventos de envio de e-mail* para a Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint, Amazon Simple Notification Service ou EventBridge Amazon com base nas características que você define.
Você pode rastrear vários tipos de eventos de envio de e-mail, incluindo envios, entregas, aberturas, cliques, devoluções, reclamações, rejeições, falhas de renderização e atrasos de entrega. Essas informações podem ser úteis para fins analíticos e operacionais. Por exemplo, você pode publicar seus dados de envio de e-mail CloudWatch e criar painéis que acompanham o desempenho de suas campanhas de e-mail, ou você pode usar o Amazon SNS para enviar notificações quando determinados eventos ocorrerem.
## Como a publicação de eventos funciona com conjuntos de configurações e etiquetas de mensagem
Para usar a publicação de eventos, primeiro você deve configurar um ou mais *conjuntos de configurações*. Um conjunto de configurações especifica onde publicar seus eventos e quais eventos publicar. Em seguida, toda vez que você envia um e-mail, você fornece o nome do conjunto de configurações e uma ou mais *tags de mensagem*, na forma de name/value pares, para categorizar o e-mail. Por exemplo, se você anuncia livros, poderia dar um nome a uma tag de mensagem *genre* e atribuir o valor *sci-fi* ou *western* ao enviar um e-mail para a campanha associada.
Dependendo da interface de envio de e-mail que você usa, será possível fornecer a etiqueta de mensagem como um parâmetro para o campo [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags) da operação de API [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html) ou adicionar a etiqueta de mensagem às [https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers) de cabeçalho de e-mail específico do SES. Para obter mais informações sobre os conjuntos de configurações, consulte [Uso de conjuntos de configurações no Amazon SES](using-configuration-sets.md).
Além das etiquetas de mensagem que você especificar, o SES também adicionará *etiquetas automáticas* para as mensagens enviadas. Você não precisa realizar nenhuma etapa adicional para usar tags automáticas.
A tabela a seguir lista as etiquetas automáticas aplicadas automaticamente às mensagens enviadas pelo SES.
**Etiquetas automáticas do SES**
| Nome da tag automática | Description |
| --- | --- |
| ses:caller-identity | A identidade do IAM do usuário do SES que enviou o e-mail. |
| ses:configuration-set | O nome do conjunto de configurações associado ao e-mail. |
| ses:from-domain | O domínio do endereço "From". |
| ses:outgoing-ip | O endereço IP que o SES usou para enviar o e-mail. |
| ses:source-ip | O endereço IP que o chamador usou para enviar o e-mail. |
| ses:source-tls-version | A versão do protocolo TLS que o agente de chamada usou para enviar o e-mail. |
| ses:outgoing-tls-version | A versão do protocolo TLS que o SES usou para enviar o e-mail. |
## Feedback refinado para campanhas de e-mail
A etiqueta `ses:feedback-id-` é uma etiqueta de mensagem opcional que você pode considerar uma etiqueta híbrida ou semiautomática. Embora seja semelhante às etiquetas automáticas discutidas na seção anterior, a diferença é que você precisa adicioná-la manualmente e usar a tecla de prefixo `ses:`. Você pode usar até duas dessas etiquetas definidas como `ses:feedback-id-a` e `ses:feedback-id-b`.
Quando você especifica essas etiquetas, o SES as anexa automaticamente ao cabeçalho `Feedback-ID` padrão que é usado para fornecer estatísticas de entrega, como taxas de reclamações e spam, como parte de um ciclo de feedback (FBL). Consulte [Encaminhamentos de feedback](faqs-enforcement.md#cm-feedback-loop). O `Feedback-ID` cabeçalho é composto pelo identificador, *SESInternalID*, usado pelo SES para coletar informações de reclamação, e a tag estática, *AmazonSES, identificando o SES* como a plataforma de envio, como:
`FeedBackId:feedback-id-a:feedback-id-b:((SESInternalID):(AmazonSES))`
Essas etiquetas de identificação de feedback opcionais são oferecidas como uma forma de gerar feedback refinado, por exemplo, para mensagens enviadas como parte de uma campanha de e-mail. Você pode usar `ses:feedback-id-` especificando-a como uma etiqueta de mensagem no campo [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags) da solicitação de operação [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html), conforme mostrado no exemplo a seguir:
```
{
"FromEmailAddress": "noreply@example.com",
"Destination": {
"ToAddresses": [
"customer@example.net"
]
},
"Content": {
"Simple": {
"Subject": {
"Data": "Hello and welcome"
},
"Body": {
"Text": {
"Data": "Lorem ipsum dolor sit amet."
},
"Html": {
"Data": "Lorem ipsum dolor sit amet."
}
}
}
},
"EmailTags": [
{
"Name": "ses:feedback-id-a",
"Value": "new-members-campaign"
},
{
"Name": "ses:feedback-id-b",
"Value": "football-campaign"
}
],
"ConfigurationSetName": "football-club"
}
```
Se estiver enviando em formato bruto, você adicionará `ses:feedback-id-` como uma etiqueta de mensagem às [`X-SES-MESSAGE-TAGS`](event-publishing-send-email.md#event-publishing-using-ses-headers) de cabeçalho específico do SES.
A tag da `ses:feedback-id-` mensagem também pode ser rastreada na Amazon CloudWatch especificando-a como uma fonte de CloudWatch valor, assim como qualquer outra tag de mensagem, consulte [Adicionando um destino de CloudWatch evento](event-publishing-add-event-destination-cloudwatch.md#event-publishing-add-event-destination-cloudwatch-add) *(Cobranças adicionais se aplicam, consulte [Preço por métrica para CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing)*.)
## Como usar a publicação de eventos
As seções a seguir contêm as informações necessárias para configurar e usar a publicação de eventos do SES.
+ [Configurar a publicação de eventos](monitor-sending-using-event-publishing-setup.md)
+ [Trabalhar com dados de eventos](working-with-event-data.md)
## Terminologia de publicação de eventos
A lista a seguir define os termos relacionados à publicação de eventos do SES.
**Evento de envio de e-mails**
Informações associadas ao resultado de um e-mail que você envia ao SES. Os eventos de envio incluem o seguinte:
+ **Send** (Envio): a solicitação de envio foi bem-sucedida e o Amazon SES tentará entregar a mensagem ao servidor de e-mail do destinatário. (Se a supressão global ou no nível da conta estiver sendo usada, o SES ainda contará como um envio, mas a entrega está suprimida.)
+ **RenderingFailure**— O e-mail não foi enviado devido a um problema de renderização do modelo. Esse tipo de evento pode ocorrer quando estão faltando dados no modelo ou quando há uma incompatibilidade entre os parâmetros e os dados do modelo. (Esse tipo de evento só ocorre quando você envia e-mails usando as operações de API [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) ou [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html))
+ **Reject (Rejeição)**: o Amazon SES aceitou o e-mail, mas determinou que ele continha um vírus e não tentou entregá-lo ao servidor de e-mail do destinatário.
+ **Delivery** (Entrega): o Amazon SES entregou com êxito o e-mail ao servidor de e-mail do destinatário.
+ **Devolução**: uma *devolução definitiva* em que o servidor de e-mail do destinatário rejeitou permanentemente o e-mail. (Os *soft bounces* só são incluídos quando o SES não está mais tentando entregar o e-mail novamente. Geralmente, esses soft bounces indicam uma falha na entrega, embora em alguns casos um soft bounce possa ser devolvido mesmo quando o e-mail chega à caixa de entrada do destinatário com sucesso. Isso geralmente ocorre quando o destinatário envia uma resposta out-of-office automática. Saiba mais sobre soft bounces neste artigo do [AWS re:POST](https://repost.aws/knowledge-center/ses-understand-soft-bounces).)
+ **Complaint** (Reclamação): o e-mail foi entregue com sucesso ao servidor de e-mail do destinatário, mas o destinatário marcou-o como spam.
+ **DeliveryDelay**— O e-mail não pôde ser entregue ao servidor de e-mail do destinatário porque ocorreu um problema temporário. Atrasos de entrega podem ocorrer, por exemplo, quando a caixa de entrada do destinatário está cheia ou quando o servidor de recebimento de e-mail enfrenta um problema transitório.
+ **Subscription** (Assinatura): o e-mail foi entregue com êxito, mas o destinatário atualizou as preferências de assinatura clicando em `List-Unsubscribe` no cabeçalho do e-mail ou no link `Unsubscribe` no rodapé.
+ **Open** (Abertura): o destinatário recebeu a mensagem e a abriu em seu cliente de e-mail.
+ **Click** (Clique): o destinatário clicou em um ou mais links no e-mail.
**Conjunto de configurações**
Um conjunto de regras que define o destino no qual o SES publica eventos de envio de e-mail e os tipos de eventos de envio de e-mail que você deseja publicar. Quando você envia um e-mail que deseja usar com a publicação do evento, precisa especificar o conjunto de configurações a ser associado ao e-mail.
**Destino do evento**
Um AWS serviço para o qual você publica eventos de envio de e-mails do SES. Cada destino de evento que você configura pertence a um, e apenas um, conjunto de configurações.
**Tag de mensagem**
Um name/value par que você usa para categorizar um e-mail para fins de publicação de eventos. Alguns exemplos são *campanha/livro* e *campanha/roupas*. Quando você envia um e-mail, especifica a etiqueta de mensagem como um parâmetro para a chamada de API ou como um cabeçalho de e-mail específico do SES.
**Tag automática**
Tags de mensagens que são incluídas automaticamente nos relatórios de publicação de eventos. Há uma etiqueta automática para o nome do conjunto de configurações, o domínio do endereço do remetente, o endereço IP de saída do autor da chamada, o endereço IP de saída do SES e a identidade do IAM do autor da chamada.
# Configuração de publicação de eventos do Amazon SES
Esta seção descreve o que você precisa fazer para configurar o Amazon SES para publicar seus eventos de envio de e-mail nos seguintes AWS serviços:
+ Amazon CloudWatch
+ Amazon Data Firehose
+ Amazon Pinpoint
+ Amazon Simple Notification Service (Amazon SNS)
As etapas a seguir, necessárias para configurar a publicação de eventos, são abordadas nos tópicos abaixo:
1. Primeiro, você cria um *conjunto de configurações* usando o console ou a API do Amazon SES.
1. Adicione um ou mais *destinos de eventos* (FirehoseCloudWatch, Pinpoint ou SNS) ao conjunto de configurações e configure parâmetros exclusivos para o destino do evento.
1. Quando envia um e-mail, você especifica um conjunto de configurações a ser usado para o seu destino de eventos.
**Topics**
+ [Etapa 1: Criar um conjunto de configurações](event-publishing-create-configuration-set.md)
+ [Etapa 2: Adicionar um destino de evento](event-publishing-add-event-destination.md)
+ [Etapa 3: Especificar o conjunto de configurações no envio de e-mail](event-publishing-send-email.md)
# Etapa 1: Criar um conjunto de configurações
Você deve primeiro ter um conjunto de configurações para configurar a publicação de eventos. Se você ainda não tiver um conjunto de configurações, ou desejar criar um novo, consulte [Criação de conjuntos de configurações no SES](creating-configuration-sets.md)
Você também pode criar conjuntos de configurações usando a [CreateConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateConfigurationSet.html)operação na API V2 do Amazon SES ou na CLI v2 do Amazon SES, consulte. [Criar um conjunto de configurações (AWS CLI)](creating-configuration-sets.md#config-sets-create-cli)
# Etapa 2: Adicionar um destino de evento
Destinos de eventos são locais nos quais são publicados os eventos do Amazon SES. Cada destino de evento que você configura pertence a um, e apenas um, conjunto de configurações. Ao configurar um destino de evento com o Amazon SES, você escolhe o destino do AWS serviço e especifica os parâmetros associados a esse destino.
Ao configurar o destino de um evento, você pode optar por enviar eventos para um dos seguintes AWS serviços:
+ Amazon CloudWatch
+ Amazon Data Firehose
+ Amazon EventBridge
+ Amazon Pinpoint
+ Amazon Simple Notification Service (Amazon SNS)
O destino de evento escolhido depende do nível de detalhes desejado sobre os eventos e da maneira como você deseja receber as informações sobre o evento. Se quiser apenas um total de execução de cada tipo de evento (por exemplo, para poder definir um alarme quando o total for muito alto), você poderá usar o CloudWatch.
Se você quiser registros detalhados de eventos que possam ser enviados para outro serviço, como Amazon OpenSearch Service ou Amazon Redshift, para análise, você pode usar o Firehose.
Se quiser receber notificações quando ocorrerem certos eventos, você pode usar o Amazon SNS.
**Topics**
+ [Configurar um destino de CloudWatch evento para publicação de eventos](event-publishing-add-event-destination-cloudwatch.md)
+ [Configurar um destino de eventos do Data Firehose para publicação de eventos do Amazon SES](event-publishing-add-event-destination-firehose.md)
+ [Configure um EventBridge destino da Amazon para publicação de eventos](event-publishing-add-event-destination-eventbridge.md)
+ [Configurar um destino de eventos do Amazon Pinpoint para publicação de eventos](event-publishing-add-event-destination-pinpoint.md)
+ [Configure um destino de eventos do Amazon SNS para publicação de eventos](event-publishing-add-event-destination-sns.md)
# Configurar um destino de CloudWatch evento para publicação de eventos
Com [ CloudWatch as métricas da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html), você pode usar destinos de eventos para publicar e-mails do Amazon SES enviando eventos para CloudWatch. Como um destino de CloudWatch evento só pode ser configurado em um conjunto de configurações, você deve primeiro [criar um conjunto de configurações](event-publishing-create-configuration-set.md) e, em seguida, adicionar o destino do evento ao conjunto de configurações.
Ao adicionar um destino de CloudWatch evento a um conjunto de configurações, você deve escolher uma ou mais CloudWatch *dimensões* que correspondam às tags de mensagem que você usa ao enviar seus e-mails. Assim como as tags de mensagem, uma CloudWatch dimensão é um name/value par que ajuda você a identificar uma métrica de forma exclusiva.
Por exemplo, você pode ter uma tag de mensagem e uma dimensão chamada `campaign`, que você usa para identificar sua campanha de e-mails. Quando você publica seus eventos de envio de e-mail em CloudWatch, escolher suas tags e dimensões de mensagem é importante porque essas escolhas afetam seu CloudWatch faturamento e determinam como você pode filtrar seus dados de eventos de envio de e-mail. CloudWatch
Esta seção fornece informações para ajudá-lo a escolher suas dimensões e, em seguida, mostra como adicionar um destino de CloudWatch evento a um conjunto de configurações.
**Topics**
+ [Adicionando um destino de CloudWatch evento](#event-publishing-add-event-destination-cloudwatch-add)
+ [Escolhendo CloudWatch dimensões](#event-publishing-add-event-destination-cloudwatch-dimensions)
## Adicionando um destino de CloudWatch evento
O procedimento nesta seção mostra como adicionar detalhes do destino do CloudWatch evento a um conjunto de configurações e pressupõe que você tenha concluído as etapas de 1 a 6 polegadas. [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add)
Você também pode usar a [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operação na API V2 do Amazon SES para criar e modificar destinos de eventos.
**Para adicionar detalhes CloudWatch do destino do evento a um conjunto de configurações usando o console**
1. Estas são as instruções detalhadas para selecionar CloudWatch como seu tipo de destino de evento na [Etapa 7](event-destinations-manage.md#specify-event-dest-step) e pressupõe que você tenha concluído todas as etapas anteriores. [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add) Depois de selecionar o **tipo de CloudWatch destino**, inserir um **nome** de destino e ativar a **publicação de eventos**, o painel de ** CloudWatch dimensões da Amazon** é exibido — seus campos são abordados nas etapas a seguir. *(Cobranças adicionais se aplicam, consulte [Preço por métrica para CloudWatch](#cw-add-pricing).)*
1. Em **Value Source**, especifique como o Amazon SES obterá os dados para os quais ele passa CloudWatch. As origens de valores a seguir estão disponíveis:
+ **Message Tag (Etiqueta de mensagem)**; o Amazon SES recupera o nome e o valor da dimensão de uma etiqueta que você especifica usando o cabeçalho `X-SES-MESSAGE-TAGS` ou o parâmetro de API `EmailTags`. Para obter mais informações sobre como usar tags de mensagem, consulte [Etapa 3: Especificar o conjunto de configurações no envio de e-mail](event-publishing-send-email.md).
**nota**
Tags de mensagens podem incluir números de 0-9, as letras A-Z (letras maiúsculas e minúsculas), hífens (-) e sublinhados (\$1).
Você também pode usar a origem do valor **Message Tag (Etiqueta de mensagem)** para criar dimensões com base nas etiquetas automáticas do Amazon SES. Para usar uma tag automática, digite o nome completo da tag automática como o **Dimension Name** (Nome da dimensão). Por exemplo, para criar uma dimensão com base no conjunto de configuração de tags automáticas, use `ses:configuration-set` para o **Dimension Name** (Nome da dimensão), e o nome do conjunto de configurações para o **Default Value** (Valor padrão). Para obter uma lista completa de tags automáticas, consulte [Como a publicação de eventos funciona com conjuntos de configurações e etiquetas de mensagem](monitor-using-event-publishing.md#event-publishing-how-works).
+ **Email Header (Cabeçalho de e-mail)**: o Amazon SES recupera o nome e o valor da dimensão de um cabeçalho no e-mail.
**nota**
Nenhum dos cabeçalhos de e-mail a seguir pode ser usado como **Dimension Name**: `Received`, `To`, `From`, `DKIM-Signature`, `CC`, `message-id` ou `Return-Path`.
+ **Link Tag (Etiqueta de link)**: o Amazon SES recupera o nome e o valor da dimensão de uma etiqueta que você especificou em um link. Para obter mais informações sobre a adição de tags em links, consulte [Posso usar tags em links com identificadores exclusivos?](faqs-metrics.md#sending-metric-faqs-clicks-q5).
1. Em **Dimension Name (Nome da dimensão)**, digite o nome da dimensão que você deseja passar para o CloudWatch.
**nota**
Os nomes de dimensão só podem conter letras ASCII (a - z, A - Z), números (0 - 9), sublinhados (\$1) ou traços (-). Espaços, caracteres acentuados, caracteres não latinos e outros caracteres especiais não são permitidos.
1. Em **Default Value** (Valor padrão), digite o valor da dimensão.
**nota**
Os valores de dimensão só podem conter letras ASCII (a - z, A - Z), números (0 - 9), sublinhados (\$1), traços (-), sinais de arroba (@) e pontos (.). Espaços, caracteres acentuados, caracteres não latinos e outros caracteres especiais não são permitidos.
1. Para adicionar mais dimensões, selecione **Add Dimension** (Adicionar dimensão). Caso contrário, escolha **Next**.
1. Na tela de revisão, se você estiver satisfeito com a forma como definiu o destino de eventos, escolha **Add destination (Adicionar destino)**.
## Escolhendo CloudWatch dimensões
Ao escolher nomes e valores para usar como CloudWatch dimensões, considere os seguintes fatores:
+ **Preço por métrica** — Você pode visualizar as métricas básicas do Amazon SES CloudWatch gratuitamente. No entanto, ao coletar métricas usando a publicação de eventos, você incorre em custos de [monitoramento CloudWatch detalhado](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-basic-detailed.html). Cada combinação exclusiva de tipo de evento, nome da dimensão e valor da dimensão cria uma métrica diferente em CloudWatch. Ao usar o Monitoramento detalhado CloudWatch, você é cobrado por cada métrica. Por esse motivo, você pode querer evitar a escolha de dimensões que tenham muitos valores diferentes. Por exemplo, a menos que esteja muito interessado em rastrear seus eventos de envio de e-mails pelo domínio de origem, talvez seja melhor não definir uma dimensão para a etiqueta automática `ses:from-domain` do Amazon SES, pois ela pode assumir muitos valores diferentes. Para obter mais informações, consulte [Preços do CloudWatch](https://aws.amazon.com/cloudwatch/pricing).
+ **Filtragem métrica** — Se uma métrica tiver várias dimensões, você não poderá acessá-la CloudWatch com base em cada dimensão separadamente. Por esse motivo, pense bem antes de adicionar mais de uma dimensão a um único destino de CloudWatch evento. Por exemplo, se desejar métricas por `campaign` e por uma combinação de `campaign` e `genre`, você precisará adicionar dois destinos de eventos: um com apenas `campaign` como uma dimensão, e um com `campaign` e `genre` como dimensões.
+ **Origem do valor da dimensão**: como alternativa para especificar os valores de dimensão usando cabeçalhos específicos do Amazon SES ou um parâmetro para a API, você também pode escolher que o Amazon SES extraia os valores de dimensão de seus próprios cabeçalhos de mensagens MIME. Você pode usar essa opção caso já esteja usando cabeçalhos personalizados e não queira alterar seus e-mails ou chamadas para a API de envio de e-mail para coletar métricas com base em seus valores de cabeçalho. Se você usa seus próprios cabeçalhos de mensagem MIME para a publicação de eventos do Amazon SES, os nomes e valores de cabeçalhos usados para a publicação de eventos do Amazon SES só podem incluir letras de A a Z, números de 0 a 9, sublinhados (\$1), arrobas (@), hifens (-) e pontos (.). Se você especificar um nome ou valor que contenha outros caracteres, a chamada de envio por e-mail ainda será bem-sucedida, mas as métricas do evento não serão enviadas para a Amazon CloudWatch.
Para obter mais informações sobre CloudWatch conceitos, consulte [Amazon CloudWatch Concepts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html) no *Guia CloudWatch do usuário da Amazon*.
# Configurar um destino de eventos do Data Firehose para publicação de eventos do Amazon SES
Um destino de eventos do Amazon Data Firehose representa uma entidade que publica eventos específicos de envio de e-mails do Amazon SES no Firehose. Uma vez que um destino de eventos do Firehose só pode ser configurado em um conjunto de configurações, primeiro é necessário [criar um conjunto de configurações](event-publishing-create-configuration-set.md). Depois, adicione o destino do evento ao conjunto de configurações.
O procedimento nesta seção mostra como adicionar detalhes de um destino de eventos do Firehose a um conjunto de configurações e pressupõe que você tenha realizado as etapas de 1 a 6 em [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add).
Você também pode usar a [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operação no destino da API V2 do Amazon SES para criar e atualizar destinos de eventos.
**Para adicionar detalhes do destino de eventos do Firehose a um conjunto de configurações usando o console**
1. Estas são as instruções detalhadas para selecionar o Firehose como o tipo de destino de eventos na [Etapa 7](event-destinations-manage.md#specify-event-dest-step) e pressupõem que você tenha concluído as etapas anteriores em [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add). Depois de selecionar o **Tipo de destino do Firehose**, inserir um **Nome de destino** e ativar a **Publicação de eventos**, o painel de **fluxo de entrega do Amazon Data Firehose** é exibido. Os respectivos campos são abordados nas etapas a seguir.
1. Em **Fluxo de entrega**, escolha um fluxo de entrega existente do Firehose ou escolha **Criar um novo fluxo** para criar um novo usando o console do Firehose.
Para obter mais informações sobre a criação de um fluxo de entrega usando o console do Firehose, consulte [Criação de um fluxo de entrega do Amazon Kinesis Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) no *Guia do desenvolvedor do Amazon Data Firehose*.
1. Em **Perfil do Identity and Access Management (IAM)**, escolha um perfil do IAM no qual o Amazon SES tenha permissão para publicar no Firehose em seu nome. Você pode escolher uma função existente, deixar que o Amazon SES crie uma função para você ou criar sua própria função.
Se você escolher uma função existente ou criar a sua própria, deverá modificar manualmente as políticas para conceder à função permissão para acessar o fluxo de entrega do Firehose e permitir que o Amazon SES assuma a função. Para obter exemplos de políticas, consulte [Concessão de permissão ao Amazon SES para publicar no fluxo de entrega do Firehose](#event-publishing-add-event-destination-firehose-role).
1. Escolha **Próximo**.
1. Na tela de revisão, se você estiver satisfeito com a forma como definiu o destino de eventos, escolha **Add destination (Adicionar destino)**.
Para obter informações sobre como usar a API `UpdateConfigurationSetEventDestination` para adicionar um destino de eventos do Firehose, consulte a [Referência da API do Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetEventDestination.html).
## Concessão de permissão ao Amazon SES para publicar no fluxo de entrega do Firehose
Para permitir que o Amazon SES publique registros no seu fluxo de entrega do Firehose, você deve usar um [perfil](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) do AWS Identity and Access Management (IAM) e anexar ou modificar a política de permissões e a política de confiança do perfil. A política de permissões permite que o perfil publique registros no fluxo de entrega do Firehose e a política de confiança permite que o Amazon SES assuma o perfil.
Esta seção apresenta exemplos das duas políticas. Para obter mais informações sobre a anexação de políticas a funções do IAM, consulte [Modificação de uma função](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) no *Guia do usuário do IAM*.
### Política de permissões
A política de permissões a seguir permite que o perfil publique registros de dados em seu fluxo de entrega do Firehose.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Action": [
"firehose:PutRecordBatch"
],
"Resource": [
"arn:aws:firehose:us-east-1:111122223333:deliverystream/delivery-stream-name"
]
}
]
}
```
------
Faça as seguintes alterações no exemplo de política anterior:
+ *delivery-region*Substitua pela AWS região em que você criou o stream de entrega do Firehose.
+ Substitua *111122223333* pelo ID de sua conta da AWS .
+ *delivery-stream-name*Substitua pelo nome do stream de entrega do Firehose.
### Política de confiança
A seguinte política de confiança permite que o Amazon SES assuma a função.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:delivery-region:111122223333:configuration-set/configuration-set-name"
}
}
}
]
}
```
------
Faça as seguintes alterações no exemplo de política anterior:
+ *delivery-region*Substitua pela AWS região em que você criou o stream de entrega do Firehose.
+ Substitua *111122223333* pelo ID de sua conta da AWS .
+ *configuration-set-name*Substitua pelo nome do seu conjunto de configurações associado ao stream de entrega do Firehose.
# Configure um EventBridge destino da Amazon para publicação de eventos
Um destino de EventBridge evento da Amazon notifica você sobre os eventos de envio de e-mail que você especifica em um conjunto de configurações. O SES gera e envia por e-mail eventos de envio que você define ao criar um destino de evento para o barramento de eventos EventBridge padrão. Um [barramento de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html) é um roteador que recebe eventos e pode entregá-los a vários destinos. Você pode aprender mais sobre a integração de eventos de envio de e-mail com a Amazon EventBridge em[Monitoramento de eventos do SES usando a Amazon EventBridge](monitoring-eventbridge.md). Como um destino de EventBridge evento só pode ser configurado em um conjunto de configurações, você precisa [criar um conjunto de configurações](event-publishing-create-configuration-set.md) antes de adicionar o destino do evento ao conjunto de configurações.
O procedimento nesta seção mostra como adicionar detalhes do destino do EventBridge evento a um conjunto de configurações e pressupõe que você tenha concluído as etapas de 1 a 6 polegadas. [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add)
Você também pode usar a [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operação na API V2 do Amazon SES para criar e modificar destinos de eventos.
**Para adicionar detalhes EventBridge do destino do evento a um conjunto de configurações usando o console**
1. Estas são as instruções detalhadas para selecionar EventBridge como seu tipo de destino de evento na [Etapa 7](event-destinations-manage.md#specify-event-dest-step) e pressupõe que você tenha concluído todas as etapas anteriores. [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add) Depois de selecionar o **tipo de EventBridge destino** da *Amazon*, inserir um **nome** de destino e ativar a **publicação de eventos**, um painel informativo do **Amazon EventBridge Event Bus** é exibido.
1. Escolha **Próximo**.
1. Na tela de revisão, se você estiver satisfeito com a forma como definiu o destino de eventos, escolha **Add destination (Adicionar destino)**. Isso abrirá a página de resumo do destino do evento, na qual um banner de êxito confirmará se o destino do evento foi criado ou modificado com sucesso.
# Configurar um destino de eventos do Amazon Pinpoint para publicação de eventos
Um destino de evento do Amazon Pinpoint notifica você sobre eventos de envio de e-mail que você especificou em um conjunto de configurações. Como um destino de evento do Amazon Pinpoint só pode ser definido em um conjunto de configurações, é necessário [criar um conjunto de configurações](event-publishing-create-configuration-set.md) antes de adicionar o destino de evento a esse conjunto.
O procedimento nesta seção mostra como adicionar um destino de eventos do Amazon Pinpoint a um conjunto de configurações e pressupõe que você tenha realizado as etapas de 1 a 6 em [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add).
Você também pode usar a [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operação na API V2 do Amazon SES para criar e modificar destinos de eventos.
Há cobranças adicionais para os tipos de canal que você configurou em seus projetos do Amazon Pinpoint. Para mais informações, consulte [Preços do Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/).
**Para adicionar detalhes do destino de eventos do Amazon Pinpoint a um conjunto de configurações usando o console**
1. Estas são as instruções detalhadas para selecionar o Amazon Pinpoint como o tipo de destino de eventos na [Etapa 7](event-destinations-manage.md#specify-event-dest-step), pressupondo que você tenha concluído todas as etapas anteriores em [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add).
**nota**
O Amazon Pinpoint não aceita **atrasos de entrega** nem **tipos de assinatura**.
Depois de selecionar o **Tipo de destino** do Amazon Pinpoint, inserir o **Nome** do destino e habilitar a **Publicação de eventos**, o painel **Detalhes do projeto do Amazon Pinpoint** será exibido. Os respectivos campos são abordados nas etapas a seguir.
1. Em **Project** (Projeto), escolha um projeto existente do Amazon Pinpoint ou escolha **Create a new project in Amazon Pinpoint** (Criar um novo projeto no Amazon Pinpoint) para criar um novo.
Para obter mais informações sobre como criar um projeto, consulte [Create a project](https://docs.aws.amazon.com/pinpoint/latest/userguide/gettingstarted-create-project.html) (Criar um projeto) no *Guia do usuário do Amazon Pinpoint*.
1. Escolha **Próximo**.
1. Na tela de revisão, se você estiver satisfeito com a forma como definiu o destino de eventos, escolha **Add destination (Adicionar destino)**. Isso abrirá a página de resumo do destino do evento, na qual um banner de êxito confirmará se o destino do evento foi criado ou modificado com sucesso.
# Configure um destino de eventos do Amazon SNS para publicação de eventos
Um destino de evento do Amazon SNS notifica você sobre eventos de envio de e-mail que você especificou em um conjunto de configurações. Como um destino de evento do Amazon SNS só pode ser definido em um conjunto de configurações, é necessário [criar um conjunto de configurações](event-publishing-create-configuration-set.md) antes de adicionar o destino de evento a esse conjunto.
O procedimento nesta seção mostra como adicionar um destino de eventos do Amazon SNS a um conjunto de configurações e pressupõe que você tenha realizado as etapas de 1 a 6 em [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add).
Você também pode usar a [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operação na API V2 do Amazon SES para criar e modificar destinos de eventos.
**nota**
As notificações de feedback para devoluções, reclamações e entregas também podem ser configuradas por meio do Amazon SNS para qualquer uma de suas identidades de envio verificadas. Para obter mais informações, consulte [Configuração de notificações do Amazon SNS para o Amazon SES](configure-sns-notifications.md).
Há cobranças adicionais para enviar mensagens para os endpoints que estão inscritos em seus tópicos do Amazon SNS. Para obter mais informações, consulte [Preços do Amazon SNS](https://aws.amazon.com/sns/pricing/).
**Para adicionar detalhes do destino de eventos do Amazon SNS a um conjunto de configurações usando o console**
1. Estas são as instruções detalhadas para selecionar o Amazon SNS como o tipo de destino de eventos em [Etapa 7](event-destinations-manage.md#specify-event-dest-step) e pressupõem que você tenha concluído todas as etapas anteriores em [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add). Depois de selecionar o **Tipo de destino** do Amazon SNS, inserir o **Nome** do destino e habilitar a **Publicação de eventos**, o painel **Tópico do Amazon Simple Notification Service (SNS)** será exibido. Os respectivos campos são abordados nas etapas a seguir.
1. Em **SNS Topic (Tópico do SNS)**, escolha um tópico existente do Amazon SNS ou escolha **Create new topic (Criar novo tópico)** para criar um novo.
Para obter informações sobre a criação de um tópico, 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.)
1. Escolha **Próximo**.
1. Na tela de revisão, se você estiver satisfeito com a forma como definiu o destino de eventos, escolha **Add destination (Adicionar destino)**. Isso abrirá a página de resumo do destino do evento, na qual um banner de êxito confirmará se o destino do evento foi criado ou modificado com sucesso.
1. Independentemente de você ter criado um novo tópico do SNS ou selecionado um existente, será necessário conceder acesso ao SES para publicar notificações no tópico. Na página de resumo do destino do evento na etapa anterior, escolha **Amazon SNS** na coluna **Destination type** (Tipo de destino) - isso levará você à lista **Topics** (Tópicos) no console do Amazon Simple Notification Service -*execute as seguintes etapas no console do Amazon SNS:*
1. Selecione o nome do tópico do SNS que você criou ou modificou na etapa anterior.
1. Na tela de detalhes do tópico, escolha **Edit** (Editar).
1. 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 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:configuration-set/configuration-set-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.
+ *111122223333*Substitua pelo ID AWS da sua conta.
+ *topic\$1name*Substitua pelo nome do seu tópico do SNS.
+ *configuration-set-name*Substitua pelo nome do seu conjunto de configurações associado ao destino do evento SNS.
1. Escolha **Salvar alterações**.
# Etapa 3: Especificar o conjunto de configurações no envio de e-mail
Depois de [criar um conjunto de configurações](event-publishing-create-configuration-set.md) e [adicionar um destino de evento](event-publishing-add-event-destination.md), a última etapa na publicação de evento será enviar seus e-mails.
Para publicar eventos associados a um e-mail, informe o nome do conjunto de configurações para associar ao e-mail. Como opção, informe as tags de mensagens para classificar o e-mail.
Forneça essas informações para o Amazon SES como parâmetros para a API de envio de e-mail, cabeçalhos específicos de e-mail do Amazon SES ou cabeçalhos personalizados em sua mensagem MIME. O método escolhido depende da interface de envio de e-mail que você usa, como mostrado na tabela a seguir.
****
| Interface de envio de e-mails | Formas de publicar eventos |
| --- | --- |
| `SendEmail` | Parâmetros de API |
| `SendTemplatedEmail` | Parâmetros de API |
| `SendBulkTemplatedEmail` | Parâmetros de API |
| `SendCustomVerificationEmail` | Parâmetros de API |
| `SendRawEmail` | Parâmetros de API, cabeçalhos de e-mail específicos do Amazon SES ou cabeçalhos MIME personalizados Se você especifica etiquetas de mensagens usando os cabeçalhos e os parâmetros de API, o Amazon SES usa apenas as etiquetas de mensagens fornecidas pelos parâmetros de API. O Amazon SES não une etiquetas de mensagens especificadas por parâmetros de API e cabeçalhos. |
| Interface SMTP | Cabeçalhos de e-mail específicos do Amazon SES |
As seções a seguir descrevem como especificar o conjunto de configurações e as tags de mensagens usando cabeçalhos e parâmetros de API.
+ [Uso de parâmetros de API do Amazon SES](#event-publishing-using-ses-parameters)
+ [Uso de cabeçalhos de e-mail específicos do Amazon SES](#event-publishing-using-ses-headers)
+ [Uso de cabeçalhos de e-mail personalizados](#event-publishing-using-custom-headers)
**nota**
Opcionalmente, você pode incluir as tags de mensagens nos cabeçalhos de seus e-mails. Tags de mensagens podem incluir números de 0-9, as letras A-Z (letras maiúsculas e minúsculas), hífens (-) e sublinhados (\$1).
## Uso de parâmetros de API do Amazon SES
Para usar [SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendEmail.html),, [SendTemplatedEmail[SendBulkTemplatedEmail[SendCustomVerificationEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendCustomVerificationEmail.html)](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html)](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html), ou [SendRawEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendRawEmail.html)com a publicação de eventos, você especifica o conjunto de configurações e as tags de mensagem passando estruturas de dados chamadas [ConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference/API_ConfigurationSet.html)e [MessageTag](https://docs.aws.amazon.com/ses/latest/APIReference/API_MessageTag.html)para a chamada da API.
Para obter informações sobre o uso da API do Amazon SES, consulte a [Referência da API do Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/).
## Uso de cabeçalhos de e-mail específicos do Amazon SES
Quando você usa a interface `SendRawEmail` ou SMTP, pode especificar o conjunto de configurações e as etiquetas de mensagem, adicionando cabeçalhos específicos do Amazon SES ao e-mail. O Amazon SES remove os cabeçalhos antes de enviar o e-mail. A tabela a seguir mostra os nomes dos cabeçalhos para usar.
| Informações de publicação de eventos | Cabeçalho |
| --- | --- |
| Conjunto de configurações | `X-SES-CONFIGURATION-SET` |
| Tags de mensagens | `X-SES-MESSAGE-TAGS` |
O exemplo a seguir mostra como os cabeçalhos podem aparecer em um e-mail bruto que você envia para o Amazon SES.
```
1. X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2
2. X-SES-CONFIGURATION-SET: myConfigurationSet
3. From: sender@example.com
4. To: recipient@example.com
5. Subject: Subject
6. Content-Type: multipart/alternative;
7. boundary="----=_boundary"
8.
9. ------=_boundary
10. Content-Type: text/plain; charset=UTF-8
11. Content-Transfer-Encoding: 7bit
12.
13. body
14. ------=_boundary
15. Content-Type: text/html; charset=UTF-8
16. Content-Transfer-Encoding: 7bit
17.
18. body
19. ------=_boundary--
```
## Uso de cabeçalhos de e-mail personalizados
Embora seja necessário especificar o nome do conjunto de configurações usando o cabeçalho `X-SES-CONFIGURATION-SET` específico do Amazon SES, você pode especificar etiquetas de mensagem usando seus próprios cabeçalhos MIME.
**nota**
Os nomes e os valores de cabeçalho que você usa para publicação de eventos do Amazon SES devem ser em ASCII. Se você especificar um nome ou valor de cabeçalho não ASCII para a publicação de eventos do Amazon SES, a chamada de envio de e-mail ainda será bem-sucedida, mas as métricas do evento não serão emitidas para a Amazon. CloudWatch
# Trabalho com dados de eventos do Amazon SES
Depois de [configurar a publicação de eventos](monitor-sending-using-event-publishing-setup.md) e especificar um conjunto de configurações para envio de e-mails, você poderá recuperar os eventos de envio de e-mail do destino do evento que especificou ao definir o conjunto de configurações associado ao e-mail.
Esta seção descreve como recuperar seus eventos de envio de e-mail do Amazon CloudWatch e do Amazon Data Firehose e como interpretar dados de eventos fornecidos pelo Amazon SNS.
+ [Recuperando dados de eventos do Amazon SES de CloudWatch](event-publishing-retrieving-cloudwatch.md)
+ [Recuperação de dados de eventos do Amazon SES originários do Firehose](event-publishing-retrieving-firehose.md)
+ [Interpretação de dados de evento do Amazon SES pelo Amazon SNS](event-publishing-retrieving-sns.md)
# Recuperando dados de eventos do Amazon SES de CloudWatch
O Amazon SES pode publicar métricas para seus eventos de envio de e-mail para a Amazon CloudWatch. Quando você publica dados de eventos no CloudWatch, ele fornece essas métricas como um conjunto ordenado de dados de séries temporais. Você pode usar essas métricas para monitorar a performance do envio de e-mails. Por exemplo, você pode monitorar a métrica de reclamação e definir um CloudWatch alarme para ser acionado quando a métrica exceder um determinado valor.
Há dois níveis de granularidade nos quais o Amazon SES pode publicar esses eventos: CloudWatch
+ **Em todo o seu Conta da AWS** — Essas métricas gerais, que correspondem às métricas que você monitora usando o console do Amazon SES e a `GetSendStatistics` API, são totais em todo o seu. Conta da AWS O Amazon SES publica essas métricas CloudWatch automaticamente.
+ **Fine-grained (Refinadas)**: essas métricas são categorizadas por características de e-mail que você define usando *etiquetas de mensagem*. Para publicar essas métricas CloudWatch, você precisa [configurar a publicação de eventos](monitor-sending-using-event-publishing-setup.md) com um destino de CloudWatch evento e [especificar um conjunto de configurações](event-publishing-send-email.md) ao enviar um e-mail. Você também pode especificar etiquetas de mensagens ou usar as [etiquetas automática](monitor-using-event-publishing.md#event-publishing-how-works) que o Amazon SES fornece automaticamente.
Esta seção descreve as métricas disponíveis e como visualizá-las no CloudWatch.
## Métricas disponíveis
Você pode publicar as seguintes métricas de envio de e-mail do Amazon SES para CloudWatch:
+ **Send** (Envio): a solicitação de envio foi bem-sucedida e o Amazon SES tentará entregar a mensagem ao servidor de e-mail do destinatário. (Se a supressão global ou no nível da conta estiver sendo usada, o SES ainda contará como um envio, mas a entrega está suprimida.)
+ **RenderingFailure**— O e-mail não foi enviado devido a um problema de renderização do modelo. Esse tipo de evento pode ocorrer quando estão faltando dados no modelo ou quando há uma incompatibilidade entre os parâmetros e os dados do modelo. (Esse tipo de evento só ocorre quando você envia e-mails usando as operações de API [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) ou [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html))
+ **Reject (Rejeição)**: o Amazon SES aceitou o e-mail, mas determinou que ele continha um vírus e não tentou entregá-lo ao servidor de e-mail do destinatário.
+ **Delivery** (Entrega): o Amazon SES entregou com êxito o e-mail ao servidor de e-mail do destinatário.
+ **Devolução**: uma *devolução definitiva* em que o servidor de e-mail do destinatário rejeitou permanentemente o e-mail. (Os *soft bounces* só são incluídos quando o SES não está mais tentando entregar o e-mail novamente. Geralmente, esses soft bounces indicam uma falha na entrega, embora em alguns casos um soft bounce possa ser devolvido mesmo quando o e-mail chega à caixa de entrada do destinatário com sucesso. Isso geralmente ocorre quando o destinatário envia uma resposta out-of-office automática. Saiba mais sobre soft bounces neste artigo do [AWS re:POST](https://repost.aws/knowledge-center/ses-understand-soft-bounces).)
+ **Complaint** (Reclamação): o e-mail foi entregue com sucesso ao servidor de e-mail do destinatário, mas o destinatário marcou-o como spam.
+ **DeliveryDelay**— O e-mail não pôde ser entregue ao servidor de e-mail do destinatário porque ocorreu um problema temporário. Atrasos de entrega podem ocorrer, por exemplo, quando a caixa de entrada do destinatário está cheia ou quando o servidor de recebimento de e-mail enfrenta um problema transitório.
+ **Subscription** (Assinatura): o e-mail foi entregue com êxito, mas o destinatário atualizou as preferências de assinatura clicando em `List-Unsubscribe` no cabeçalho do e-mail ou no link `Unsubscribe` no rodapé.
+ **Open** (Abertura): o destinatário recebeu a mensagem e a abriu em seu cliente de e-mail.
+ **Click** (Clique): o destinatário clicou em um ou mais links no e-mail.
## Dimensões disponíveis
CloudWatch usa os nomes de dimensão que você especifica ao adicionar um destino de CloudWatch evento a um conjunto de configurações no Amazon SES. Para obter mais informações, consulte [Configurar um destino de CloudWatch evento para publicação de eventos](event-publishing-add-event-destination-cloudwatch.md).
## Visualização de métricas do Amazon SES no CloudWatch console
O procedimento a seguir descreve como visualizar suas métricas de publicação de eventos do Amazon SES usando o CloudWatch console.
**Para visualizar métricas usando o CloudWatch console**
1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Se necessário, altere a região. Na barra de navegação, selecione a região em que seus AWS recursos residem. Para mais informações, consulte [Regiões e endpoints da ](https://docs.aws.amazon.com/general/latest/gr/rande.html).
1. No painel de navegação, escolha **Todas as métricas**.
1. No painel **Métricas**, selecione **SES.**
1. Escolha a métrica que você deseja visualizar. Para ver [métricas de publicação de eventos](monitor-using-event-publishing.md) minuciosas, selecione a combinação de dimensões especificada ao [configurar seu evento de destino do CloudWatch](event-publishing-add-event-destination-cloudwatch.md). Para saber mais sobre a visualização de métricas com CloudWatch, consulte [Usar CloudWatch métricas da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html).
**Para visualizar métricas usando o AWS CLI**
+ Em um prompt de comando, use o seguinte comando:
```
1. aws cloudwatch list-metrics --namespace "AWS/SES"
```
# Recuperação de dados de eventos do Amazon SES originários do Firehose
O Amazon SES publica eventos de envio de e-mail no Firehose como registros JSON. Em seguida, o Firehose publica os registros no destino do AWS serviço que você escolheu ao configurar o stream de entrega no Firehose. Para obter informações sobre a configuração de fluxos de entrega do Firehose, consulte [Como criar um fluxo de entrega do Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) no *Guia do desenvolvedor do Amazon Data Firehose*.
**Topics**
+ [Conteúdo dos dados de eventos publicados pelo Amazon SES no Firehose](event-publishing-retrieving-firehose-contents.md)
+ [Exemplos de dados de eventos que o Amazon SES publica no Firehose](event-publishing-retrieving-firehose-examples.md)
# Conteúdo dos dados de eventos publicados pelo Amazon SES no Firehose
O Amazon SES publica registros de evento de envio de e-mail no Amazon Data Firehose no formato JSON. Ao publicar eventos no Firehose, o Amazon SES adiciona no fim de cada registro JSON um caractere de nova linha.
É possível encontrar registros de exemplo para todos esses tipos de notificação em [Exemplos de dados de eventos que o Amazon SES publica no Firehose](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
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
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
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
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
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
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
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
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
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
O objeto JSON que contém informações sobre um evento `send` está sempre vazio.
## Objeto de rejeição
O objeto JSON que contém informações sobre um evento `Reject` tem sempre os seguintes campos.
| Nome do campo | 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
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
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
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
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
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
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
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` |
# Exemplos de dados de eventos que o Amazon SES publica no Firehose
Esta seção fornece exemplos dos tipos de registro de evento de envio de e-mail que o Amazon SES publica no Firehose.
**Topics**
+ [Registro de devolução](#event-publishing-retrieving-firehose-bounce)
+ [Registro de reclamação](#event-publishing-retrieving-firehose-complaint)
+ [Registro de entrega](#event-publishing-retrieving-firehose-delivery)
+ [Registro de envio](#event-publishing-retrieving-firehose-send)
+ [Registro de rejeição](#event-publishing-retrieving-firehose-reject)
+ [Registro de abertura](#event-publishing-retrieving-firehose-open)
+ [Registro de clique](#event-publishing-retrieving-firehose-click)
+ [Registro de falha de renderização](#event-publishing-retrieving-firehose-failure)
+ [DeliveryDelay registro](#event-publishing-retrieving-firehose-delayed-delivery)
+ [Registro Assinatura](#event-publishing-retrieving-firehose-subscription)
**nota**
Quando um campo `tag` for utilizado nos exemplos a seguir, ele estará usando a publicação de eventos por meio de um conjunto de configurações para o qual o SES oferece suporte à publicação de etiquetas para todos os tipos de evento. Se estiver usando notificações de feedback diretamente na identidade, o SES não publicará etiquetas. Leia sobre como adicionar etiquetas ao [criar um conjunto de configurações](creating-configuration-sets.md) ou [modificar um conjunto de configurações](managing-configuration-sets.md#console-detail-configuration-sets).
## Registro de devolução
Veja a seguir um exemplo de registro de evento `Bounce` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType":"Bounce",
3. "bounce":{
4. "bounceType":"Permanent",
5. "bounceSubType":"General",
6. "bouncedRecipients":[
7. {
8. "emailAddress":"recipient@example.com",
9. "action":"failed",
10. "status":"5.1.1",
11. "diagnosticCode":"smtp; 550 5.1.1 user unknown"
12. }
13. ],
14. "timestamp":"2017-08-05T00:41:02.669Z",
15. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
16. "reportingMTA":"dsn; mta.example.com"
17. },
18. "mail":{
19. "timestamp":"2017-08-05T00:40:02.012Z",
20. "source":"Sender Name ",
21. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
22. "sendingAccountId":"123456789012",
23. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
24. "destination":[
25. "recipient@example.com"
26. ],
27. "headersTruncated":false,
28. "headers":[
29. {
30. "name":"From",
31. "value":"Sender Name "
32. },
33. {
34. "name":"To",
35. "value":"recipient@example.com"
36. },
37. {
38. "name":"Subject",
39. "value":"Message sent from Amazon SES"
40. },
41. {
42. "name":"MIME-Version",
43. "value":"1.0"
44. },
45. {
46. "name":"Content-Type",
47. "value":"multipart/alternative; boundary=\"----=_Part_7307378_1629847660.1516840721503\""
48. }
49. ],
50. "commonHeaders":{
51. "from":[
52. "Sender Name "
53. ],
54. "to":[
55. "recipient@example.com"
56. ],
57. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
58. "subject":"Message sent from Amazon SES"
59. },
60. "tags":{
61. "ses:configuration-set":[
62. "ConfigSet"
63. ],
64. "ses:source-ip":[
65. "192.0.2.0"
66. ],
67. "ses:from-domain":[
68. "example.com"
69. ],
70. "ses:caller-identity":[
71. "ses_user"
72. ]
73. }
74. }
75. }
```
## Registro de reclamação
Veja a seguir um exemplo de registro de evento `Complaint` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType":"Complaint",
3. "complaint": {
4. "complainedRecipients":[
5. {
6. "emailAddress":"recipient@example.com"
7. }
8. ],
9. "timestamp":"2017-08-05T00:41:02.669Z",
10. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
11. "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36",
12. "complaintFeedbackType":"abuse",
13. "arrivalDate":"2017-08-05T00:41:02.669Z"
14. },
15. "mail":{
16. "timestamp":"2017-08-05T00:40:01.123Z",
17. "source":"Sender Name ",
18. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
19. "sendingAccountId":"123456789012",
20. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
21. "destination":[
22. "recipient@example.com"
23. ],
24. "headersTruncated":false,
25. "headers":[
26. {
27. "name":"From",
28. "value":"Sender Name "
29. },
30. {
31. "name":"To",
32. "value":"recipient@example.com"
33. },
34. {
35. "name":"Subject",
36. "value":"Message sent from Amazon SES"
37. },
38. {
39. "name":"MIME-Version","value":"1.0"
40. },
41. {
42. "name":"Content-Type",
43. "value":"multipart/alternative; boundary=\"----=_Part_7298998_679725522.1516840859643\""
44. }
45. ],
46. "commonHeaders":{
47. "from":[
48. "Sender Name "
49. ],
50. "to":[
51. "recipient@example.com"
52. ],
53. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
54. "subject":"Message sent from Amazon SES"
55. },
56. "tags":{
57. "ses:configuration-set":[
58. "ConfigSet"
59. ],
60. "ses:source-ip":[
61. "192.0.2.0"
62. ],
63. "ses:from-domain":[
64. "example.com"
65. ],
66. "ses:caller-identity":[
67. "ses_user"
68. ]
69. }
70. }
71. }
```
## Registro de entrega
Veja a seguir um exemplo de registro de evento `Delivery` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType": "Delivery",
3. "mail": {
4. "timestamp": "2016-10-19T23:20:52.240Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "text/html; charset=UTF-8"
33. },
34. {
35. "name": "Content-Transfer-Encoding",
36. "value": "7bit"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "ses:outgoing-ip": [
63. "192.0.2.0"
64. ],
65. "myCustomTag1": [
66. "myCustomTagValue1"
67. ],
68. "myCustomTag2": [
69. "myCustomTagValue2"
70. ]
71. }
72. },
73. "delivery": {
74. "timestamp": "2016-10-19T23:21:04.133Z",
75. "processingTimeMillis": 11893,
76. "recipients": [
77. "recipient@example.com"
78. ],
79. "smtpResponse": "250 2.6.0 Message received",
80. "remoteMtaIp": "123.456.789.012",
81. "reportingMTA": "mta.example.com"
82. }
83. }
```
## Registro de envio
Veja a seguir um exemplo de registro de evento `Send` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType": "Send",
3. "mail": {
4. "timestamp": "2016-10-14T05:02:16.645Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"----=_Part_0_716996660.1476421336341\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "send": {}
71. }
```
## Registro de rejeição
Veja a seguir um exemplo de registro de evento `Reject` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType": "Reject",
3. "mail": {
4. "timestamp": "2016-10-14T17:38:15.211Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "sender@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"qMm9M+Fa2AknHoGS\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "reject": {
71. "reason": "Bad content"
72. }
73. }
```
## Registro de abertura
Veja a seguir um exemplo de registro de evento `Open` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType": "Open",
3. "mail": {
4. "commonHeaders": {
5. "from": [
6. "sender@example.com"
7. ],
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "subject": "Message sent from Amazon SES",
10. "to": [
11. "recipient@example.com"
12. ]
13. },
14. "destination": [
15. "recipient@example.com"
16. ],
17. "headers": [
18. {
19. "name": "X-SES-CONFIGURATION-SET",
20. "value": "ConfigSet"
21. },
22. {
23. "name":"X-SES-MESSAGE-TAGS",
24. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
25. },
26. {
27. "name": "From",
28. "value": "sender@example.com"
29. },
30. {
31. "name": "To",
32. "value": "recipient@example.com"
33. },
34. {
35. "name": "Subject",
36. "value": "Message sent from Amazon SES"
37. },
38. {
39. "name": "MIME-Version",
40. "value": "1.0"
41. },
42. {
43. "name": "Content-Type",
44. "value": "multipart/alternative; boundary=\"XBoundary\""
45. }
46. ],
47. "headersTruncated": false,
48. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
49. "sendingAccountId": "123456789012",
50. "source": "sender@example.com",
51. "tags": {
52. "myCustomTag1":[
53. "myCustomValue1"
54. ],
55. "myCustomTag2":[
56. "myCustomValue2"
57. ],
58. "ses:caller-identity": [
59. "IAM_user_or_role_name"
60. ],
61. "ses:configuration-set": [
62. "ConfigSet"
63. ],
64. "ses:from-domain": [
65. "example.com"
66. ],
67. "ses:source-ip": [
68. "192.0.2.0"
69. ]
70. },
71. "timestamp": "2017-08-09T21:59:49.927Z"
72. },
73. "open": {
74. "ipAddress": "192.0.2.1",
75. "timestamp": "2017-08-09T22:00:19.652Z",
76. "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60"
77. }
78. }
```
## Registro de clique
Veja a seguir um exemplo de registro de evento `Click` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType": "Click",
3. "click": {
4. "ipAddress": "192.0.2.1",
5. "link": "http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html",
6. "linkTags": {
7. "samplekey0": [
8. "samplevalue0"
9. ],
10. "samplekey1": [
11. "samplevalue1"
12. ]
13. },
14. "timestamp": "2017-08-09T23:51:25.570Z",
15. "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36"
16. },
17. "mail": {
18. "commonHeaders": {
19. "from": [
20. "sender@example.com"
21. ],
22. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
23. "subject": "Message sent from Amazon SES",
24. "to": [
25. "recipient@example.com"
26. ]
27. },
28. "destination": [
29. "recipient@example.com"
30. ],
31. "headers": [
32. {
33. "name": "X-SES-CONFIGURATION-SET",
34. "value": "ConfigSet"
35. },
36. {
37. "name":"X-SES-MESSAGE-TAGS",
38. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
39. },
40. {
41. "name": "From",
42. "value": "sender@example.com"
43. },
44. {
45. "name": "To",
46. "value": "recipient@example.com"
47. },
48. {
49. "name": "Subject",
50. "value": "Message sent from Amazon SES"
51. },
52. {
53. "name": "MIME-Version",
54. "value": "1.0"
55. },
56. {
57. "name": "Content-Type",
58. "value": "multipart/alternative; boundary=\"XBoundary\""
59. },
60. {
61. "name": "Message-ID",
62. "value": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000"
63. }
64. ],
65. "headersTruncated": false,
66. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
67. "sendingAccountId": "123456789012",
68. "source": "sender@example.com",
69. "tags": {
70. "myCustomTag1":[
71. "myCustomValue1"
72. ],
73. "myCustomTag2":[
74. "myCustomValue2"
75. ],
76. "ses:caller-identity": [
77. "ses_user"
78. ],
79. "ses:configuration-set": [
80. "ConfigSet"
81. ],
82. "ses:from-domain": [
83. "example.com"
84. ],
85. "ses:source-ip": [
86. "192.0.2.0"
87. ]
88. },
89. "timestamp": "2017-08-09T23:50:05.795Z"
90. }
91. }
```
## Registro de falha de renderização
Veja a seguir um exemplo de registro de evento `Rendering Failure` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType":"Rendering Failure",
3. "mail":{
4. "timestamp":"2018-01-22T18:43:06.197Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "failure":{
20. "errorMessage":"Attribute 'attributeName' is not present in the rendering data.",
21. "templateName":"MyTemplate"
22. }
23. }
```
## DeliveryDelay registro
Veja a seguir um exemplo de registro de evento `DeliveryDelay` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType": "DeliveryDelay",
3. "mail":{
4. "timestamp":"2020-06-16T00:15:40.641Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "deliveryDelay": {
20. "timestamp": "2020-06-16T00:25:40.095Z",
21. "delayType": "TransientCommunicationFailure",
22. "expirationTime": "2020-06-16T00:25:40.914Z",
23. "delayedRecipients": [{
24. "emailAddress": "recipient@example.com",
25. "status": "4.4.1",
26. "diagnosticCode": "smtp; 421 4.4.1 Unable to connect to remote host"
27. }]
28. }
29. }
```
## Registro Assinatura
Veja a seguir um exemplo de registro de evento `Subscription` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType": "Subscription",
3. "mail": {
4. "timestamp": "2022-01-12T01:00:14.340Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
9. "destination": ["recipient@example.com"],
10. "headersTruncated": false,
11. "headers": [
12. {
13. "name": "From",
14. "value": "sender@example.com"
15. },
16. {
17. "name": "To",
18. "value": "recipient@example.com"
19. },
20. {
21. "name": "Subject",
22. "value": "Message sent from Amazon SES"
23. },
24. {
25. "name": "MIME-Version",
26. "value": "1.0"
27. },
28. {
29. "name": "Content-Type",
30. "value": "text/html; charset=UTF-8"
31. },
32. {
33. "name": "Content-Transfer-Encoding",
34. "value": "7bit"
35. }
36. ],
37. "commonHeaders": {
38. "from": ["sender@example.com"],
39. "to": ["recipient@example.com"],
40. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
41. "subject": "Message sent from Amazon SES"
42. },
43. "tags": {
44. "ses:operation": ["SendEmail"],
45. "ses:configuration-set": ["ConfigSet"],
46. "ses:source-ip": ["192.0.2.0"],
47. "ses:from-domain": ["example.com"],
48. "ses:caller-identity": ["ses_user"],
49. "myCustomTag1": ["myCustomValue1"],
50. "myCustomTag2": ["myCustomValue2"]
51. }
52. },
53. "subscription": {
54. "contactList": "ContactListName",
55. "timestamp": "2022-01-12T01:00:17.910Z",
56. "source": "UnsubscribeHeader",
57. "newTopicPreferences": {
58. "unsubscribeAll": true,
59. "topicSubscriptionStatus": [
60. {
61. "topicName": "ExampleTopicName",
62. "subscriptionStatus": "OptOut"
63. }
64. ]
65. },
66. "oldTopicPreferences": {
67. "unsubscribeAll": false,
68. "topicSubscriptionStatus": [
69. {
70. "topicName": "ExampleTopicName",
71. "subscriptionStatus": "OptOut"
72. }
73. ]
74. }
75. }
76. }
```
# Interpretação de dados de evento do Amazon SES pelo Amazon SNS
O Amazon SES publica eventos de envio de e-mail no Amazon Simple Notification Service (Amazon SNS) como registros JSON. O Amazon SNS, então, entrega notificações aos endpoints inscritos no tópico do Amazon SNS associado ao evento de destino. Para obter informações sobre a configuração de tópicos e assinaturas no Amazon SNS, consulte [Conceitos básicos do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.
Para obter uma descrição do conteúdo do registro para registros de exemplo, consulte as seções a seguir.
+ [Conteúdo de registo de evento](event-publishing-retrieving-sns-contents.md)
+ [Exemplos de registro de evento](event-publishing-retrieving-sns-examples.md)
# Conteúdo dos dados de eventos publicados pelo Amazon SES no Amazon SNS
O Amazon SES publica registros de evento de envio de e-mail no Amazon Simple Notification Service no formato JSON.
É possível encontrar registros de exemplo para todos esses tipos de notificação em [Exemplos de dados de eventos publicados pelo Amazon SES no Amazon SNS](event-publishing-retrieving-sns-examples.md).
**Topics**
+ [Objeto JSON de nível superior](#event-publishing-retrieving-sns-contents-top-level-json-object)
+ [Objeto de e-mail](#event-publishing-retrieving-sns-contents-mail-object)
+ [Objeto de devolução](#event-publishing-retrieving-sns-contents-bounce-object)
+ [Objeto de reclamação](#event-publishing-retrieving-sns-contents-complaint-object)
+ [Objeto de entrega](#event-publishing-retrieving-sns-contents-delivery-object)
+ [Objeto de envio](#event-publishing-retrieving-sns-contents-send-object)
+ [Objeto de rejeição](#event-publishing-retrieving-sns-contents-reject-object)
+ [Objeto de abertura](#event-publishing-retrieving-sns-contents-open-object)
+ [Objeto de clique](#event-publishing-retrieving-sns-contents-click-object)
+ [Objeto de falha de renderização](#event-publishing-retrieving-sns-contents-failure-object)
+ [DeliveryDelay objeto](#event-publishing-retrieving-sns-contents-delivery-delay-object)
+ [Objeto Assinatura](#event-publishing-retrieving-sns-contents-subscription-object)
## Objeto JSON de nível superior
O objeto JSON de nível superior em um registro de evento de envio de e-mail contém os campos a seguir. O tipo de evento determina quais outros objetos estão presentes.
| 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
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
O objeto JSON que contém informações sobre um evento `Bounce` tem 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
Um evento de devolução pode pertencer a um único destinatário ou a vários destinatários. O campo `bouncedRecipients` possui uma lista de objetos — um objeto por destinatário cujo endereço de e-mail produziu uma devolução — e contém 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). |
### Tipos de devolução
Cada evento de devolução é de um dos tipos mostrados na tabela a seguir.
O sistema de publicação de eventos publica apenas devoluções definitivas e devoluções flexíveis que o Amazon SES não vai mais tentar 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
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
O campo `complainedRecipients` contém uma lista de destinatários que podem ter enviado a reclamação.
**Importante**
A maioria ISPs redige os endereços de e-mail dos destinatários que enviam reclamações. Por isto, o campo `complainedRecipients` inclui uma lista de todos aqueles que recebeu o e-mail cujo endereço está no domínio que emitiu a notificação de reclamação.
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
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. |
### Subtipos de reclamação
O valor do campo `complaintSubType` pode ser nulo ou `OnAccountSuppressionList`. Se o valor for `OnAccountSuppressionList`, o Amazon 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).
## Objeto de entrega
O objeto JSON que contém informações sobre um evento `Delivery` tem 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
O objeto JSON que contém informações sobre um evento `send` está sempre vazio.
## Objeto de rejeição
O objeto JSON que contém informações sobre um evento `Reject` tem 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
O objeto JSON que contém informações sobre um evento `Open` tem 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
O objeto JSON que contém informações sobre um evento `Click` tem 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
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
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-sns-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
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
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
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` |
# Exemplos de dados de eventos publicados pelo Amazon SES no Amazon SNS
Esta seção fornece exemplos dos tipos de registro de evento de envio de e-mail que o Amazon SES publica no Amazon SNS.
**Topics**
+ [Registro de devolução](#event-publishing-retrieving-sns-bounce)
+ [Registro de reclamação](#event-publishing-retrieving-sns-complaint)
+ [Registro de entrega](#event-publishing-retrieving-sns-delivery)
+ [Registro de envio](#event-publishing-retrieving-sns-send)
+ [Registro de rejeição](#event-publishing-retrieving-sns-reject)
+ [Registro de abertura](#event-publishing-retrieving-sns-open)
+ [Registro de clique](#event-publishing-retrieving-sns-click)
+ [Registro de falha de renderização](#event-publishing-retrieving-sns-failure)
+ [DeliveryDelay registro](#event-publishing-retrieving-sns-delayed-delivery)
+ [Registro Assinatura](#event-publishing-retrieving-sns-subscription)
**nota**
Quando um campo `tag` for utilizado nos exemplos a seguir, ele estará usando a publicação de eventos por meio de um conjunto de configurações para o qual o SES oferece suporte à publicação de etiquetas para todos os tipos de evento. Se estiver usando notificações de feedback diretamente na identidade, o SES não publicará etiquetas. Leia sobre como adicionar etiquetas ao [criar um conjunto de configurações](creating-configuration-sets.md) ou [modificar um conjunto de configurações](managing-configuration-sets.md#console-detail-configuration-sets).
## Registro de devolução
A seguir encontra-se um exemplo de um registro de evento `Bounce` que o Amazon SES publica no Amazon SNS.
```
1. {
2. "eventType":"Bounce",
3. "bounce":{
4. "bounceType":"Permanent",
5. "bounceSubType":"General",
6. "bouncedRecipients":[
7. {
8. "emailAddress":"recipient@example.com",
9. "action":"failed",
10. "status":"5.1.1",
11. "diagnosticCode":"smtp; 550 5.1.1 user unknown"
12. }
13. ],
14. "timestamp":"2017-08-05T00:41:02.669Z",
15. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
16. "reportingMTA":"dsn; mta.example.com"
17. },
18. "mail":{
19. "timestamp":"2017-08-05T00:40:02.012Z",
20. "source":"Sender Name ",
21. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
22. "sendingAccountId":"123456789012",
23. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
24. "destination":[
25. "recipient@example.com"
26. ],
27. "headersTruncated":false,
28. "headers":[
29. {
30. "name":"From",
31. "value":"Sender Name "
32. },
33. {
34. "name":"To",
35. "value":"recipient@example.com"
36. },
37. {
38. "name":"Subject",
39. "value":"Message sent from Amazon SES"
40. },
41. {
42. "name":"MIME-Version",
43. "value":"1.0"
44. },
45. {
46. "name":"Content-Type",
47. "value":"multipart/alternative; boundary=\"----=_Part_7307378_1629847660.1516840721503\""
48. }
49. ],
50. "commonHeaders":{
51. "from":[
52. "Sender Name "
53. ],
54. "to":[
55. "recipient@example.com"
56. ],
57. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
58. "subject":"Message sent from Amazon SES"
59. },
60. "tags":{
61. "ses:configuration-set":[
62. "ConfigSet"
63. ],
64. "ses:source-ip":[
65. "192.0.2.0"
66. ],
67. "ses:from-domain":[
68. "example.com"
69. ],
70. "ses:caller-identity":[
71. "ses_user"
72. ]
73. }
74. }
75. }
```
## Registro de reclamação
A seguir encontra-se um exemplo de um registro de evento `Complaint` que o Amazon SES publica no Amazon SNS.
```
1. {
2. "eventType":"Complaint",
3. "complaint": {
4. "complainedRecipients":[
5. {
6. "emailAddress":"recipient@example.com"
7. }
8. ],
9. "timestamp":"2017-08-05T00:41:02.669Z",
10. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
11. "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36",
12. "complaintFeedbackType":"abuse",
13. "arrivalDate":"2017-08-05T00:41:02.669Z"
14. },
15. "mail":{
16. "timestamp":"2017-08-05T00:40:01.123Z",
17. "source":"Sender Name ",
18. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
19. "sendingAccountId":"123456789012",
20. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
21. "destination":[
22. "recipient@example.com"
23. ],
24. "headersTruncated":false,
25. "headers":[
26. {
27. "name":"From",
28. "value":"Sender Name "
29. },
30. {
31. "name":"To",
32. "value":"recipient@example.com"
33. },
34. {
35. "name":"Subject",
36. "value":"Message sent from Amazon SES"
37. },
38. {
39. "name":"MIME-Version","value":"1.0"
40. },
41. {
42. "name":"Content-Type",
43. "value":"multipart/alternative; boundary=\"----=_Part_7298998_679725522.1516840859643\""
44. }
45. ],
46. "commonHeaders":{
47. "from":[
48. "Sender Name "
49. ],
50. "to":[
51. "recipient@example.com"
52. ],
53. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
54. "subject":"Message sent from Amazon SES"
55. },
56. "tags":{
57. "ses:configuration-set":[
58. "ConfigSet"
59. ],
60. "ses:source-ip":[
61. "192.0.2.0"
62. ],
63. "ses:from-domain":[
64. "example.com"
65. ],
66. "ses:caller-identity":[
67. "ses_user"
68. ]
69. }
70. }
71. }
```
## Registro de entrega
A seguir encontra-se um exemplo de um registro de evento `Delivery` que o Amazon SES publica no Amazon SNS.
```
1. {
2. "eventType": "Delivery",
3. "mail": {
4. "timestamp": "2016-10-19T23:20:52.240Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "text/html; charset=UTF-8"
33. },
34. {
35. "name": "Content-Transfer-Encoding",
36. "value": "7bit"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "ses:outgoing-ip": [
63. "192.0.2.0"
64. ],
65. "myCustomTag1": [
66. "myCustomTagValue1"
67. ],
68. "myCustomTag2": [
69. "myCustomTagValue2"
70. ]
71. }
72. },
73. "delivery": {
74. "timestamp": "2016-10-19T23:21:04.133Z",
75. "processingTimeMillis": 11893,
76. "recipients": [
77. "recipient@example.com"
78. ],
79. "smtpResponse": "250 2.6.0 Message received",
80. "remoteMtaIp": "123.456.789.012",
81. "reportingMTA": "mta.example.com"
82. }
83. }
```
## Registro de envio
A seguir encontra-se um exemplo de um registro de evento `Send` que o Amazon SES publica no Amazon SNS. Alguns campos nem sempre estão presentes. Por exemplo, com um e-mail com modelo, o assunto é renderizado posteriormente e incluído em eventos subsequentes.
```
1. {
2. "eventType": "Send",
3. "mail": {
4. "timestamp": "2016-10-14T05:02:16.645Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"----=_Part_0_716996660.1476421336341\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "send": {}
71. }
```
## Registro de rejeição
A seguir encontra-se um exemplo de um registro de evento `Reject` que o Amazon SES publica no Amazon SNS.
```
1. {
2. "eventType": "Reject",
3. "mail": {
4. "timestamp": "2016-10-14T17:38:15.211Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "sender@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"qMm9M+Fa2AknHoGS\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "reject": {
71. "reason": "Bad content"
72. }
73. }
```
## Registro de abertura
A seguir encontra-se um exemplo de um registro de evento `Open` que o Amazon SES publica no Amazon SNS.
```
1. {
2. "eventType": "Open",
3. "mail": {
4. "commonHeaders": {
5. "from": [
6. "sender@example.com"
7. ],
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "subject": "Message sent from Amazon SES",
10. "to": [
11. "recipient@example.com"
12. ]
13. },
14. "destination": [
15. "recipient@example.com"
16. ],
17. "headers": [
18. {
19. "name": "X-SES-CONFIGURATION-SET",
20. "value": "ConfigSet"
21. },
22. {
23. "name":"X-SES-MESSAGE-TAGS",
24. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
25. },
26. {
27. "name": "From",
28. "value": "sender@example.com"
29. },
30. {
31. "name": "To",
32. "value": "recipient@example.com"
33. },
34. {
35. "name": "Subject",
36. "value": "Message sent from Amazon SES"
37. },
38. {
39. "name": "MIME-Version",
40. "value": "1.0"
41. },
42. {
43. "name": "Content-Type",
44. "value": "multipart/alternative; boundary=\"XBoundary\""
45. }
46. ],
47. "headersTruncated": false,
48. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
49. "sendingAccountId": "123456789012",
50. "source": "sender@example.com",
51. "tags": {
52. "myCustomTag1":[
53. "myCustomValue1"
54. ],
55. "myCustomTag2":[
56. "myCustomValue2"
57. ],
58. "ses:caller-identity": [
59. "IAM_user_or_role_name"
60. ],
61. "ses:configuration-set": [
62. "ConfigSet"
63. ],
64. "ses:from-domain": [
65. "example.com"
66. ],
67. "ses:source-ip": [
68. "192.0.2.0"
69. ]
70. },
71. "timestamp": "2017-08-09T21:59:49.927Z"
72. },
73. "open": {
74. "ipAddress": "192.0.2.1",
75. "timestamp": "2017-08-09T22:00:19.652Z",
76. "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60"
77. }
78. }
```
## Registro de clique
A seguir encontra-se um exemplo de um registro de evento `Click` que o Amazon SES publica no Amazon SNS.
```
1. {
2. "eventType": "Click",
3. "click": {
4. "ipAddress": "192.0.2.1",
5. "link": "http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html",
6. "linkTags": {
7. "samplekey0": [
8. "samplevalue0"
9. ],
10. "samplekey1": [
11. "samplevalue1"
12. ]
13. },
14. "timestamp": "2017-08-09T23:51:25.570Z",
15. "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36"
16. },
17. "mail": {
18. "commonHeaders": {
19. "from": [
20. "sender@example.com"
21. ],
22. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
23. "subject": "Message sent from Amazon SES",
24. "to": [
25. "recipient@example.com"
26. ]
27. },
28. "destination": [
29. "recipient@example.com"
30. ],
31. "headers": [
32. {
33. "name": "X-SES-CONFIGURATION-SET",
34. "value": "ConfigSet"
35. },
36. {
37. "name":"X-SES-MESSAGE-TAGS",
38. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
39. },
40. {
41. "name": "From",
42. "value": "sender@example.com"
43. },
44. {
45. "name": "To",
46. "value": "recipient@example.com"
47. },
48. {
49. "name": "Subject",
50. "value": "Message sent from Amazon SES"
51. },
52. {
53. "name": "MIME-Version",
54. "value": "1.0"
55. },
56. {
57. "name": "Content-Type",
58. "value": "multipart/alternative; boundary=\"XBoundary\""
59. },
60. {
61. "name": "Message-ID",
62. "value": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000"
63. }
64. ],
65. "headersTruncated": false,
66. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
67. "sendingAccountId": "123456789012",
68. "source": "sender@example.com",
69. "tags": {
70. "myCustomTag1":[
71. "myCustomValue1"
72. ],
73. "myCustomTag2":[
74. "myCustomValue2"
75. ],
76. "ses:caller-identity": [
77. "ses_user"
78. ],
79. "ses:configuration-set": [
80. "ConfigSet"
81. ],
82. "ses:from-domain": [
83. "example.com"
84. ],
85. "ses:source-ip": [
86. "192.0.2.0"
87. ]
88. },
89. "timestamp": "2017-08-09T23:50:05.795Z"
90. }
91. }
```
## Registro de falha de renderização
A seguir encontra-se um exemplo de um registro de evento `Rendering Failure` que o Amazon SES publica no Amazon SNS.
```
1. {
2. "eventType":"Rendering Failure",
3. "mail":{
4. "timestamp":"2018-01-22T18:43:06.197Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "failure":{
20. "errorMessage":"Attribute 'attributeName' is not present in the rendering data.",
21. "templateName":"MyTemplate"
22. }
23. }
```
## DeliveryDelay registro
A seguir encontra-se um exemplo de um registro de evento `DeliveryDelay` que o Amazon SES publica no Amazon SNS.
```
1. {
2. "eventType": "DeliveryDelay",
3. "mail":{
4. "timestamp":"2020-06-16T00:15:40.641Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "deliveryDelay": {
20. "timestamp": "2020-06-16T00:25:40.095Z",
21. "delayType": "TransientCommunicationFailure",
22. "expirationTime": "2020-06-16T00:25:40.914Z",
23. "delayedRecipients": [{
24. "emailAddress": "recipient@example.com",
25. "status": "4.4.1",
26. "diagnosticCode": "smtp; 421 4.4.1 Unable to connect to remote host"
27. }]
28. }
29. }
```
## Registro Assinatura
Veja a seguir um exemplo de registro de evento `Subscription` que o Amazon SES publica no Firehose.
```
1. {
2. "eventType": "Subscription",
3. "mail": {
4. "timestamp": "2022-01-12T01:00:14.340Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
9. "destination": ["recipient@example.com"],
10. "headersTruncated": false,
11. "headers": [
12. {
13. "name": "From",
14. "value": "sender@example.com"
15. },
16. {
17. "name": "To",
18. "value": "recipient@example.com"
19. },
20. {
21. "name": "Subject",
22. "value": "Message sent from Amazon SES"
23. },
24. {
25. "name": "MIME-Version",
26. "value": "1.0"
27. },
28. {
29. "name": "Content-Type",
30. "value": "text/html; charset=UTF-8"
31. },
32. {
33. "name": "Content-Transfer-Encoding",
34. "value": "7bit"
35. }
36. ],
37. "commonHeaders": {
38. "from": ["sender@example.com"],
39. "to": ["recipient@example.com"],
40. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
41. "subject": "Message sent from Amazon SES"
42. },
43. "tags": {
44. "ses:operation": ["SendEmail"],
45. "ses:configuration-set": ["ConfigSet"],
46. "ses:source-ip": ["192.0.2.0"],
47. "ses:from-domain": ["example.com"],
48. "ses:caller-identity": ["ses_user"],
49. "myCustomTag1": ["myCustomValue1"],
50. "myCustomTag2": ["myCustomValue2"]
51. }
52. },
53. "subscription": {
54. "contactList": "ContactListName",
55. "timestamp": "2022-01-12T01:00:17.910Z",
56. "source": "UnsubscribeHeader",
57. "newTopicPreferences": {
58. "unsubscribeAll": true,
59. "topicSubscriptionStatus": [
60. {
61. "topicName": "ExampleTopicName",
62. "subscriptionStatus": "OptOut"
63. }
64. ]
65. },
66. "oldTopicPreferences": {
67. "unsubscribeAll": false,
68. "topicSubscriptionStatus": [
69. {
70. "topicName": "ExampleTopicName",
71. "subscriptionStatus": "OptOut"
72. }
73. ]
74. }
75. }
76. }
```