> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon SES

> Configure o Amazon SES como provedor de email no Notifuse.

O Notifuse pode enviar emails pelo AWS Simple Email Service (SES).

## Configuração

Vá em **Configurações** → **Integrações**, clique em **Adicionar integração** e escolha **Amazon SES** em **Envio de emails**. O formulário abre em tela cheia.

![Formulário da integração Amazon SES](https://www.notifuse.com/docs/assets/screenshots/ses_form.png)

![Configurações do Amazon SES](https://www.notifuse.com/docs/assets/screenshots/ses_settings.png)

### Campos do formulário

| Campo                        | Descrição                                                                                                                                  | Exemplo                                    |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ |
| **Região**                   | Região da AWS onde estão as suas identidades verificadas                                                                                   | `us-east-1`                                |
| **ID da chave de acesso**    | Chave de acesso de um usuário IAM com permissão para enviar pelo SES                                                                       | `AKIAIOSFODNN7EXAMPLE`                     |
| **Chave de acesso secreta**  | A chave de acesso secreta desse usuário IAM                                                                                                | `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY` |
| **Isolamento de tenant**     | Opcional. Dá a esta integração um perfil de reputação e uma lista de supressão próprios (veja [abaixo](#reputation-isolation-ses-tenants)) | Desativado                                 |
| **Conjunto de configuração** | Opcional, em **Avançado**. Envia por um conjunto de configuração que você gerencia                                                         | `my-config-set`                            |
| **Tenant SES**               | Opcional, em **Avançado**. Envia por um tenant que você gerencia                                                                           | `my-tenant`                                |

### Lista de remetentes

Adicione os endereços de remetente verificados nas configurações do AWS SES:

| Campo     | Descrição                      | Exemplo                  |
| --------- | ------------------------------ | ------------------------ |
| **Nome**  | Nome exibido do remetente      | `Support Team`           |
| **Email** | Endereço de email do remetente | `support@yourdomain.com` |

Os remetentes precisam estar verificados no console do AWS SES antes de você poder usá-los.

### Tipos de uso

Escolha o que esta integração Amazon SES envia no menu **⋯** do card dela em **Configurações** → **Integrações** (**Usar para marketing**, **Usar para transacional**) ou no painel **Envio de emails** da mesma página:

| Opção                      | Descrição                                                | Exemplos                                                     |
| -------------------------- | -------------------------------------------------------- | ------------------------------------------------------------ |
| **Usar para transacional** | Emails gerados pelo sistema a partir de ações do usuário | Redefinição de senha, confirmação de pedido, avisos da conta |
| **Usar para marketing**    | Emails promocionais e newsletters enviados aos inscritos | Anúncios de produto, newsletters, campanhas promocionais     |

Escolha as duas opções para enviar todos os tipos de email pela mesma configuração do SES.

### Webhooks

O Notifuse assina automaticamente os seguintes webhooks do SES:

| Tipo de webhook | Descrição                      | Finalidade                   |
| --------------- | ------------------------------ | ---------------------------- |
| **Entrega**     | Email entregue                 | Acompanhar as entregas       |
| **Retorno**     | Email retornado                | Monitorar os retornos        |
| **Reclamações** | O destinatário denunciou abuso | Tratar as denúncias de abuso |

O Notifuse recebe esses eventos de entrega no momento em que acontecem.

## Isolamento de reputação (tenants do SES)

Por padrão, todos os workspaces de uma conta AWS compartilham uma única reputação de envio e **uma única lista de supressão**. Uma campanha mal segmentada de uma equipe pode levar a taxa de retorno ou de reclamação da conta acima dos limites da AWS e pausar o envio para todos. Um retorno permanente em um workspace também suprime esse destinatário em todos os outros.

O **Isolamento de tenant** dá a uma integração o seu próprio [tenant SES](https://docs.aws.amazon.com/ses/latest/dg/tenants.html), com perfil de reputação, métricas de retorno e de reclamação e lista de supressão próprios. Assim, a AWS pode pausar um único tenant em vez da conta inteira.

> [!NOTE]
>
> **Self-hosted: criar um novo tenant SES exige uma [chave de licença](https://www.notifuse.com/pt/docs/self-hosting/licence.md).** Um tenant já criado continua enviando indefinidamente com a sua própria reputação, mesmo sem chave: o caminho de envio não verifica a licença. O Notifuse Cloud inclui o isolamento por tenant SES a partir do plano Starter ([detalhes](https://www.notifuse.com/pt/docs/self-hosting/licence.md#on-notifuse-cloud)).

### Como ativar

Abra a integração (**Configurações** → **Integrações**), ative **Isolamento de tenant** no painel **Reputação** e salve. Como um tenant é um recurso cobrado pela AWS, o Notifuse pede confirmação e depois cria tudo na sua conta:

| Etapa                                   | O que o Notifuse faz                                                                                          |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Criar o tenant**                      | Cria o tenant `notifuse-<integration ID>` com `SuppressionScope: TENANT` para retornos e reclamações          |
| **Associar o conjunto de configuração** | Vincula o conjunto de configuração pelo qual esta integração envia                                            |
| **Associar as identidades**             | Vincula cada identidade verificada que cobre um remetente: o endereço exato, o domínio dele ou um domínio pai |

Salvar de novo executa as mesmas etapas. É assim que um remetente adicionado depois é associado e que uma execução parcial é refeita.

> [!NOTE]
>
> **A supressão por tenant não é o padrão da AWS.** Um tenant criado à mão no console do SES herda a lista de supressão da conta, a menos que você mesmo defina o escopo de supressão. Nesse caso, você tem isolamento de reputação, mas, sem nenhum aviso, _não_ tem isolamento de supressão. O Notifuse define o escopo na criação e o corrige se já existir um tenant com esse nome.

> [!NOTE]
>
> O isolamento vale para a **integração**, não para o workspace. Um workspace com integrações SES separadas para marketing e para transacional fica com dois tenants, cada um com a sua lista de supressão, então um endereço com retorno registrado em um não fica suprimido pelo SES no outro. A supressão do próprio Notifuse, por workspace, continua valendo para os dois, então no pior caso sai uma mensagem a mais para um endereço que o SES já sabe que é ruim.

### O que você vai ver

- **Um remetente sem identidade verificada** aparece pelo nome depois de salvar. Os envios dele falhariam com ou sem tenants, então corrija isso.
- **Uma permissão IAM ausente** aparece com a ação exata e um comando da CLI `aws` para executar. O Notifuse só passa a integração para o tenant depois que o conjunto de configuração estiver associado, porque o SES rejeita **todas** as mensagens enviadas por um tenant sem ele. Uma configuração parcial deixa o envio exatamente como estava.
- O card da integração mostra o conjunto de configuração em uso e se a reputação está `isolated` ou `shared with the rest of this AWS account`.

### Como desativar

Desativar o **Isolamento de tenant** vale a partir do próximo envio: as mensagens voltam a sair com a reputação compartilhada da conta. O tenant continua na AWS com a lista de supressão e o histórico de reputação, e reativar a opção retoma o mesmo tenant.

> [!NOTE]
>
> Um tenant com o isolamento desativado **continua sendo cobrado** até a integração ser excluída. Desative o isolamento para mudar a forma de envio; exclua a integração para parar a cobrança.

> [!WARNING]
>
> **Excluir a integração exclui o tenant**, junto com a lista de supressão e o histórico de reputação, que não podem ser recriados. Remover só os webhooks mantém os dois, porque o envio ainda depende deles.

### Avançado: use o seu próprio tenant ou conjunto de configuração

Em **Avançado**, os dois campos são opcionais e sugerem os nomes que existem na sua conta (viram texto livre se as suas credenciais não puderem listá-los):

| Campo                        | Descrição                                                                                                                                                                                      |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Conjunto de configuração** | Envia por um conjunto de configuração que você gerencia, no lugar do `notifuse-<integration ID>`. O Notifuse vincula o próprio destino de eventos a ele, mas nunca cria nem exclui o conjunto. |
| **Tenant SES**               | Envia por um tenant que você mesmo gerencia. Não pode ser usado junto com a opção acima. O Notifuse não o cria, não o altera e não o exclui.                                                   |

Com o seu próprio tenant, você mesmo precisa associar a ele a identidade de envio **e** o conjunto de configuração. Sem isso, o SES rejeita todos os envios:

```bash
aws sesv2 create-tenant-resource-association \
  --tenant-name my-tenant \
  --resource-arn arn:aws:ses:<region>:<account>:configuration-set/<name>
```

> [!NOTE]
>
> Os tenants só existem na API v2 do SES, que é a que o Notifuse usa agora para enviar. Eles também pertencem a uma região, então um tenant fica na mesma região da sua integração.

## Respostas recebidas (parar ao responder)

Para usar **[Sair ao responder](https://www.notifuse.com/pt/docs/features/automations.md#exit-on-reply)** nas automações, o SES precisa encaminhar as respostas recebidas ao Notifuse. O SES trata o recebimento de emails separado do envio, então você configura isso uma única vez, em duas partes:

1. **Aponte os registros MX do seu domínio para o SES.** Adicione no seu domínio de envio um registro MX que aponte para o endpoint de recebimento do SES na sua região, `inbound-smtp.<region>.amazonaws.com` (por exemplo, `inbound-smtp.us-east-1.amazonaws.com`), com prioridade `10`. Sem ele, as respostas nunca chegam ao SES. O SES não tem API de DNS, então você faz isso à mão.
2. **Registre a rota de recebimento.** Em **Configurações → Integrações**, abra o menu **⋯** da integração SES e escolha **Registrar webhooks novamente** (ou **Registrar webhooks**, se eles ainda não estiverem registrados). Além dos webhooks de eventos de entrega, retorno e reclamação, o Notifuse cria um tópico SNS (com assinatura HTTPS para o Notifuse, assinado com SignatureVersion 2) e uma **regra de recebimento** do SES com uma ação SNS. Se a sua conta tiver um conjunto de regras de recebimento ativo, a regra é adicionada **a ele**. Ela só encaminha uma cópia e não tem a ação _stop_, então uma configuração existente (como o Amazon WorkMail) continua funcionando. O Notifuse cria e ativa um conjunto de regras `notifuse-inbound` dedicado **apenas** se nenhum conjunto estiver ativo.

> [!NOTE]
>
> O recebimento de emails do SES só existe em algumas regiões da AWS (por exemplo, `us-east-1`, `us-west-2`, `eu-west-1`). Se a região da sua integração não oferecer o recurso, o registro do recebimento aparece como indisponível. Veja a lista de [Email Receiving endpoints](https://docs.aws.amazon.com/general/latest/gr/ses.html) da AWS.
>
> O tópico SNS de recebimento, a regra de recebimento e a assinatura exigem permissões IAM além das de envio: `sns:CreateTopic`, `sns:SetTopicAttributes`, `sns:Subscribe`, `ses:DescribeActiveReceiptRuleSet`, `ses:CreateReceiptRuleSet`, `ses:CreateReceiptRule`, `ses:SetActiveReceiptRuleSet`, `ses:DeleteReceiptRule` e `ses:ListIdentities`. A regra de recebimento cobre só as identidades verificadas da sua conta (domínios e endereços de email). Se nenhuma estiver verificada, o registro do recebimento é recusado, para que a regra nunca encaminhe todos os emails da conta.
>
> As respostas são associadas ao envio original pelo `Message-ID`. O SES sobrescreve esse cabeçalho no envio, então o Notifuse guarda o valor que o SES devolve e faz a correspondência independentemente do host, sem uma chave de assinatura separada para o recebimento. Antes de ser aceita, cada notificação SNS recebida tem a **assinatura RSA verificada** e precisa estar **vinculada ao tópico criado**: uma mensagem de qualquer outro tópico SNS é rejeitada, mesmo com uma assinatura AWS válida. O endpoint tem limite de requisições.

> [!WARNING]
>
> **Configurações manuais precisam registrar o ARN do tópico SNS.** As mensagens recebidas são autenticadas pelo tópico criado, então uma integração sem ARN de tópico vinculado rejeita todos os emails recebidos. Registrar os webhooks pelo menu **⋯** grava esse ARN para você. Se você montar o recebimento do SES à mão (o seu próprio tópico SNS + regra de recebimento), defina o ARN do tópico na configuração `inbound_topic_arn` da integração SES, ou as respostas não serão aceitas.

Com as duas partes prontas, um contato que responde a um email de automação sai da jornada se essa automação estiver com **Sair ao responder** ativado. Retornos e respostas automáticas de ausência nunca contam como resposta.

## Pré-requisitos

Você precisa de:

1. Uma conta AWS ativa com o SES habilitado
2. Endereços de email ou domínios verificados no console do AWS SES
3. Um usuário AWS com permissões de envio no SES (veja abaixo)
4. Acesso de produção: saia do sandbox do SES para enviar sem restrições

### Permissões IAM

Só o primeiro grupo é obrigatório. Cada um dos outros habilita um recurso opcional, e o Notifuse funciona sem ele: uma permissão ausente é informada com a ação a adicionar, nunca como uma falha silenciosa.

| Finalidade                           | Ações                                                                                                                                                                                                                                                                                                                                              |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Envio** (obrigatório)              | `ses:SendEmail`                                                                                                                                                                                                                                                                                                                                    |
| **Webhooks de eventos**              | `ses:CreateConfigurationSet`, `ses:DescribeConfigurationSet`, `ses:ListConfigurationSets`, `ses:DeleteConfigurationSet`, `ses:CreateConfigurationSetEventDestination`, `ses:UpdateConfigurationSetEventDestination`, `ses:DeleteConfigurationSetEventDestination`, `sns:CreateTopic`, `sns:Subscribe`, `sns:GetTopicAttributes`, `sns:DeleteTopic` |
| **Isolamento de reputação**          | `ses:CreateTenant`, `ses:GetTenant`, `ses:PutTenantSuppressionAttributes`, `ses:CreateTenantResourceAssociation`, `ses:ListEmailIdentities`                                                                                                                                                                                                        |
| **Seletores de nome e verificações** | `ses:ListTenants`, `ses:ListTenantResources`                                                                                                                                                                                                                                                                                                       |
| **Remoção completa**                 | `ses:DeleteTenant`, `ses:DeleteTenantResourceAssociation`                                                                                                                                                                                                                                                                                          |
| **Respostas recebidas**              | Veja a [nota sobre parar ao responder](#inbound-replies-stop-on-reply) acima                                                                                                                                                                                                                                                                       |

> [!WARNING]
>
> Sem as permissões de **remoção completa**, excluir uma integração deixa o tenant dela na sua conta AWS, onde ele continua sendo cobrado até você removê-lo à mão.

## Teste

Clique em **Enviar um e-mail de teste** no topo do formulário da integração, ou em **Enviar teste** no card dela, para verificar a configuração.
