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.

Começar a aula interativaLer as notas da aula

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.

Arquivos da oficina

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.

Resend: enviar e-mail

Arquivos desta etapa

Start hereArquivos da oficina

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.

Resend: enviar e-mail

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.

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

Arquivos desta etapa

Start hereArquivos da oficina

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.

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.

Arquivos desta etapa

Start hereArquivos da oficina

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.

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.

Arquivos desta etapa

Start hereArquivos da oficina

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.

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.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

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.

Esta lição foi útil?

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

Continue aprendendo

Explore as outras lições