Gemeinsames Resend-Portfolio
Implementiere E-Mails für mehrere Produkte mit einem einzigen Resend-Konto und einer bestätigten Domäne. Optimiere für Solo-Entwickler oder kleine Portfolios, die den Free-Tarif nutzen, ohne dass jede App wie dasselbe Produkt aussieht.
Kernmodell
Teile die Infrastruktur, nicht die Produktidentität:
Ein Resend-Konto
└── Bestätigte Absenderdomäne
├── Produkt-A Absenderidentität
├── Produkt-B Absenderidentität
└── Produkt-C Absenderidentität
Jede App behält ihre eigenen:
- Anzeigenamen des Absenders
- Zielpostfach
- Reply-To-Weiterleitung
- Betreffkonventionen
- Gebrandete HTML- und Klartextvorlagen
- Umgebungsvariablen für die Bereitstellung
- Zustell-Logs und Fehlerverhalten
Alle Apps teilen sich das Kontingent des Free-Tarifs auf Kontenebene und den Ruf der bestätigten Domäne.
Portfolio-Erkundung
Vor der Implementierung:
- Untersuche die Ziel-App und jede Schwester-App mit einem funktionierenden Resend-Setup.
- Identifiziere das kanonische Resend-Konto und die bereits bestätigte Domäne.
- Bestätige den Produkt-Anzeigenamen, das gemeinsame Absenderpostfach, den internen Empfänger, das Support-Reply-To-Postfach und die erwarteten E-Mail-Typen.
- Bestätige, ob die Zielbereitstellung bereits einen Resend-API-Key hat.
- Bitte den Benutzer nicht, ein weiteres Konto zu erstellen, eine weitere Domäne zu bestätigen oder einen Tarif zu kaufen, es sei denn, das bestehende Konto kann eine angegebene Anforderung nicht erfüllen.
Konto- und Schlüsselstrategie
Verwende dasselbe Resend-Konto und dieselbe bestätigte Domäne wieder. Bevorzuge einen separaten API-Key pro bereitgestellter App, wenn das Konto dies zulässt; dies begrenzt die Auswirkungen eines geleakten oder rotierten Schlüssels, während man bei einem Konto und Kontingent bleibt. Verwende denselben Schlüssel nur dann wieder, wenn separate Schlüssel nicht verfügbar sind oder der Benutzer diesen Kompromiss explizit bevorzugt.
Kopiere niemals Geheimnisse aus einem anderen Repository in die Quellcodeverwaltung. Füge den ausgewählten Schlüssel direkt in die geheimen Umgebungsvariablen jeder Bereitstellung ein.
Produktspezifische Konfiguration
Verwende server-seitige Variablen und produktspezifische Namen, wo praktikabel. Löse deren Werte aus dem bestehenden Resend-Konto des Benutzers, der bestätigten Absenderkonfiguration und dem beabsichtigten Produktpostfach auf – kopiere niemals Beispielidentitäten in eine Implementierung.
| Variablenrolle | Zweck |
|---|---|
| Resend-API-Key | Authentifiziert den serverseitigen Provider-Aufruf |
| Produkt-Absenderidentität | Kombiniert den Anzeigenamen des aktuellen Produkts mit einer Adresse auf der bestehenden bestätigten Domäne |
| Produkt-Kontaktempfänger | Empfängt die internen Benachrichtigungen dieses Produkts |
| Produkt-Antwortadresse | Empfängt Antworten auf benutzerseitige Nachrichten, wenn sie sich vom Kontaktempfänger unterscheidet |
Der sichtbare Anzeigename liefert die Produktidentität; die bestehende bestätigte Adresse liefert die Zustellbarkeit. Verwende niemals eine NEXT_PUBLIC_ oder eine äquivalente clientseitig exponierte Variable für einen API-Key.
Kontaktformular-Routing
Sende zwei separate Nachrichten:
Interne Benachrichtigung
Von: konfigurierte Produkt-Absenderidentität
An: konfiguriertes internes Produktpostfach
Reply-To: validierte, vom Besucher eingegebene Adresse
Bestätigung für den Besucher
Von: konfigurierte Produkt-Absenderidentität
An: validierte, vom Besucher eingegebene Adresse
Reply-To: konfiguriertes internes Produktpostfach
Setze den Besucher und das interne Postfach nicht in eine einzige Empfängerliste. Getrennte Nachrichten verhindern die Offenlegung von Adressen und ermöglichen unterschiedliche Inhalte.
Behandle die interne Benachrichtigung als primäre Zustellung. Gib den Formularerfolg erst zurück, nachdem Resend sie akzeptiert und eine Nachrichten-ID zurückgegeben hat. Versuche danach die Bestätigung für den Besucher; protokolliere ihren Fehler, ohne zu behaupten, dass die primäre Anfrage verloren gegangen sei.
Markenisolation
Erstelle für jedes Produkt eine eigene Vorlagenhülle, während das Provider-Modul-Muster wiederverwendbar bleibt. Passe Folgendes an:
- Produktname und Beschreibung
- Farben, Typografie und Kopfzeilenbehandlung
- E-Mail-Vorschautext
- Betreff und Ton
- Fußzeilen-Impressum, Support-Adresse und Reaktionserwartungen
Verwende Tabellenlayouts, Inline-CSS, eine Inhaltsbreite von 600–640 Pixeln, maskierte Benutzerwerte und eine Klartextversion. Verwende nicht die visuelle Identität eines anderen Produkts, nur weil die Sendeinfrastruktur gemeinsam genutzt wird.
Sicherheitsvorkehrungen für den gemeinsamen Free-Tarif
- Überprüfe die aktuellen Resend-Free-Tarif-Grenzen, anstatt dich auf gespeicherte Zahlen zu verlassen.
- Bedenke, dass jede App das gleiche Kontingent verbraucht.
- Sende nur notwendige transaktionale Nachrichten; vermeide doppelte Benachrichtigungen.
- Behalte Anti-Spam-Kontrollen auf öffentlichen Formularen bei: Validierung, Längenbeschränkungen, Honeypot sowie gegebenenfalls Ratenbegrenzung.
- Vermeide Wiederholungsschleifen, die Duplikate senden können. Verwende Persistenz oder Idempotenz, wo der Workflow ein sinnvolles Wiederholungsrisiko aufweist.
- Überwache Provider-Ablehnungen und Kontingentfehler, ohne Geheimnisse oder unnötige persönliche Daten zu protokollieren.
- Wechsle zu einem anderen Konto oder einem kostenpflichtigen Tarif nur, wenn der gemessene Bedarf, die Isolierung, die Compliance oder die Rufanforderungen dies rechtfertigen.
Zuverlässige Implementierung
- Installiere das offizielle
resend-Paket im richtigen Workspace. - Halte Provider-Aufrufe in einem server-seitigen Modul.
- Validiere
result.data?.idund stelle sicher, dassresult.errornicht vorhanden ist. - Fange SDK- und Netzwerkausnahmen ab.
- Setze
replyToexplizit. - Gib
503zurück, wenn E-Mail nicht konfiguriert ist, und502, wenn die primäre Zustellung fehlschlägt. - Halte direkte E-Mail-, Telefon- oder Messaging-Fallbacks in der UI bereit.
- Melde eine reine Log-Behandlung niemals als erfolgreiche Zustellung.
Verifizierung
- Bestätige, dass die gemeinsame Domäne im wiederverwendeten Resend-Konto bestätigt ist.
- Bestätige die produktspezifischen Von-, An- und Reply-To-Werte.
- Teste die interne Zustellung, dann die Besucherbestätigung, dann das Antworten in beide Richtungen.
- Teste Validierung, Honeypot, fehlenden Key, Provider-Ablehnung und Fallback-Pfade.
- Führe repository-eigene Typüberprüfungs-, Lint-, Test- und Build-Befehle aus.
- Bestätige, dass die Bereitstellung ihren API-Key und die Produktvariablen enthält.
- Führe eine echte Übermittlung durch, bevor du behauptest, dass die Live-Zustellung funktioniert.