> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Configurar e-mail do Amazon SES

Configure Amazon SES para web, celular e desktop com credenciais do SDK AWS ou IAM SMTP, verifique o remetente e evite custos desnecessários do Mail Manager.

## 1. Verifique um remetente na sua região AWS

Abra Amazon SES em US East (N. Virginia), us-east-1. Escolha Configuration → Identities → Create identity, selecione seu domínio ou e-mail e conclua a verificação DNS ou por e-mail. Use a mesma região e o remetente verificado nos ajustes abaixo.

Contas novas do SES começam em sandbox: verifique também o destinatário ou use o simulador de caixas do SES. Solicite acesso à produção em Account dashboard antes de enviar a clientes comuns. [Abrir Amazon SES](https://us-east-1.console.aws.amazon.com/ses/home?region=us-east-1)


## 2. Para SMTP, escolha IAM SMTP credentials

No SES, abra SMTP settings → Create SMTP credentials. Escolha IAM SMTP credentials em vez de Mail Manager com o selo Recommended. O cartão IAM mostra Manual credential management. No traffic policies or rule sets. Clique em Create IAM credentials, nomeie o usuário de envio e baixe as credenciais SMTP antes de fechar.

[Criar credenciais IAM](https://us-east-1.console.aws.amazon.com/iam/home?SESRegion=us-east-1#/users/smtp/create) · [Gerenciar existentes](https://us-east-1.console.aws.amazon.com/iam/home#/users)

Estes links usam us-east-1, onde IAM SMTP clássico está disponível. Para outra região compatível, crie credenciais para ela e use seu endpoint SMTP. A senha SMTP baixada não é a chave de acesso secreta AWS; use-a apenas na etapa 5. [Instruções SMTP da AWS](https://docs.aws.amazon.com/ses/latest/dg/smtp-credentials.html)


## 3. Evite cobranças desnecessárias do Mail Manager

IAM SMTP e o SDK SES enviam diretamente pelo SES, sem políticas de tráfego ou conjuntos de regras do Mail Manager. Evite criar um endpoint de entrada aberto ou mTLS opcional: a AWS informa US$ 50 por mês por endpoint no preço à la carte. Endpoints autenticados são gratuitos atualmente; Recommended nem sempre acrescenta US$ 50. As tarifas de envio e do plano escolhido continuam valendo. [Consultar preços AWS](https://aws.amazon.com/ses/pricing/)


## 4. Envie pelo SDK AWS

Este modo usa a API SES por HTTPS. No IAM, conceda à função do servidor ou a um usuário exclusivo de envio ses:SendEmail sobre a identidade SES verificada. Para um usuário, abra Security credentials → Create access key e salve ID e chave secreta originais. Uma senha SMTP não assina solicitações do SDK.

Coloque o exemplo em apps/web/.env.local no desenvolvimento ou nos segredos da hospedagem em produção. Substitua remetente e valores de exemplo. Com uma função IAM ou perfil AWS local configurado, deixe as duas chaves e AWS_SESSION_TOKEN vazios: o SDK usa sua cadeia padrão. Forneça sempre o par completo de chaves explícitas.

Com credenciais temporárias explícitas, inclua o AWS_SESSION_TOKEN correspondente e renove os três valores quando expirarem. O SDK renova credenciais de funções. [Cadeia de credenciais do SDK AWS](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html)

```
EMAIL_PROVIDER=ses
EMAIL_FROM=Your App <hello@yourdomain.com>
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=<IAM-access-key-id>
AWS_SECRET_ACCESS_KEY=<original-IAM-secret-access-key>
# Temporary explicit credentials only:
AWS_SESSION_TOKEN=
```


## 5. Ou use IAM SMTP clássico

Use usuário e senha SMTP da etapa 2 nesta configuração alternativa. A porta 587 usa STARTTLS; SMTP_SECURE=false seleciona esse modo. Endpoint, credenciais e remetente verificado devem estar na mesma região.

Estes ajustes do kit do comprador são compartilhados pelas três plataformas. Escolha um modo: EMAIL_PROVIDER=smtp usa credenciais SMTP; EMAIL_PROVIDER=ses usa as credenciais da API do SDK.

```
EMAIL_PROVIDER=smtp
EMAIL_FROM=Your App <hello@yourdomain.com>
SMTP_HOST=email-smtp.us-east-1.amazonaws.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=<downloaded-SMTP-username>
SMTP_PASSWORD=<downloaded-SMTP-password>
```


## 6. Configure uma vez para web, celular e desktop

Reinicie o servidor após as alterações. Com o banco migrado, solicite um código de acesso por e-mail em /auth para um destinatário permitido e confira entrada e spam. O celular usa o mesmo servidor; o desktop carrega a aplicação web. Nenhum cliente precisa de chaves AWS ou senha SMTP.

Mantenha credenciais apenas no servidor, nunca em NEXT_PUBLIC_, EXPO_PUBLIC_ ou no pacote desktop. Em caso de falha, confira remetente, restrições de sandbox, região, permissões IAM e tipo de credenciais. queued significa que o SES aceitou a mensagem, não que ela chegou. [Visão geral da configuração de e-mail](https://supastack.dev/pt/docs/web/setup-email.md)


Para continuar a configuração, leia [Recolher as chaves de provedor restantes](https://supastack.dev/pt/docs/web/provider-keys.md).


## Seguinte

[Recolher as chaves de provedor restantes](https://supastack.dev/pt/docs/web/provider-keys.md)