Configuração de notificações do Amazon SNS para o Amazon SES - Amazon Simple Email Service

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configuração de notificações do Amazon SNS para o Amazon SES

O Amazon SES pode notificar você sobre devoluções, reclamações e entregas por meio do Amazon Simple Notification Service (Amazon SNS).

Você pode configurar notificações no console do Amazon SES ou usando a API do Amazon SES.

Pré-requisitos

Conclua as etapas a seguir antes de configurar notificações do Amazon SNS no Amazon SES:

  1. Crie um tópico do Amazon SNS. Para obter mais informações, consulte Criar um tópico no Guia do desenvolvedor do Amazon Simple Notification Service.

    Importante

    Quando você criar seu tópico usando o Amazon SNS, em Type (Tipo), escolha apenas Standard (Padrão). (O SES não suporta tópicos do tipo FIFO.)

    Independentemente de criar um novo tópico do SNS ou selecionar um existente, será necessário conceder acesso ao SES para publicar notificações no tópico.

    Para conceder permissão ao Amazon SES para publicar notificações no tópico, na tela Edit topic (Editar tópico) no console do SNS, expanda Access policy (Política de acesso) e, em JSON editor (Editor de JSON), adicione a seguinte política de permissão:

    { "Version": "2012-10-17", "Id": "notification-policy", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "sns:Publish", "Resource": "arn:aws:sns:topic_region:111122223333:topic_name", "Condition": { "StringEquals": { "AWS:SourceAccount": "111122223333", "AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:identity/identity_name" } } } ] }

    Faça as seguintes alterações no exemplo de política anterior:

    • Substitua topic_region pela região da AWS em que você criou o tópico do SNS.

    • Substitua 111122223333 pelo ID de sua conta da AWS.

    • Substitua topic_name pelo nome do tópico do SNS.

    • Substitua identity_name pela identidade verificada (endereço de e-mail ou domínio) que você está inscrevendo no tópico do SNS.

  2. Inscreva pelo menos um endpoint para o tópico. Por exemplo, se quiser receber notificações por mensagem de texto, assine um endpoint de SMS, (ou seja, um número de telefone celular) para o tópico. Para receber notificações por e-mail, inscreva um endpoint de e-mail (um endereço de e-mail) para o tópico.

    Para obter mais informações, consulte Conceitos básicos no Guia do desenvolvedor do Amazon Simple Notification Service.

  3. (Opcional) Se o tópico do Amazon SNS usar o AWS Key Management Service (AWS KMS) para criptografia do lado do servidor, será necessário adicionar permissões à política de chaves do AWS KMS. É possível adicionar permissões anexando a seguinte política à política de chaves do AWS KMS:

    { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESToUseKMSKey", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] }

Configuração de notificações usando o console do Amazon SES

Para configurar notificações usando o console do Amazon SES
  1. Faça login no Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação, em Configuration (Configuração), escolha Verified identities (Identidades verificadas).

  3. No contêiner Identities (Identidades), selecione a identidade verificada para a qual você deseja receber notificações de feedback quando uma mensagem enviada dessa identidade resultar em devolução, reclamação ou entrega.

    Importante

    As configurações de notificação de domínio verificado aplicam-se a todos os e-mails enviados nesse domínio, exceto para endereços de e-mail que estão também verificados.

  4. Na tela de detalhes da identidade verificada selecionada, escolha a guia Notifications (Notificações) e selecione Edit (Editar) no contêiner Feedback notifications (Notificações de feedback).

  5. Expanda a caixa de listagem de tópicos do SNS de cada tipo de feedback para o qual deseja receber notificações e selecione um tópico do SNS que você possui, No SNS topic (Nenhum tópico do SNS) ouSNS topic you don’t own (Tópico do SNS que você não possui).

    1. Ao escolher SNS topic you don’t own (Tópico do SNS que você não possui), o campo SNS topic ARN (ARN do tópico do SNS) será apresentado, onde deverá ser inserido o tópico do SNS que o ARN compartilhou com você pelo remetente delegado. (Somente o remetente delegado receberá essas notificações, pois ele possui o tópico do SNS. Para saber mais sobre envios delegados, consulte Visão geral da autorização de envio.)

    Importante

    Os tópicos do Amazon SNS que você usa para notificações de devolução, reclamação e entrega devem estar na mesma região da Região da AWS na qual você usa o Amazon SES.

    Além disso, é necessário inscrever um ou mais endpoints no tópico para receber notificações. Por exemplo, se você deseja que as notificações sejam enviadas para um endereço de e-mail, é necessário inscrever um endpoint de e-mail no tópico. Para obter mais informações, consulte Conceitos básicos no Guia do desenvolvedor do Amazon Simple Notification Service.

  6. (Opcional) Se você quiser que a notificação de tópico inclua os cabeçalhos do e-mail original, marque a caixa Include original email headers (Incluir cabeçalhos de e-mail originais) diretamente abaixo do nome do tópico do SNS de cada tipo de feedback. Essa opção só está disponível se você atribuiu um tópico do Amazon SNS ao tipo de notificação associado. Para obter informações sobre o conteúdo dos cabeçalhos de e-mail originais, consulte o objeto mail em Conteúdo das notificações.

  7. Selecione Save changes. As alterações feitas em suas configurações de notificação podem levar alguns minutos para ter efeito.

  8. (Opcional) Se você escolher notificações de tópicos do Amazon SNS para devoluções e reclamações, poderá desabilitar as notificações de e-mail completamente para não receber notificações duplas por e-mail e notificações do SNS. Para desabilitar notificações de e-mail para devoluções e reclamações, na guia Notifications (Notificações), na tela de detalhes da identidade verificada, no contêiner Email Feedback Forwarding (Encaminhamento de feedback de e-mail), escolha Edit (Editar), desmarque a caixa Enabled (Habilitado) e escolha Save changes (Salvar as alterações).

Após definir as configurações, você começará a receber notificações de devolução, reclamação e/ou entrega para seus tópicos do Amazon SNS. Essas notificações estão no formato JavaScript Object Notation (JSON) e seguem a estrutura descrita em Conteúdo das notificações.

Você será cobrado de acordo com as taxas padrão do Amazon SNS para notificações de devolução, reclamação e entrega. Para obter mais informações, consulte a página de Definição de preços do Amazon SNS.

nota

Se uma tentativa de publicar no seu tópico do Amazon SNS falhar porque o tópico foi excluído ou a Conta da AWS não tem mais permissões para publicar nele, o Amazon SES removerá a configuração desse tópico se ele tiver sido configurado para devoluções ou reclamações (não entregas. Para notificações de entrega, o SES não excluirá a configuração do tópico do SNS). Além disso, o Amazon SES habilitará novamente as notificações por e-mail de devolução e reclamação para a identidade, e você receberá uma notificação da alteração por e-mail. Se várias identidades forem configuradas para usar o tópico, a configuração do tópico para cada identidade será alterada quando cada identidade apresentar uma falha ao publicar no tópico.

Configuração de notificações usando a API do Amazon SES

Você também pode configurar notificações de devolução, reclamação e entrega usando a API do Amazon SES. Para configurar notificações, use as operações a seguir:

Você pode usar essas ações de API para escrever um aplicativo front-end personalizado para notificações. Para obter uma descrição completa das ações de API relacionadas à verificação de domínio, consulte a Referência da API do Amazon Simple Email Service.

Solução de problemas com notificações de feedback

Notificações não estão sendo recebidas

Se você não estiver recebendo notificações, certifique-se de ter inscrito um endpoint no tópico pelo qual as notificações são enviadas. Ao inscrever um endpoint de e-mail em um tópico, você recebe um e-mail solicitando a confirmação da inscrição. É necessário confirmar a inscrição antes de começar a receber notificações por e-mail. Para obter mais informações, consulte Conceitos básicos no Guia do desenvolvedor do Amazon Simple Notification Service.

Erro InvalidParameterValue ao escolher um tópico

Se você receber uma mensagem de erro informando que ocorreu um erro InvalidParameterValue, verifique se o tópico do Amazon SNS está criptografado usando AWS KMS. Se ele estiver, será necessário modificar a política da chave do AWS KMS. Consulte Pré-requisitos para obter um exemplo de política.