LektionenSo sendest du automatisierte E-Mails von deiner Website

Mini-Lektion 9 von 30 · Deine Website nützlich machen

Wähle eine E-Mail-Aktion

Für wen ist das gedacht?

Für alle, bei denen eine Websiteaktion eine E-Mail auslösen soll. Der Servercode wird bereitgestellt und ein Programmierassistent kann ihn konfigurieren; du musst kein E-Mail-Backend schreiben.

Beginne mit einer festen, kontrollierten Bestätigung.

Ziel dieser Lektion

  • Richte einen von dir verwalteten Absender und Empfänger ein.
  • Löse eine echte Test-E-Mail aus und prüfe die Zustellung.
  • Behandle fehlgeschlagene Anfragen, ohne den Eingang einer Nachricht vorzutäuschen.
Erklärung, ausgearbeitetes Beispiel und Übung

Bevor du beginnst

Du brauchst ein eigenes Resend-Konto, einen verifizierten Absender und ein Testpostfach. Nutze das vollständige separate Netlify-Functions-Projekt und einen Programmierassistenten für die Einrichtung. Verfügbarkeit und Nutzungsbedingungen des Anbieters gelten. Die Musterantworten veranschaulichen mögliche Ergebnisse; sie sind keine bereits durchgeführten Tests in deinem Konto. Ersetze die Beispielbeobachtungen durch deine eigenen Ergebnisse oder benenne den noch blockierten Schritt.

Prüfe deine Vorkenntnisse

Diese Fähigkeiten sind hilfreich; ein Kursabschluss wird nicht erzwungen. Beherrschst du sie schon, starte hier. Sonst öffne die Vorbereitung. Eine eigene bestehende Website ist dank der Startdateien nicht nötig.

  1. So veröffentlichst du deine Website über GitHub

    Verbinde ein Übungsrepository mit einem Hostingdienst.

  2. So richtest du E-Mail auf deiner eigenen Domain ein

    Wähle und konfiguriere ein echtes Postfach zum Senden und Empfangen.

Geschätzte Dauer: 21–38 Min.

Schätzungen für die mitgelieferten Startdateien bei bereits eingerichteten Konten und Werkzeugen. Einrichtung, Deployment-Warteschlangen sowie E-Mail- und DNS-Wartezeiten kommen hinzu. Absenderverifizierung und Zustellwartezeit kommen hinzu. Anbietergebühren und -limits hängen vom Konto ab.

Die Idee verstehen

Öffne das bereitgestellte Projekt mit deinem Assistenten und entscheide, welches Ereignis die Testbestätigung auslösen soll. Nutze nur das eingerichtete Betreiberpostfach; Besucher sollen keine beliebigen Empfänger wählen können.

Unterscheide die Annahme einer Anfrage durch den Anbieter vom Eingang einer Nachricht im Postfach.

Ein konkretes Beispiel

Die mitgelieferte Aktion sendet eine feste Workshop confirmation an den serverseitig eingerichteten Empfänger. Der Formularbesucher gibt einen Namen an, kein beliebiges Versandziel. Eine zurückgegebene Nachrichtenreferenz hilft beim Nachverfolgen, beweist aber keinen Empfang.

Öffne diesen vollständigen E-Mail-Workshop. Folge run-locally.txt und erkläre die privaten Werte für Absender, Empfänger, Anbieterschlüssel und Übungscode. Halte sie aus öffentlichen Dateien heraus. Hilf mir, das Projekt zu starten und nur mein eigenes eingerichtetes Testpostfach anzusteuern. Prüfe Anbieterannahme und tatsächliche Postfachzustellung getrennt, einschließlich eines abgewiesenen Versuchs.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Was löst deinen Test aus, und wo prüfst du Annahme und Eingang?

Ausgearbeitete Lösung anzeigen

Beispielplan: Ich gebe den Übungszugangscode und den erfundenen Namen Alex ein und aktiviere Request test email. Der serverseitige TEST_RECIPIENT ist mein kontrolliertes Postfach. Ich ordne die zurückgegebene Anbieterreferenz ihrem Ereignis und der tatsächlich empfangenen E-Mail zu.

Was eine gute Antwort enthält

  • Benennt die konkrete kontrollierte Formularaktion und das serverseitig eingerichtete Ziel.
  • Nennt die Anbieterannahme und den tatsächlichen Postfachempfang als getrennte Prüfpunkte.
So funktioniert es (optional)

Sende nach einer Website-Aktion eine E-Mail

