Mini-leçon · Français

Comment envoyer des e-mails automatiques depuis votre site

Exécutez le projet de courriel fourni avec un assistant, envoyez une confirmation contrôlée et vérifiez son arrivée en boîte.

Commencer le cours interactifLire les notes du cours

À qui s’adresse cette leçon ?

Pour les personnes souhaitant qu’une action du site déclenche un courriel. Le code serveur est fourni et l’assistant peut le configurer ; vous n’avez pas à écrire un serveur de courriel.

Avant de commencer

Votre propre compte Resend, un expéditeur vérifié et une boîte de test sont nécessaires. Utilisez le projet complet et distinct de fonctions Netlify avec un assistant pour la configuration. Disponibilité et conditions du fournisseur s’appliquent. Les corrigés sont des exemples, pas des tests effectués sur votre compte. Remplacez leurs observations par vos propres résultats ou précisez l’étape qui reste bloquée.

Durée estimée: 21–38 min

Estimations avec les fichiers fournis et les comptes et outils requis déjà prêts. La configuration, les files de déploiement et les délais de messagerie ou de DNS demandent du temps supplémentaire. Vérification d’expéditeur et attente de livraison s’ajoutent. Frais et limites dépendent du compte.

Ce que vous apprendrez

  • Configurez un expéditeur et un destinataire contrôlés.
  • Déclenchez un vrai courriel de test et examinez la livraison.
  • Gérez les requêtes en échec sans prétendre qu’un message est arrivé.

Fichiers de l’atelier

Étape 1

Choisissez une action d’envoi

Commencez par une confirmation fixe et contrôlée.

Ouvrez le projet avec l’assistant et décidez de l’événement déclencheur. Utilisez seulement la boîte du propriétaire configurée ; le visiteur ne doit pas choisir de destinataires arbitraires.

Distinguez l’acceptation de la requête par le fournisseur de l’arrivée du message en boîte.

Un exemple concret

L’action fournie envoie un Workshop confirmation fixe au destinataire configuré sur le serveur. Le visiteur fournit un nom, pas une destination libre. La référence retournée aide à retrouver le message sans prouver son arrivée.

Ouvre cet atelier de courriel complet. Suis run-locally.txt et explique les valeurs privées d’expéditeur, de destinataire, de clé fournisseur et de code d’exercice. Exclus-les des fichiers publics. Aide-moi à exécuter le projet et à déclencher uniquement ma boîte de test configurée. Examine séparément acceptation du fournisseur et livraison réelle, y compris une tentative rejetée.

Resend : envoyer un e-mail

Fichiers de cette étape

Start hereFichiers de l’atelier

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

How it works (optional)

Envoyez un e-mail après une action web

Une fonction serveur transforme une requête acceptée en appel au fournisseur de messagerie.

Le navigateur demande une action précise au lieu de détenir votre clé privilégiée. Ici, il envoie un nom à une fonction qui adresse une confirmation en texte brut à votre boîte configurée.

Le parcours proposé utilise Resend. Un autre fournisseur d’e-mails transactionnels peut remplir le même rôle, mais son authentification, la vérification de l’expéditeur et les événements de livraison diffèrent. Une boîte de messagerie utilisée par une personne pour recevoir des messages et y répondre est un service distinct.

Exemple détaillé

La réponse “accepted” signifie que le fournisseur a accepté l’envoi. Elle ne prouve pas la réception en boîte. Nous vérifierons cette frontière séparément.

Resend : envoyer un e-mail

Extra implementation exercise

Le fournisseur renvoie un ID de message, mais vous n’avez pas vérifié la boîte. Que pouvez-vous affirmer honnêtement ?

Afficher une solution détaillée

Le fournisseur a accepté une requête avec cette référence. La livraison reste non vérifiée jusqu’à consultation des preuves et de la boîte de test.

  • Affirme l’acceptation, pas la livraison confirmée.
  • Garde une référence pour le contrôle de livraison.

Étape 2

Configurez et démarrez le projet prêt à l’emploi

Laissez l’assistant gérer les connexions du serveur.

Suivez run-locally.txt avec votre assistant. Saisissez les valeurs privées du compte à l’aide de server-env.example.txt, puis démarrez le projet complet et ouvrez sa véritable URL locale.

Gardez la clé fournisseur et le destinataire fixe sur le serveur. Le code d’exercice du formulaire est distinct de la clé ; un aperçu de fichier n’exécute pas le service d’envoi.

Un exemple concret

Les valeurs serveur choisissent expéditeur, destinataire et accès au fournisseur. Le code distinct autorise ce test réservé au propriétaire. Ni un champ caché du navigateur ni une simple ouverture de fichier ne réalisent cette configuration privée.

