
Minilição · Português
Como enviar e-mails automáticos pelo seu site
Execute um projeto de e-mail fornecido com um assistente, envie uma confirmação controlada e verifique sua chegada à caixa de entrada.
Para quem é esta lição?
Para quem quer que uma ação no site dispare um e-mail. O código do servidor é fornecido e um assistente de programação pode configurá-lo; você não precisa escrever um backend de e-mail.
Antes de começar
Você precisa da sua conta Resend, de um remetente verificado e de uma caixa de teste. Use o projeto Netlify Functions completo e separado com um assistente para configurar. Valem a disponibilidade e as condições do provedor. As respostas resolvidas são exemplos ilustrativos, não testes realizados na sua conta. Troque as observações de exemplo pelos seus resultados ou indique a etapa que continua bloqueada.
Tempo estimado: 21–38 min
Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. Verificação do remetente e espera de entrega são adicionais. Taxas e limites dependem da conta.
O que você vai aprender
- Configure remetente e destinatário controlados.
- Dispare um e-mail de teste real e examine a entrega.
- Trate solicitações com falha sem fingir que uma mensagem chegou.
Etapa 1
Escolha uma ação de e-mail
Comece com uma confirmação fixa e controlada.
Abra o projeto fornecido com seu assistente e decida qual evento deve enviar a confirmação de teste. Use apenas a caixa do proprietário configurada; o visitante não deve escolher destinatários arbitrários.
Distinga a aceitação de uma solicitação pelo provedor da chegada de uma mensagem à caixa de entrada.
Um exemplo concreto
A ação fornecida envia uma mensagem fixa Workshop confirmation ao destinatário configurado no servidor. O visitante fornece um nome, não um destino qualquer. A referência retornada ajuda a rastrear a mensagem, mas não comprova que ela chegou.
Abra esta oficina completa de e-mail. Siga run-locally.txt e explique os valores privados de remetente, destinatário, chave do provedor e código de prática. Mantenha-os fora dos arquivos públicos. Ajude a executar o projeto e disparar apenas para minha própria caixa de teste configurada. Examine separadamente a aceitação pelo provedor e a entrega real na caixa, incluindo uma tentativa rejeitada.Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Envie um e-mail depois de uma ação no site
Uma função de servidor transforma uma solicitação aceita em chamada ao provedor de e-mail.
O navegador deve pedir uma ação específica, não guardar sua credencial privilegiada. Aqui envia um nome a uma função, que manda uma confirmação em texto simples para sua caixa configurada.
O exemplo usa o Resend. Outro provedor de e-mail transacional pode cumprir a mesma função, mas a autenticação, a verificação do remetente e os eventos de entrega serão diferentes. Uma caixa de e-mail usada por uma pessoa para receber mensagens e responder é um serviço separado.
Exemplo resolvido
A resposta “accepted” significa que o provedor aceitou o envio. Não comprova recebimento na caixa. Verificaremos esse limite separadamente.
Extra implementation exercise
O provedor retornou um ID, mas você não verificou a caixa. O que pode afirmar com honestidade?
Mostrar uma solução comentada
O provedor aceitou uma solicitação com aquela referência. A entrega continua não verificada até examinar as evidências e a caixa de teste.
- Afirma aceitação, não entrega confirmada na caixa.
- Guarda uma referência para verificar a entrega.
Erro comum
Exibir “Delivered” (entregue) logo após uma chamada API bem-sucedida.
Etapa 2
Configure e inicie o projeto pronto
Deixe o assistente cuidar da conexão do servidor.
Siga run-locally.txt com seu assistente. Insira os valores privados da conta usando server-env.example.txt, inicie o projeto completo e abra sua URL local real.
Mantenha a chave do provedor e o destinatário fixo no servidor. O código de prática do formulário é separado da chave do provedor; uma visualização de arquivo não executa o serviço de e-mail.
Um exemplo concreto
Os valores do servidor definem remetente, destinatário e acesso ao provedor. O código separado permite este teste restrito ao responsável. Nem um campo oculto no navegador nem uma visualização de arquivo configuram esse servidor privado.
Node.js: estado de suporte das versões
Experimente
O projeto iniciou e qual etapa de configuração está concluída ou ainda bloqueada?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro de configuração de exemplo: O proxy local iniciou e mostrou a URL da aplicação. O ambiente privado contém meu remetente verificado, destinatário controlado, chave do provedor e código de prática gerado separadamente. Só esse código vai no formulário. Se aparecer Mail not configured, a configuração privada de remetente/chave/destinatário continua incompleta.
- Informa se o projeto completo com servidor iniciou na URL que exibiu.
- Distingue a chave privada e o destinatário fixo do código separado usado no formulário.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Configure um remetente restrito de prática
Mantenha credenciais e destinatário de teste fora da pasta pública.
Lista local: confirme Node e npm, instale ou verifique a CLI Netlify e siga run-locally.txt antes de enviar o formulário. Abrir primeiro a página estática ajuda no layout, mas não testa a função de servidor.
Leia netlify/functions/mini-mail.mjs. Configure as variáveis de e-mail e um LAB_TOKEN imprevisível de pelo menos 24 caracteres na hospedagem. MAIL_FROM precisa ser autorizado; TEST_RECIPIENT é sua caixa. Não coloque a chave em public/app.js.
O usuário digita o código separado deste laboratório; ele nunca é incluído na página e não é a chave Resend. A função ignora destinos do cliente de propósito. Valida um nome pequeno e cria texto simples. Antes de publicar, acrescente limites duradouros e revise cotas; este laboratório exclusivo não é um sistema completo contra abuso.
O servidor controla o destino de propósito. Uma solicitação alterada pode acrescentar to='somewhere-else', mas a função constrói seus dados e usa TEST_RECIPIENT. Isso impede o uso para enviar a endereços arbitrários; acesso público ainda exigiria controles duradouros.
Para a sequência local completa, abra run-locally.txt: prepare o ambiente privado da raiz, vincule apenas o projeto de prática e inicie o proxy de funções do Netlify. server-env.example.txt lista nomes de variáveis sem segredos reais. Abrir apenas o HTML não executa o servidor.
Exemplo resolvido
Alterar a solicitação do navegador não redireciona o e-mail porque o destinatário vem do servidor. Esconder um endereço em JavaScript não daria essa proteção.
const {RESEND_API_KEY, MAIL_FROM, TEST_RECIPIENT} = process.env;
// Send only to TEST_RECIPIENT in this lab.Node.js: estado de suporte das versões
Extra implementation exercise
Mover a chave para um campo oculto a manteria privada?
Mostrar uma solução comentada
Não. Campos ocultos também são entregues ao navegador. Mantenha credencial e chamada ao provedor no servidor.
- Reconhece que valores entregues ao navegador são consultáveis.
- Move o uso privilegiado para o ambiente do servidor.
Erro comum
Supor que um valor é secreto porque a página não o exibe.
Etapa 3
Envie um teste reconhecível
Use a interface e mantenha as provas relacionadas.
Dispare a confirmação a partir da página realmente em execução. Salve a referência do teste e examine o evento correspondente no provedor e a cópia na caixa de entrada.
Se a solicitação falhar, mantenha a falha visível e contexto suficiente para tentar novamente. Não corrija um serviço indisponível inventando uma mensagem de sucesso.
Um exemplo concreto
Para o nome fictício Alex, o texto inicial do e-mail é “Hello Alex. Your practice request was received.” Compare a cópia recebida com a tentativa correspondente, não com uma mensagem antiga.
Experimente
O que a página, o provedor e a caixa de entrada mostraram, cada um, para sua tentativa?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro de tentativa de exemplo: A página informou aceitação com uma referência. O evento correspondente existe no provedor. Minha caixa controlada contém Workshop confirmation com “Hello Alex. Your practice request was received.” Se a cópia não estivesse lá, registraria aceito, mas entrega pendente.
- Relaciona a resposta da página, o evento do provedor e o resultado na caixa à mesma tentativa.
- Identifica a etapa que falhou, sem transformar erro ou ID aceito em afirmação de entrega.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Acompanhe a solicitação e resposta fornecidas
O botão envia JSON; o servidor valida e retorna um estado honesto.
Implante o projeto separado ou execute as ferramentas locais de funções. Abrir index.html como arquivo não executa o backend. Envie um nome sintético e examine a resposta de rede.
O servidor retorna 400 para entrada malformada, 503 sem configuração, 502 para falha do provedor e 202 quando aceita a mensagem. O navegador trata a falha sem fingir que o e-mail chegou.
Exemplo resolvido
A interface diz “Accepted by the mail provider. Check your test inbox.” (aceito pelo provedor; verifique sua caixa de teste). Isso corresponde ao conhecimento do servidor naquele momento.
Extra implementation exercise
O endpoint retorna 503. Você deve começar pela cor do botão ou pelo ambiente do servidor?
Mostrar uma solução comentada
Confira variáveis e configuração do remetente. A aparência da interface não fornece credenciais ausentes.
- Verifica primeiro a configuração ausente do servidor.
- Não trata a solicitação com falha como e-mail concluído.
Erro comum
Testar um backend abrindo apenas o arquivo HTML.
Etapa 4
Investigue uma mensagem ausente
Procure o estado da entrega antes de enviar repetidamente.
Use delivery-record.txt para relacionar a referência do teste ao estado no provedor, destino e verificação de caixa de entrada e spam. Peça ajuda ao assistente na etapa que falhou.
Uma devolução ou destino rejeitado precisa ser investigado. Repetir o mesmo envio às cegas pode gerar ruído sem corrigir a entrega.
Um exemplo concreto
Aceito → devolvido → sem cópia na caixa aponta para investigar a entrega. Código de prática rejeitado → nenhum evento no provedor aponta para configurar o acesso. Essas observações levam a próximos passos diferentes.
Experimente
Qual estado de entrega observado explica a próxima ação do seu teste?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Diagnóstico de exemplo: O provedor aceitou a tentativa, mas seu evento agora mostra uma devolução e a caixa controlada não recebeu cópia. Vou conferir o destino configurado e esse evento antes de enviar novamente. Isso difere de um código de prática rejeitado, que não deveria chegar ao provedor de e-mail.
- Usa o estado correspondente do provedor e as verificações de destino/caixa para diagnosticar a entrega atual.
- Escolhe a próxima ação na etapa que falhou, sem repetir envios às cegas.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Verifique entrega e falha
Relacione um clique, sua referência do provedor e a mensagem realmente recebida.
Encontre a mensagem aceita na atividade do provedor e examine o estado. Depois confira a caixa configurada, incluindo spam. Registre aceitação e cópia recebida separadamente.
Tente nome vazio pelo formulário e JSON malformado por uma solicitação de desenvolvimento. Em configuração descartável separada, verifique falha limpa sem credenciais. Nunca compartilhe corpos de resposta que possam conter detalhes da conta.
Exemplo resolvido
Um evento de entrega e a mensagem correspondente são evidências mais fortes que um botão verde. Aceitação sem cópia recebida é uma investigação de entrega pendente.
Extra implementation exercise
O provedor registra uma devolução para a referência de teste. Repetir imediatamente o mesmo envio é a melhor próxima ação?
Mostrar uma solução comentada
Examine primeiro a falha e o destinatário. Tente novamente só depois de identificar o que mudou; envios idênticos não corrigem um destino inválido.
- Investiga o motivo da devolução e o destino.
- Evita solicitações repetidas sem mudança de diagnóstico.
Erro comum
Depurar HTML quando a solicitação chegou ao provedor e falhou depois.
Etapa 5
Adicione um assunto útil à mensagem
Descreva o comportamento e peça ao assistente para implementá-lo.
Peça ao assistente para adicionar dois assuntos: Project e Question, com valores project e question. Inclua o valor escolhido no corpo da confirmação, mantendo o destinatário fixo e a chave privada. Peça ajuda para testar o valor não permitido other, sem adicioná-lo como opção válida.
Envie um teste controlado por opção permitida e confira o texto recebido. O assunto não permitido e um código errado devem ser rejeitados sem envio pelo provedor; verifique essas tentativas negativas separadamente.
Um exemplo concreto
A tarefa permite duas opções: Project e Question, armazenadas como project e question. O valor selecionado deve chegar ao corpo do e-mail. Other é um teste deliberadamente não permitido, não uma terceira opção para adicionar.
Experimente
Materiais para começar
Os arquivos e conteúdos de teste estão incluídos. A verificação real exige sua própria conta, caixa de entrada ou domínio conforme os pré-requisitos. É possível inspecionar localmente; marque etapas reais não executadas como não testadas.
Apresente sua alteração de assunto e os resultados reais dos testes bem-sucedidos e rejeitados.
O que entregar A ação de teste funcional e um registro de provedor, caixa de entrada e erro com dados sensíveis ocultados.
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Registro de extensão de exemplo: Project gerou “Hello Alex. Your project request was received.” Question gerou o texto correspondente de question em outro e-mail controlado. O assunto não permitido other e um código incorreto foram rejeitados sem envio correspondente no provedor. As duas opções válidas continuam usando o destinatário fixo.
- Adiciona exatamente Project/Question e verifica o valor selecionado no conteúdo realmente recebido.
- Confere que assunto não permitido e código incorreto não enviam mensagens.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- netlify/functions/mini-mail.mjsBaixar este arquivo
- delivery-record.txtBaixar este arquivo
- worksheet.htmlBaixar este arquivo
- reference/assignment-walkthrough.txtBaixar este arquivo
- reference/START-HERE.txtBaixar este arquivo
- reference/public/index.htmlBaixar este arquivo
- reference/public/app.jsBaixar este arquivo
- reference/netlify/functions/mini-mail.mjsBaixar este arquivo
How it works (optional)
Sua tarefa: acrescentar um detalhe significativo de confirmação
Inclua um assunto curto sem permitir destinatários ou HTML arbitrários.
Acrescente um campo topic com dois valores permitidos. Valide a lista no servidor e inclua a escolha no texto simples. Mantenha o destinatário fixo no ambiente.
Envie um teste para cada valor e um não aceito. Registre a referência do provedor e evidências reais de entrega.
Edite primeiro os arquivos iniciais. Compare depois select, JSON e lista do servidor linha por linha com a referência. Ela é uma alternativa completa para conferir o trabalho, não outra pasta para colar às cegas em public/.
Exemplo resolvido
Aceitar apenas “project” e “question” é mais fácil de revisar do que copiar conteúdo arbitrário para todos os campos de e-mail.
O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.
Extra implementation exercise
Amplie a confirmação com um assunto validado e demonstre solicitações bem-sucedidas e rejeitadas.
Mostrar uma solução comentada
A extensão usa exatamente 'project' e 'question'. Acrescente select no formulário, inclua topic no JSON e valide a lista no servidor antes de chamar o provedor. A referência mostra as mudanças completas.
Mantenha TEST_RECIPIENT sob controle do servidor mesmo se uma solicitação alterada fornecer outro endereço. Assunto permitido e código válido podem chegar à aceitação; assunto inválido deve retornar 400 sem chamar o provedor. Aceitação não é recebimento na caixa.
Envie cada assunto pela sua conta de teste, relacione a referência à mensagem recebida e registre devolução ou pendência com honestidade. A referência amplia um laboratório restrito, não um retransmissor público de e-mail.
- O servidor rejeita assuntos não aceitos e mantém o destinatário fixo.
- Os dois assuntos permitidos aparecem nas mensagens recebidas correspondentes.
Erro comum
Confiar em select como único limite de validação.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.
Continue aprendendo
- Como criar seu primeiro site pessoal
- Como publicar seu site pelo GitHub
- Como conectar um domínio próprio ao seu site
- Como configurar e-mail no seu próprio domínio
- Como tornar seu site utilizável em celulares
- Como acelerar o carregamento das imagens do seu site
- Como receber os comentários do seu site na sua caixa de entrada
- Como adicionar assinaturas por e-mail ao seu site
- Como salvar envios de formulário em um banco de dados
- Como permitir que as pessoas entrem no seu site
- Como manter uma página privada
- Como permitir que usuários editem as informações do perfil
- Como permitir que usuários enviem imagens
- Como manter chaves de API fora do frontend
- Como mostrar dados de uma API externa no seu site
- Como adicionar um chatbot de IA ao seu site
- Como fazer um chatbot responder com base no seu conteúdo
- Como adicionar um blog ao seu site
- Como adicionar busca ao seu site
- Como adicionar outro idioma ao seu site
- Como ajudar o Google a encontrar seu site
- Como corrigir a prévia do seu site ao compartilhar um link
- Como medir visitas e ações úteis no seu site
- Como permitir que visitantes agendem um horário
- Como aceitar um pagamento no seu site
- Como visualizar mudanças do site antes de publicar
- Como desfazer uma implantação com falha do seu site
- Como fazer backup e restaurar os dados do seu site
- Como encontrar e corrigir erros no seu site no ar