Eine Serverfunktion verwandelt eine akzeptierte Anfrage in einen Mailanbieteraufruf.

Der Browser sollte eine bestimmte Aktion anfordern und keine privilegierten E-Mail-Zugangsdaten halten. In dieser Übung übermittelt er einen Namen an eine Serverfunktion, die eine Klartextbestätigung an dein festgelegtes eigenes Postfach sendet.

Resend ist der Beispielweg. Ein anderer Transaktionsanbieter kann dieselbe Rolle erfüllen, aber Authentifizierung, Absenderprüfung und Zustellereignisse unterscheiden sich. Ein menschliches Postfach ist ein separater Dienst.

Ausgearbeitetes Beispiel

Die Antwort „angenommen“ bedeutet, dass der Anbieter die Versandanfrage akzeptiert hat. Sie beweist keinen Postfachempfang. Diese Grenze prüfen wir getrennt.

Resend: E-Mail senden

Zusätzliche technische Übung

Der Anbieter hat eine Nachrichten-ID zurückgegeben, aber du hast das Postfach nicht geprüft. Was kannst du ehrlich behaupten?

Ausgearbeitete Lösung anzeigen

Der Anbieter hat eine Anfrage mit diesem Verweis angenommen. Zustellung bleibt ungeprüft, bis du Zustellbelege und Testpostfach untersuchst.

  • Behauptet Annahme statt bestätigter Postfachzustellung.
  • Bewahrt einen Nachrichtenverweis für die Zustellprüfung auf.

Schritt 1 · So sendest du automatisierte E-Mails von deiner Website

Richte das fertige Projekt ein und starte es

Lass den Assistenten die Serveranbindung übernehmen.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Folge mit deinem Assistenten run-locally.txt. Trage die privaten Kontowerte anhand von server-env.example.txt ein, starte dann das vollständige Projekt und öffne seine tatsächliche lokale URL.

Halte den Anbieterschlüssel und den festen Empfänger auf dem Server. Der Übungscode des Formulars ist vom Anbieterschlüssel getrennt; eine Dateivorschau führt den E-Mail-Dienst nicht aus.

Ein konkretes Beispiel

Serverwerte bestimmen Absender, Empfänger und Anbieterzugang. Der separate Übungscode erlaubt diesen auf den Eigentümer begrenzten Test. Weder ein verstecktes Browserfeld noch eine reine Dateivorschau führt diese private Servereinrichtung aus.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Ist das Projekt gestartet, und welcher Einrichtungsschritt ist abgeschlossen oder noch blockiert?

Ausgearbeitete Lösung anzeigen

Beispieleinrichtungsprotokoll: Der lokale Proxy startete und gab die App-URL aus. Die private Umgebung enthält meinen verifizierten Absender, kontrollierten Empfänger, Anbieterschlüssel und separat erzeugten Übungscode. Nur dieser Code gehört ins Formular. Meldet die App Mail not configured, sind private Absender-, Schlüssel- oder Empfängereinstellungen noch unvollständig.

Was eine gute Antwort enthält

  • Beschreibt, ob das vollständige servergestützte Projekt unter seiner ausgegebenen URL gestartet ist.
  • Unterscheidet privaten Anbieterschlüssel und festen Empfänger vom separaten Übungscode im Formular.
So funktioniert es (optional)

Konfiguriere einen eingeschränkten Übungsabsender

Halte Absenderzugangsdaten und Testempfänger außerhalb des öffentlichen Ordners.

Lokale Checkliste: Prüfe Node- und npm-Installation, installiere beziehungsweise prüfe Netlify CLI und folge dann vor dem Absenden run-locally.txt. Zuerst die statische Seite zu öffnen hilft beim Layout, testet aber nicht ihre Serverfunktion.

Lies netlify/functions/mini-mail.mjs. Konfiguriere Mail-Umgebungsvariablen und einen nicht erratbaren LAB_TOKEN mit mindestens 24 Zeichen in deinem eigenen Hosting-Projekt. MAIL_FROM muss beim Anbieter berechtigt sein; TEST_RECIPIENT ist dein Testpostfach. Trage den API-Schlüssel nicht in public/app.js ein.

Der Nutzer gibt den separaten Übungszugangscode ein; er wird nie im Seitenbundle ausgeliefert und ist nicht dein Resend-Schlüssel. Die Funktion ignoriert vom Aufrufer gelieferte Ziele bewusst. Sie validiert ein kleines Namensfeld und erzeugt Klartext. Ergänze vor öffentlicher Veröffentlichung dauerhafte Anfragelimits und prüfe Kontingente; die Eigentümerübung ist kein vollständiges Missbrauchsschutzsystem.

