For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /pt/docs/modules/email-configuration.md (or send Accept: text/markdown).
Configuração do fornecedor de email
Configura a entrega transacional e verifica o seu resultado independente.
Instalação e configuração
Antes de qualquer etapa, leia Antes de começar e Noções básicas sobre terminal. 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.
EMAIL_PROVIDER=local
EMAIL_FROM=supastack <[email protected]>
# Production adapter configuration is listed in .env.example.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 devFluxo 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.