Como funciona a supressão em nível de inquilino Precedência de supressão Gravação automática de supressão Identificando os saltos de supressão de inquilinos Gerenciando entradas Considerações e limitações Recursos relacionados

Usando listas de supressão em nível de inquilino no Amazon SES

Se você usa a multilocação do Amazon Simple Email Service (SES) para enviar e-mails em nome de vários inquilinos, você pode dar a cada inquilino sua própria lista de supressão. Tenant-level a supressão isola rejeições e reclamações para que elas afetem somente o inquilino que enviou o e-mail. Sem esse recurso, todos os inquilinos compartilham a lista de supressão no nível da conta. Quando um destinatário devolve ou reclama do e-mail de um inquilino, esse endereço é suprimido para cada inquilino na conta. Tenant-level a supressão evita essa contaminação entre inquilinos, mantendo uma lista separada de endereços suprimidos para cada inquilino.

Como funciona a supressão em nível de inquilino

Duas configurações controlam o comportamento de supressão para cada inquilino: escopo da supressão e motivos suprimidos. Você define as duas configurações em conjunto usando a operação de PutTenantSuppressionAttributes API ou especificando SuppressionAttributes quando você cria um inquilino com a operação de CreateTenant API.

O escopo da supressão determina qual lista de supressão o SES usa para o inquilino:

TENANT— Use a própria lista de supressão do inquilino.
ACCOUNT— Use a lista de supressão no nível da conta. Esse é o padrão para inquilinos existentes e novos.

Os motivos suprimidos determinam quais eventos fazem com que o SES adicione endereços à lista de supressão:

BOUNCE— Adicione endereços que produzam rejeições difíceis.
COMPLAINT— Adicione endereços que gerem reclamações.
BOUNCEe COMPLAINT — Adicione endereços que produzam qualquer um dos eventos.
Vazio — Não verifique nem registre em nenhuma lista de supressão.

nota

Você deve fornecer SuppressionScope e SuppressedReasons em conjunto, ou definir ambos como nulos. Definir ambos como nulos limpa as configurações de supressão do inquilino e retorna o inquilino ao comportamento padrão do escopo. ACCOUNT

Comportamento de supressão por configuração

A tabela a seguir descreve o horário de envio e o comportamento de gravação para cada combinação de escopo de supressão e motivos suprimidos.

Escopo	Motivos	Send-time comportamento	Comportamento de gravação
`TENANT`	`BOUNCE`, `COMPLAINT`	Verifica a lista de inquilinos em busca de devoluções e reclamações	Registra ambos na lista de inquilinos
`TENANT`	`BOUNCE`	Verifica apenas as devoluções na lista de inquilinos	Os registros são retornados somente para a lista de inquilinos
`TENANT`	`COMPLAINT`	Verifica apenas reclamações na lista de inquilinos	Registra reclamações somente na lista de inquilinos
`TENANT`	Vazio	Sem verificação de supressão	Sem gravação
`ACCOUNT`	`BOUNCE`, `COMPLAINT`	Verifica a lista de contas em busca de devoluções e reclamações	Registra ambos na lista de contas
`ACCOUNT`	`BOUNCE`	Verifica a lista de contas somente para devoluções	Os registros são devolvidos somente para a lista de contas
`ACCOUNT`	`COMPLAINT`	Verifica a lista de contas apenas para reclamações	Registra reclamações somente na lista de contas
`ACCOUNT`	Vazio	Sem verificação de supressão	Sem gravação

Precedência de supressão e comportamento no horário de envio

O SES resolve as configurações de supressão na seguinte ordem de precedência, da maior para a menor:

Conjunto de configurações — Se o conjunto de configurações especificar configurações de supressão, o SES usará essas configurações.
Locatário — Se nenhuma substituição do conjunto de configurações existir, o SES usa as configurações de supressão do inquilino.
Conta — Se nem o conjunto de configurações nem o inquilino especificarem as configurações, o SES usará os padrões em nível de conta.

Importante

O escopo da supressão determina qual lista de supressão o SES verifica no momento do envio. Quando o escopo éTENANT, o SES verifica somente a lista de supressão do inquilino e ignora a lista de supressão no nível da conta. Um endereço que está na lista de supressão no nível da conta, mas não na lista de supressão do inquilino, não é suprimido. Quando o escopo éACCOUNT, o SES verifica somente a lista de supressão no nível da conta. O escopo também controla onde as devoluções e reclamações são registradas.