Das Ziel steht bewusst unter Serverkontrolle. Eine manipulierte Browseranfrage kann to='somewhere-else' ergänzen; die Funktion baut aber ihre eigenen Anbieternutzdaten und nutzt TEST_RECIPIENT. Das verhindert beliebige Empfänger durch Übungsaufrufer; öffentlicher Zugriff bräuchte weiterhin dauerhaften Missbrauchsschutz.

Öffne für die vollständige lokale Reihenfolge run-locally.txt: Bereite die private Umgebung im Stamm vor, verknüpfe ausschließlich das Übungsprojekt und starte den Netlify-Funktionsproxy. server-env.example.txt führt Variablennamen ohne echte Geheimnisse auf. Nur das HTML zu öffnen kann den Server nicht ausführen.

Ausgearbeitetes Beispiel

Ein Angreifer kann durch Änderung einer Browseranfrage die Übungs-E-Mail nicht umleiten, weil der Empfänger aus der Serverumgebung stammt. Eine in JavaScript versteckte Adresse würde diesen Schutz nicht bieten.

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

Node.js: Status unterstützter Veröffentlichungen

Zusätzliche technische Übung

Würde das Verschieben des Schlüssels in ein verstecktes Eingabefeld ihn privat halten?

Ausgearbeitete Lösung anzeigen

Nein. Versteckte Formularfelder werden weiterhin an den Browser ausgeliefert. Halte die Zugangsdaten in der Serverumgebung und führe den Anbieteraufruf dort aus.

  • Erkennt die Untersuchbarkeit an den Browser gelieferter Werte.
  • Verlagert privilegierte Nutzung in die Serverumgebung.

Schritt 2 · So sendest du automatisierte E-Mails von deiner Website

Sende einen wiedererkennbaren Test

Nutze die Oberfläche und halte die Nachweise miteinander verknüpft.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Löse die Bestätigung auf der tatsächlich laufenden Seite aus. Speichere ihre Testreferenz und prüfe das entsprechende Anbieterereignis und die Postfachkopie.

Schlägt die Anfrage fehl, erhalte den sichtbaren Fehler und genügend Kontext für einen neuen Versuch. Behebe einen nicht verfügbaren Dienst nicht durch eine erfundene Erfolgsmeldung.

Ein konkretes Beispiel

Für den erfundenen Namen Alex lautet der E-Mail-Text des Starters „Hello Alex. Your practice request was received.“ Vergleiche die tatsächlich empfangene Kopie mit dem passenden Versuch, nicht mit einer älteren E-Mail.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Was zeigten Seite, Anbieter und Postfach jeweils für deinen Versuch?

Ausgearbeitete Lösung anzeigen

Beispielversuchsprotokoll: Die Seite meldete die Annahme beim Anbieter mit einer Referenz. Das passende Anbieterereignis existiert. Mein kontrolliertes Postfach enthält Workshop confirmation mit „Hello Alex. Your practice request was received.“ Fehlte die Postfachkopie, würde ich angenommen, aber Zustellung ungelöst notieren.

Was eine gute Antwort enthält

  • Ordnet Seitenantwort, Anbieterereignis und tatsächlichen Postfachbefund demselben Versuch zu.
  • Benennt eine fehlgeschlagene Stufe, ohne einen Fehler oder eine angenommene ID als Zustellung auszugeben.
So funktioniert es (optional)

Verfolge mitgelieferte Anfrage und Antwort

Die Schaltfläche sendet JSON; der Server validiert und liefert einen ehrlichen Status.

Veröffentliche das separate Projekt oder starte es mit den lokalen Funktionswerkzeugen des Hosts. index.html als lokale Datei zu öffnen führt das Backend nicht aus. Sende einen synthetischen Namen und untersuche die Netzwerkantwort.

Der Server liefert 400 für fehlerhafte Eingaben, 503 für fehlende Konfiguration, 502 für einen fehlgeschlagenen Anbieteraufruf und 202 bei Annahme der Nachricht. Der Browser behandelt Fehler ohne vorzutäuschen, dass die E-Mail angekommen ist.

Ausgearbeitetes Beispiel

Die Übungsoberfläche sagt „Accepted by the mail provider. Check your test inbox.“ — vom Anbieter angenommen, Testpostfach prüfen. Das entspricht dem Wissensstand des Servers.