Node.js : état de prise en charge des versions

Fichiers de cette étape

Start hereFichiers de l’atelier

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

How it works (optional)

Configurez un expéditeur d’entraînement restreint

Gardez les identifiants et le destinataire hors du dossier public.

Liste locale : confirmez Node et npm, installez ou vérifiez la CLI Netlify et suivez run-locally.txt avant le formulaire. Ouvrir d’abord la page statique aide la mise en page, mais ne teste pas sa fonction serveur.

Lisez netlify/functions/mini-mail.mjs. Configurez les variables de messagerie et un LAB_TOKEN imprévisible d’au moins 24 caractères chez votre hébergeur. MAIL_FROM doit être autorisé ; TEST_RECIPIENT est votre boîte. Ne mettez pas la clé dans public/app.js.

L’utilisateur saisit le code d’accès distinct de cet atelier à accès restreint ; ce code n’est jamais inclus dans la page et n’est pas votre clé Resend. La fonction ignore volontairement les destinations fournies par l’appelant. Elle valide un petit champ de nom et crée un contenu en texte brut. Avant une ouverture au public, ajoutez des limites de requêtes durables et examinez les quotas ; cet atelier réservé au propriétaire n’est pas un système complet de protection contre les abus.

Le serveur possède délibérément la destination. Une requête modifiée peut ajouter to='somewhere-else', mais la fonction construit ses données et utilise TEST_RECIPIENT. L’appelant ne peut donc pas envoyer à des adresses arbitraires ; l’accès public demanderait toujours des contrôles durables.

Pour la séquence locale complète, ouvrez run-locally.txt : préparez l’environnement privé de la racine, liez uniquement le projet d’entraînement et démarrez le proxy de fonctions Netlify. server-env.example.txt liste les noms des variables sans vrais secrets. Ouvrir seulement le HTML ne lance pas le serveur.

Exemple détaillé

Modifier la requête navigateur ne redirige pas le courrier, car le destinataire vient du serveur. Masquer une adresse dans JavaScript n’apporte pas cette protection.

const {RESEND_API_KEY, MAIL_FROM, TEST_RECIPIENT} = process.env;
// Send only to TEST_RECIPIENT in this lab.

Node.js : état de prise en charge des versions

Extra implementation exercise

Déplacer la clé dans un champ masqué la garderait-il privée ?

Afficher une solution détaillée

Non. Les champs masqués sont aussi livrés au navigateur. Gardez clé et appel fournisseur au serveur.

  • Reconnaît que les valeurs livrées au navigateur sont consultables.
  • Déplace l’usage privilégié dans l’environnement serveur.

Étape 3

Envoyez un test reconnaissable

Utilisez l’interface et reliez les preuves entre elles.

Déclenchez la confirmation depuis la page réellement exécutée. Gardez sa référence de test et examinez l’événement fournisseur et la copie reçue correspondants.

Si la requête échoue, gardez l’échec visible et assez de contexte pour réessayer. Ne remplacez pas un service indisponible par un message de réussite inventé.

Un exemple concret

Pour le nom fictif Alex, le message de départ est « Hello Alex. Your practice request was received. » Comparez la copie réellement reçue à la bonne tentative, pas à un ancien mail.

Fichiers de cette étape

Start hereFichiers de l’atelier

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

How it works (optional)

Suivez la requête et la réponse fournies

Le bouton envoie du JSON ; le serveur valide et renvoie un état honnête.

Déployez le projet séparé ou lancez les outils locaux de fonctions. Ouvrir index.html comme fichier ne lance pas le serveur. Envoyez un nom synthétique et examinez la réponse réseau.

Le serveur renvoie 400 pour une entrée mal formée, 503 sans configuration, 502 pour un échec fournisseur et 202 pour l’acceptation. Le navigateur gère les échecs sans prétendre que l’e-mail est arrivé.

Exemple détaillé

L’interface affiche “Accepted by the mail provider. Check your test inbox.” (accepté par le fournisseur, vérifiez la boîte de test). Cela correspond au savoir du serveur à cet instant.

Extra implementation exercise

Le point d’accès renvoie 503. Commencez-vous par la couleur du bouton ou l’environnement serveur ?

Afficher une solution détaillée

Vérifiez les variables et l’expéditeur. L’apparence de l’interface ne peut fournir des identifiants manquants.

  • Vérifie d’abord la configuration serveur manquante.
  • Ne considère pas la requête échouée comme un e-mail terminé.

Étape 4

Examinez un message manquant

Cherchez l’état de livraison avant de multiplier les envois.

Utilisez delivery-record.txt pour relier la référence de test à l’état fournisseur, la destination et la vérification boîte/indésirables. Demandez de l’aide pour l’étape défaillante.

