For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /de/docs/web/setup-email.md (or send Accept: text/markdown).
E-Mail einrichten
Transaktionale Zustellung: Anbieter wählen, Absender verifizieren, jedes Template in der Vorschau sehen.
Einrichtung und Konfiguration
Lesen Sie vor jedem Schritt Bevor Sie beginnen und Terminal-Grundlagen. Bei diesen Anweisungen wird davon ausgegangen, dass Sie das vollständige Supastack-Monorepo in VS Code geöffnet haben. Sein Stamm package.json markiert den Repository-Stamm. In pnpm-Befehlen ist ein Arbeitsbereichspaket eine App oder ein Ordner mit gemeinsam genutztem Code. Im Produkt ist ein Arbeitsbereich der Datencontainer und die Sicherheitsgrenze eines Teams. corepack pnpm --filter ... wählt ein Paket aus dem Monorepo aus, während Befehle von seinem Stammverzeichnis aus ausgeführt werden. Wenn Sie nur einen synchronisierten Mobil- oder Desktop-Ordner geöffnet haben, enthält dieser weder das Web-Backend, Docker-Setup noch Root-Skripte: Führen Sie das Backend von diesem Monorepo oder einem erreichbaren gehosteten Server aus und verwenden Sie die eigenen Skripte des Plattformordners. Eine Umgebungsvariable ist eine benannte Einstellung, die in einer lokalen .env-Datei oder Ihrem Hosting-Dashboard gespeichert ist; Starten Sie die entsprechende App neu, nachdem Sie sie geändert haben, und halten Sie Servergeheimnisse von den Werten NEXT_PUBLIC_ und EXPO_PUBLIC_ fern.
1. Öffnen Sie apps/web/.env.local und stellen Sie EMAIL_PROVIDER=local für die Entwicklung ein. EMAIL_FROM ist die von Vorlagen verwendete Absenderbezeichnung.
2. Starten Sie die Web-App im Repository-Stammverzeichnis mit corepack pnpm --filter @supastack/web dev und lösen Sie einen Anmelde- oder Einladungsfluss mit einer Testadresse aus. Erwartet: Die App zeichnet ein lokales E-Mail-Ergebnis auf, ohne einen echten Anbieter zu kontaktieren. Verbinden Sie Resend, SES oder einen anderen Dienst erst, nachdem die Absenderdomäne überprüft und die Testempfänger eingeschränkt wurden.
EMAIL_PROVIDER=local hält deterministische Zustellung lokal. Prüfen Sie für konfigurierte Produktionszustellung den Resend- oder SES-Adapter und hinterlegen Sie dessen Server-Zugangsdaten. EMAIL_FROM muss zur Absenderidentität passen, die beim ausgewählten Provider verifiziert wurde.
EMAIL_PROVIDER=local
EMAIL_FROM=supastack <[email protected]>
# Production adapter configuration is listed in .env.example:
# RESEND_API_KEY= POSTMARK_SERVER_TOKEN= SENDGRID_API_KEY= BREVO_API_KEY=
# MAILGUN_API_KEY= MAILGUN_DOMAIN= MAILGUN_REGION=usBefehle zum Kopieren
Befolgen Sie die Kommentare, um zu sehen, in welchem Ordner ein Befehl ausgeführt wird. Wenn zwei Terminals gekennzeichnet sind, öffnen Sie zwei Terminalfenster und lassen Sie den ersten Befehl laufen, während Sie den zweiten verwenden.
corepack pnpm --filter @supastack/web devImplementierungsablauf
Authentifizierungs- und Abschlussnachrichten verwenden den Transaktions-E-Mail-Pfad. Outreach-Abläufe gehören zum jeweiligen Produkt und bleiben getrennt. Verwenden Sie diesen Pfad niemals ungeprüft als System für Massenversand.
Protokollieren Sie die Zustellung unabhängig von der Generierung. Ein Modellergebnis kann verfügbar sein, obwohl die Abschlussnachricht fehlschlägt. Die Wiederherstellung muss den Zustellstatus prüfen, statt dasselbe Ergebnis erneut zu generieren.
Überprüfung und Fehlerbehebung
Erscheint keine lokale E-Mail, prüfen Sie EMAIL_PROVIDER in apps/web/.env.local und starten Sie Web neu. Lehnt ein echter Anbieter eine Nachricht ab, bestätigen Sie, dass EMAIL_FROM einem verifizierten Absender entspricht, und prüfen Sie den Zustellbericht des Anbieters. Eine KI-Antwort kann erfolgreich sein, obwohl die Folge-E-Mail scheitert; prüfen Sie den Zustellstatus, bevor Sie die KI-Aufgabe erneut ausführen.
Prüfen Sie Empfängerbeschränkungen, Absenderidentität und Provider-Fehler in einer eigenen Testumgebung. Das Ergebnis eines lokalen Adapters belegt keine echte E-Mail-Zustellung. Der optionale Smoke-Pfad beschränkt Empfänger über REAL_SMOKE_EMAIL_ALLOWED_DOMAIN.
Wenn du die Einrichtung fortsetzen möchtest, lies OAuth-Anmeldung einrichten.