> ## 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 email

Entrega transacional: escolhe um fornecedor, verifica um remetente, pré-visualiza cada template.

## Instalação e configuração

Antes de qualquer etapa, leia [Antes de começar](https://supastack.dev/pt/docs/web/before-you-start.md) e [Noções básicas sobre terminal](https://supastack.dev/pt/docs/web/terminal-basics.md). Estas instruções presumem que você abriu o monorepo supastack completo no VS Code; sua raiz package.json marca a raiz do repositório. Nos comandos pnpm, um pacote de espaço de trabalho é um aplicativo ou uma pasta de código compartilhado; no produto, um espaço de trabalho é o contêiner de dados e o limite de segurança de uma equipe. corepack pnpm --filter ... seleciona um pacote do monorepo enquanto os comandos são executados a partir de sua raiz. Se você abriu apenas uma pasta móvel ou desktop sincronizada, ela não contém o back-end da Web, a configuração do Docker ou os scripts raiz: execute o back-end deste monorepo ou de um servidor hospedado acessível e use os próprios scripts da pasta da plataforma. Uma variável de ambiente é uma configuração nomeada armazenada em um arquivo .env local ou no painel de hospedagem; reinicie o aplicativo relevante após alterá-lo e mantenha os segredos do servidor fora dos valores NEXT_PUBLIC_ e EXPO_PUBLIC_.

1. Abra apps/web/.env.local e defina EMAIL_PROVIDER=local para desenvolvimento; EMAIL_FROM é o rótulo do remetente usado pelos modelos.

2. Inicie o aplicativo Web a partir da raiz do repositório com corepack pnpm --filter @supastack/web dev e acione um fluxo de login ou de convite com um endereço de teste. Esperado: o aplicativo registra um resultado de e-mail local sem entrar em contato com um provedor real. Conecte Reenviar, SES ou outro serviço somente depois que o domínio do remetente for verificado e os destinatários do teste estiverem restritos.

EMAIL_PROVIDER=local mantém a entrega determinística local. Para entrega de produção configurada, revise o adaptador Reenviar ou SES e forneça suas credenciais de servidor. EMAIL_FROM deve corresponder à identidade verificada com o provedor selecionado.

[Configurar Amazon SES com SDK AWS ou IAM SMTP](https://supastack.dev/pt/docs/web/aws-ses.md)

```
EMAIL_PROVIDER=local
EMAIL_FROM=supastack <hello@example.test>
# Production adapter configuration is listed in .env.example:
# RESEND_API_KEY=  POSTMARK_SERVER_TOKEN=  SENDGRID_API_KEY=  BREVO_API_KEY=
# MAILGUN_API_KEY=  MAILGUN_DOMAIN=  MAILGUN_REGION=us
```


## Comandos para copiar

Siga os comentários para ver em qual pasta um comando é executado. Se dois terminais estiverem rotulados, abra duas janelas de terminal e mantenha o primeiro comando em execução enquanto usa o segundo.

```
corepack pnpm --filter @supastack/web dev
```


## Fluxo de implementação

As mensagens de auth e de conclusão usam a fronteira de email transacional. Os fluxos de divulgação pertencem ao produto consumidor e permanecem separados. Nunca reutilizes este caminho como um subsistema de mensagens em massa não revisto.

Regista a entrega separadamente da geração. Um resultado de modelo pode estar disponível enquanto a sua mensagem de conclusão falha. A recuperação deve inspecionar o estado de entrega em vez de regenerar o mesmo resultado.


## Verificação e resolução de problemas

Se nenhum e-mail local aparecer, verifique se EMAIL_PROVIDER está definido em apps/web/.env.local e reinicie o Web. Se um provedor real rejeitar uma mensagem, confirme se EMAIL_FROM corresponde a um remetente verificado e inspecione o registro de entrega do provedor. Uma resposta de IA gerada pode ser bem-sucedida mesmo quando o e-mail de acompanhamento falha; verifique a entrega antes de executar o AI task novamente.

Verifica restrições de destinatários, identidade de remetente e erros de fornecedor num ambiente de teste dedicado. Um resultado de adaptador local não é evidência de entrega de email real. O caminho de smoke opt-in restringe destinatários via REAL_SMOKE_EMAIL_ALLOWED_DOMAIN.


Para continuar a configuração, leia [Configurar login OAuth](https://supastack.dev/pt/docs/web/setup-oauth.md).


## Seguinte

[Email transacional](https://supastack.dev/pt/docs/modules/email.md)