Zusätzliche technische Übung

Der Endpunkt liefert 503. Solltest du zuerst die Schaltflächenfarbe ändern oder die Serverumgebung prüfen?

Ausgearbeitete Lösung anzeigen

Prüfe konfigurierte Umgebungsvariablen und Absendereinrichtung. Das Aussehen der Oberfläche kann fehlende Serverzugangsdaten nicht liefern.

  • Prüft zuerst fehlende Serverkonfiguration.
  • Behandelt die fehlgeschlagene Anfrage nicht als abgeschlossene E-Mail.

Schritt 3 · So sendest du automatisierte E-Mails von deiner Website

Untersuche eine fehlende Nachricht

Prüfe den Zustellstatus, bevor du wiederholt sendest.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Ordne in delivery-record.txt die Testreferenz dem Anbieterstatus, Ziel und der Posteingangs- beziehungsweise Spamprüfung zu. Bitte deinen Assistenten um Hilfe bei der fehlgeschlagenen Stufe.

Ein Rückläufer oder ein abgewiesenes Ziel müssen untersucht werden. Blindes Wiederholen desselben Versands kann Unordnung erzeugen, ohne die Zustellung zu beheben.

Ein konkretes Beispiel

Angenommen → zurückgewiesen → keine Postfachkopie führt zur Zustelluntersuchung. Übungscode abgelehnt → kein Anbieterereignis führt zur Zugangseinrichtung. Diese Beobachtungen verlangen unterschiedliche nächste Prüfungen.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Welcher beobachtete Zustellstatus erklärt den nächsten Schritt für deinen Test?

Ausgearbeitete Lösung anzeigen

Beispieldiagnose: Der Anbieter nahm den Versuch an, sein Ereignis meldet jetzt jedoch einen Bounce, und im kontrollierten Postfach fehlt die Kopie. Vor dem nächsten Senden prüfe ich das eingerichtete Ziel und dieses Zustellereignis. Das unterscheidet sich von einem abgelehnten Übungscode, der den E-Mail-Anbieter gar nicht erreichen sollte.

Was eine gute Antwort enthält

  • Verwendet passenden Anbieterstatus sowie Ziel- und Postfachprüfungen zur Diagnose des aktuellen Zustellzustands.
  • Wählt den nächsten Schritt an der beobachteten Fehlerstufe, statt blind erneut zu senden.
So funktioniert es (optional)

Prüfe Zustellung und Fehler

Verbinde einen Klick, seinen Anbieterverweis und die tatsächlich empfangene Nachricht.

Finde die angenommene Nachricht in der Anbieteraktivität und untersuche ihren Zustellzustand. Prüfe dann das konfigurierte Testpostfach einschließlich Spam. Protokolliere Annahme und empfangene Kopie getrennt.

Teste einen leeren Namen im normalen Formular und fehlerhaftes JSON über eine Entwickleranfrage. Prüfe in einer separaten entbehrlichen Konfiguration sauberes Scheitern bei fehlenden Zugangsdaten. Teile niemals Anbieterantwortinhalte mit möglichen Kontodetails.

Ausgearbeitetes Beispiel

Ein Zustellereignis und eine passende empfangene Nachricht sind stärkere Belege als eine grüne Schaltfläche. Anbieterannahme ohne empfangene Kopie bleibt eine offene Zustelluntersuchung.

Zusätzliche technische Übung

Der Anbieter meldet einen Bounce für den Testverweis. Ist sofortiges Wiederholen desselben Versands der beste nächste Schritt?

Ausgearbeitete Lösung anzeigen

Prüfe zuerst gemeldeten Fehler und Empfängerkonfiguration. Wiederhole erst nach Klärung der Änderung; identische wiederholte Sendungen reparieren kein ungültiges Ziel.

  • Untersucht Bounce-Grund und Ziel.
  • Vermeidet wiederholte Anfragen ohne neue Diagnose.

Schritt 4 · So sendest du automatisierte E-Mails von deiner Website

Ergänze ein nützliches Nachrichtenthema

Beschreibe das Verhalten und lass es den Assistenten umsetzen.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Bitte den Assistenten, zwei Themen hinzuzufügen: Project und Question mit den Werten project und question. Übernimm den gewählten Wert in den Bestätigungstext und erhalte den festen Serverempfänger und privaten Schlüssel. Lass dir beim Testen des nicht unterstützten Werts other helfen, ohne ihn als zulässige Auswahl hinzuzufügen.

