LiçõesComo enviar e-mails automáticos pelo seu site

Minilição 9 de 30 · Tornar seu site útil

Escolha uma ação de e-mail

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.

Comece com uma confirmação fixa e controlada.

Objetivo desta lição

  • 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.
Explicação, exemplo resolvido e prática

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.

Confira os conhecimentos iniciais

São habilidades úteis, não cursos obrigatórios bloqueados. Se já as domina, comece aqui; caso contrário, abra a preparação. Os arquivos fornecidos dispensam um site pessoal anterior.

  1. Como publicar seu site pelo GitHub

    Conecte um repositório de prática à hospedagem.

  2. Como configurar e-mail no seu próprio domínio

    Escolha e configure uma caixa de e-mail real com envio e recebimento.

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.

Entenda a ideia

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

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

O que disparará seu teste e onde verificará aceitação e chegada?

Mostrar uma solução comentada

Plano de exemplo: Vou digitar o código de acesso da prática e o nome fictício Alex e acionar Request test email. TEST_RECIPIENT no servidor é minha caixa controlada. Vou relacionar a referência retornada ao evento do provedor e ao e-mail que realmente chegar.

O que uma boa resposta inclui

  • Identifica a ação controlada específica do formulário e o destino definido no servidor.
  • Distingue a aceitação pelo provedor da chegada real à caixa de entrada.
Como funciona (opcional)

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.

Resend: enviar e-mail

Exercício técnico complementar

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.

Etapa 1 · Como enviar e-mails automáticos pelo seu site

Configure e inicie o projeto pronto

Deixe o assistente cuidar da conexão do servidor.

Explicação, exemplo resolvido e prática

Entenda a ideia

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.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

O projeto iniciou e qual etapa de configuração está concluída ou ainda bloqueada?

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.

O que uma boa resposta inclui

  • 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.
Como funciona (opcional)

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

Exercício técnico complementar

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.

Etapa 2 · Como enviar e-mails automáticos pelo seu site

Envie um teste reconhecível

Use a interface e mantenha as provas relacionadas.

Explicação, exemplo resolvido e prática

Entenda a ideia

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.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

O que a página, o provedor e a caixa de entrada mostraram, cada um, para sua tentativa?

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.

O que uma boa resposta inclui

  • 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.
Como funciona (opcional)

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.

Exercício técnico complementar

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.

Etapa 3 · Como enviar e-mails automáticos pelo seu site

Investigue uma mensagem ausente

Procure o estado da entrega antes de enviar repetidamente.

Explicação, exemplo resolvido e prática

Entenda a ideia

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.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

Qual estado de entrega observado explica a próxima ação do seu teste?

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.

O que uma boa resposta inclui

  • 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.
Como funciona (opcional)

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.

Exercício técnico complementar

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.

Etapa 4 · Como enviar e-mails automáticos pelo seu site

Adicione um assunto útil à mensagem

Descreva o comportamento e peça ao assistente para implementá-lo.

Explicação, exemplo resolvido e prática

Entenda a ideia

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.

Arquivos desta etapa

Comece aquiArquivos da oficina

Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.

Experimente

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.

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.

O que uma boa resposta inclui

  • 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.
Como funciona (opcional)

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.

Exercício técnico complementar

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.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.