Substituições do conjunto de configurações

O SuppressionOptions para um conjunto de configurações agora inclui um SuppressionScope campo. Você pode usar um conjunto de configurações para substituir somente o escopo, somente os motivos ou ambos de forma independente. Isso proporciona um controle refinado sobre o comportamento de supressão para fluxos de trabalho de envio específicos. Você não precisa alterar as configurações padrão do inquilino.

Gravação automática de supressão

Quando o escopo da supressão éTENANT, o SES registra automaticamente as entradas de supressão da seguinte forma:

Devoluções forçadas — O SES adiciona o endereço à lista de supressão do inquilino e à lista de supressão global. O SES não adiciona o endereço à lista de supressão em nível de conta.
Reclamações — A SES adiciona o endereço somente à lista de supressão do inquilino.
Not-spam feedback — Quando um destinatário marca uma mensagem relatada anteriormente como não sendo spam, o SES remove automaticamente as entradas COMPLAINT -reason da lista de supressão do inquilino.

Identificando os saltos de supressão de inquilinos

Quando o SES suprime uma mensagem porque o endereço está na lista de supressão do inquilino, você pode identificar o evento usando os seguintes indicadores:

Notificação de rejeição — O tipo de rejeição está Permanent com um subtipo de. OnTenantSuppressionList
Virtual Deliverability Manager (VDM) — O motivo da rejeição é. ON_TENANT_SUPPRESSION_LIST
Código de diagnóstico — "Amazon SES did not send the message to this address because it is on the suppression list for your tenant."
Tag de evento — O SES adiciona uma ses:tenant-name tag às notificações de devolução e reclamação para que você possa identificar a qual inquilino o evento pertence.

Gerenciando entradas da lista de supressão de inquilinos

Você gerencia as entradas da lista de supressão de inquilinos usando as mesmas operações de API que você usa para entradas no nível da conta. Para direcionar a lista de supressão de um inquilino, inclua o TenantName parâmetro em sua solicitação:

PutSuppressedDestination— Adicione um endereço à lista de supressão de um inquilino.
GetSuppressedDestination— Recupere detalhes sobre um endereço suprimido de um inquilino.
DeleteSuppressedDestination— Remover um endereço da lista de supressão de um inquilino.
ListSuppressedDestinations— Liste todos os endereços suprimidos de um inquilino.

Se você omitir o TenantName parâmetro, essas operações terão como alvo a lista de supressão no nível da conta. Isso mantém a compatibilidade com versões anteriores das integrações existentes.

Considerações e limitações

Lembre-se do seguinte ao usar listas de supressão em nível de inquilino:

Multi-tenancy obrigatório — Você deve ter a multilocação do SES configurada com pelo menos um inquilino para usar esse recurso.
Uma lista por inquilino — Cada inquilino tem exatamente uma lista de supressão. Há um mapeamento 1:1 entre inquilinos e listas de supressão.
Region-specific— As listas de supressão de inquilinos são específicas para as Região da AWS quais você as configura.
Os endereços persistem — os endereços suprimidos permanecem na lista do inquilino até que você os remova explicitamente ou até que o SES os remova automaticamente (por exemplo, quando um destinatário relata um evento sem spam por uma entrada com um motivo). COMPLAINT
Case-sensitive armazenamento — Os endereços de e-mail na lista de supressão são armazenados com maiúsculas e minúsculas preservadas. As chamadas de API para gerenciamento de listas de supressão exigem uma correspondência exata de casos.
Impacto da cota de envio — As mensagens suprimidas por uma lista de supressão de inquilinos são contabilizadas na sua cota de envio diária.
Dados de reclamação do Gmail — O Gmail não envia dados de reclamação ao SES. Os endereços hospedados pelo Gmail não são adicionados automaticamente à lista de supressão de reclamações.
Restrições do sandbox — Você não pode ligar PutSuppressedDestination até que sua conta tenha acesso à produção.
Limpando configurações — Para limpar as configurações de supressão de um inquilino, chame PutTenantSuppressionAttributes com valores nulos por escopo e motivos.
Excluindo um inquilino — Quando você exclui um inquilino, o SES também exclui todas as entradas da lista de supressão desse inquilino.

Os recursos a seguir podem ajudá-lo a aprender mais sobre as listas de supressão no SES.

Convenções do documento

Usar a lista de supressão no nível da conta

Configurando a supressão em nível de inquilino