Sende pro zulässiger Auswahl einen kontrollierten Test und prüfe den tatsächlich empfangenen Text. Das nicht unterstützte Thema und ein falscher Übungscode sollen ohne Versand beim Anbieter abgelehnt werden; prüfe diese negativen Versuche getrennt.

Ein konkretes Beispiel

Die Aufgabe hat zwei zulässige Optionen: Project und Question, gespeichert als project und question. Der gewählte Wert muss den E-Mail-Text erreichen. Other ist ein absichtlich nicht unterstützter Testwert, keine dritte hinzuzufügende Option.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Lege deine Themenänderung und die tatsächlichen Ergebnisse erfolgreicher und abgewiesener Tests vor.

Dein Ergebnis: Die funktionierende Testaktion und eine um vertrauliche Angaben bereinigte Anbieter-, Postfach- und Fehleraufzeichnung.

Ausgearbeitete Lösung anzeigen

Beispielerweiterungsprotokoll: Project erzeugte „Hello Alex. Your project request was received.“ Question erzeugte den entsprechenden question-Text in einer separaten kontrollierten E-Mail. Das nicht unterstützte Thema other und ein falscher Übungscode wurden ohne passenden Anbieterversand abgelehnt. Beide erlaubten Optionen nutzen weiterhin den fest eingerichteten Empfänger.

Was eine gute Antwort enthält

  • Ergänzt genau Project/Question und prüft den gewählten Wert im tatsächlich empfangenen Inhalt.
  • Prüft, dass ein nicht unterstütztes Thema und ein falscher Übungscode keine Nachricht versenden.
So funktioniert es (optional)

Deine Aufgabe: ergänze ein sinnvolles Bestätigungsdetail

Nimm ein kurzes Anfragethema auf, ohne beliebige Empfänger oder HTML zu erlauben.

Ergänze ein Themenfeld mit zwei erlaubten Werten. Validiere die Zulassungsliste auf dem Server und nimm den gewählten Wert in die Klartextbestätigung auf. Halte den Empfänger fest in der Umgebung.

Sende einen passenden Test pro Wert und einen nicht unterstützten Wert. Protokolliere Anbieterverweis und tatsächlichen Zustellbeleg.

Bearbeite zuerst deine Ausgangsdateien. Vergleiche dann Themenauswahl, Anfrage-JSON und Serverzulassungsliste Zeile für Zeile mit der Referenz. Der Referenzordner ist eine vollständige Alternative zum Prüfen deiner Arbeit und kein blind nach public/ zu kopierender Zusatzordner.

Ausgearbeitetes Beispiel

Nur „project“ und „question“ zu akzeptieren ist leichter prüfbar, als beliebigen Aufruferinhalt in jedes E-Mail-Feld zu kopieren.

Die vollständige exemplarische Anleitung findest du in reference/assignment-walkthrough.txt. Vergleiche ihre Schritte mit deinem Ergebnis und fülle das Testprotokoll mit Beobachtungen aus deinem eigenen Projekt aus.

Zusätzliche technische Übung

Erweitere die Bestätigung um ein validiertes Thema und zeige erfolgreiche und abgelehnte Anfragen.

Ausgearbeitete Lösung anzeigen

Die Themenerweiterung nutzt genau zwei erlaubte Werte: „project“ und „question“. Ergänze die Auswahl im Formular, nimm topic ins JSON auf und validiere die Zulassungsliste auf dem Server vor dem Mailanbieteraufruf. Referenzfrontend und -funktion zeigen alle Änderungen.

Halte TEST_RECIPIENT serverkontrolliert, auch wenn eine manipulierte Anfrage eine andere Adresse liefert. Ein erlaubtes Thema und gültiger Übungscode können Anbieterannahme erreichen; ein nicht unterstütztes Thema muss 400 ohne Anbieteraufruf liefern. Annahme ist kein Postfachempfang.

Sende jedes erlaubte Thema über dein eigenes Testkonto, ordne den Anbieterverweis der tatsächlich empfangenen Nachricht zu und protokolliere Bounce oder ausstehenden Zustand ehrlich. Der Referenzcode ist eine eingeschränkte Übungserweiterung und kein öffentliches Mail-Relay.

  • Der Server weist nicht unterstützte Themen ab und behält den festen Empfänger.
  • Beide erlaubten Themen erscheinen in passenden empfangenen Nachrichten.

War diese Lektion hilfreich?

Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.