Un rebond ou une destination rejetée demande une investigation. Répéter aveuglément le même envoi peut produire du bruit sans réparer la livraison.

Un exemple concret

Accepté → rejet de livraison → aucune copie en boîte mène à l’examen de la livraison. Code d’exercice refusé → aucun événement fournisseur mène à la configuration d’accès. Ces observations appellent des contrôles différents.

Fichiers de cette étape

Start hereFichiers de l’atelier

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

How it works (optional)

Vérifiez livraison et échec

Reliez un clic, sa référence fournisseur et le message réellement reçu.

Trouvez le message accepté dans l’activité du fournisseur et examinez son état. Consultez ensuite la boîte configurée, indésirables compris. Notez séparément acceptation et copie reçue.

Essayez un nom vide via le formulaire et du JSON mal formé par une requête de développement. Dans une configuration jetable distincte, vérifiez l’échec propre sans identifiants. Ne partagez jamais des corps de réponse pouvant contenir des détails de compte.

Exemple détaillé

Un événement de livraison et son message reçu sont des preuves plus fortes qu’un bouton vert. Une acceptation sans copie reçue reste une enquête de livraison non résolue.

Extra implementation exercise

Le fournisseur indique un rejet pour la référence de test. Répéter immédiatement le même envoi est-il préférable ?

Afficher une solution détaillée

Examinez d’abord l’échec et les réglages du destinataire. Réessayez seulement après avoir identifié ce qui change ; des envois identiques ne réparent pas une destination invalide.

  • Examine la raison du rejet et la destination.
  • Évite les répétitions sans changement de diagnostic.

Étape 5

Ajoutez un sujet de message utile

Décrivez le comportement et faites-le mettre en œuvre par l’assistant.

Demandez deux choix de sujet : Project et Question, avec les valeurs project et question. Incluez le choix dans le corps du mail en conservant le destinataire fixe et la clé privée serveur. Faites tester par l’assistant la valeur non prise en charge other, sans l’ajouter aux choix autorisés.

Envoyez un test contrôlé par choix autorisé et inspectez le texte effectivement reçu. Un sujet non pris en charge et un code erroné doivent être refusés sans envoi fournisseur ; contrôlez ces tentatives négatives séparément.

Un exemple concret

La tâche autorise deux choix : Project et Question, stockés comme project et question. Le choix doit atteindre le corps du mail. Other est volontairement une valeur de rejet, pas une troisième option à ajouter.

Fichiers de cette étape

Start hereFichiers de l’atelier

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

How it works (optional)

Votre devoir : ajouter un détail de confirmation utile

Incluez un court sujet sans autoriser de destinataires ou HTML arbitraires.

Ajoutez un champ topic avec deux valeurs permises. Validez la liste au serveur et incluez le choix dans le texte brut. Gardez le destinataire fixe dans l’environnement.

Envoyez un test par valeur et une valeur non autorisée. Notez référence fournisseur et preuves réelles de livraison.

Modifiez d’abord vos fichiers de départ. Comparez ensuite select, JSON et liste serveur ligne par ligne à la référence. Celle-ci est une alternative complète pour vérifier, pas un dossier à coller aveuglément dans public/.

Exemple détaillé

Accepter seulement “project” et “question” est plus vérifiable que copier du contenu arbitraire dans tous les champs du courrier.

Le parcours de référence complet est disponible dans reference/assignment-walkthrough.txt. Comparez ses étapes avec votre résultat ; remplissez le relevé de test à partir de vos propres observations sur votre projet.

Extra implementation exercise

Étendez la confirmation avec un sujet validé et démontrez requêtes réussies et refusées.

Afficher une solution détaillée

L’extension utilise exactement 'project' et 'question'. Ajoutez select au formulaire, topic au JSON et validez cette liste au serveur avant l’appel fournisseur. La référence montre les changements complets.

Gardez TEST_RECIPIENT sous contrôle serveur même si une requête modifiée fournit une autre adresse. Un sujet permis et un bon code peuvent atteindre l’acceptation ; un sujet invalide doit renvoyer 400 sans appel fournisseur. Acceptation n’est pas réception en boîte.

Envoyez chaque sujet via votre compte de test, reliez sa référence au message reçu et notez honnêtement un rejet ou une attente. La référence étend un atelier restreint, pas un relais public de courrier.

  • Le serveur rejette les sujets non permis et conserve le destinataire fixe.
  • Les deux sujets autorisés figurent dans les messages reçus correspondants.

Cette leçon vous a-t-elle été utile ?

Laissez un J’aime ou partagez-la avec quelqu’un qui pourrait en profiter.

Poursuivre votre apprentissage

Explorer les autres leçons