Mini-Lektion · Deutsch

So sendest du automatisierte E-Mails von deiner Website

Starte ein bereitgestelltes E-Mail-Projekt mit einem Assistenten, sende eine kontrollierte Bestätigung und überprüfe ihren Eingang in deinem Postfach.

Interaktive Lektion startenLektionsnotizen lesen

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.

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.

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.

Was du lernen wirst

  • 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.

Workshop-Dateien

Schritt 1

Wähle eine E-Mail-Aktion

Beginne mit einer festen, kontrollierten Bestätigung.

Ö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.

Resend: E-Mail senden

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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

How it works (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

Extra implementation exercise

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 2

Richte das fertige Projekt ein und starte es

Lass den Assistenten die Serveranbindung übernehmen.

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.

Node.js: Status unterstützter Veröffentlichungen

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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

How it works (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

Extra implementation exercise

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 3

Sende einen wiedererkennbaren Test

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

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

Start hereWorkshop-Dateien

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

How it works (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.

Extra implementation exercise

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 4

Untersuche eine fehlende Nachricht

Prüfe den Zustellstatus, bevor du wiederholt sendest.

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

Start hereWorkshop-Dateien

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

How it works (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.

Extra implementation exercise

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 5

Ergänze ein nützliches Nachrichtenthema

Beschreibe das Verhalten und lass es den Assistenten umsetzen.

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

Start hereWorkshop-Dateien

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

How it works (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.

Extra implementation exercise

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.

Weiterlernen

Weitere Lektionen entdecken