Resend Anleitung: API-Key, Domain-Verifizierung und erste E-Mail

👁 113 Aufrufe

Resend ist ein Dienst zum Versenden von E-Mails aus Anwendungen: Registrierungen, Passwort-Resets, Bestellbestätigungen, Benachrichtigungen. Die erste E-Mail versenden Sie in fünf Minuten, und am längsten dauert nicht der Code, sondern die Domain-Verifizierung. Diese Anleitung führt Sie durch den gesamten Prozess gemäß der offiziellen Resend-Dokumentation.

Bevor Sie beginnen: Zugriff auf DNS

Die häufigste Hürde beim Start mit Resend ist nicht der Code, sondern fehlender Zugriff auf die DNS-Einstellungen der Domain. Bevor Sie beginnen, prüfen Sie, wo Ihre Domain verwaltet wird und ob Sie dort Berechtigungen zum Hinzufügen von Einträgen haben. Falls sich eine Agentur oder die IT-Abteilung um die Domain kümmert, bitten Sie um Zugriff oder bereiten Sie sich darauf vor, die Liste der Einträge aus dem Resend-Panel weiterzugeben.

Legen Sie auch gleich fest, von welcher Adresse die E-Mails ausgehen sollen, zum Beispiel benachrichtigungen@ auf einer Versand-Subdomain.

Schritt 1: API-Key erstellen

Nach der Kontoerstellung erstellen Sie einen API-Key im Panel. Den Key speichern Sie in einer Umgebungsvariablen auf dem Server, zum Beispiel in einer Konfigurationsdatei der Anwendung, nicht im Code. Die Dokumentation und Anleitungen betonen dies nachdrücklich: Ein Key im Browser-Code ist öffentlich, und jeder, der ihn ausliest, kann E-Mails im Namen Ihrer Domain versenden.

Schritt 2: Bibliothek und erste E-Mail

Sie installieren die offizielle Bibliothek für Ihre Programmiersprache, zum Beispiel für Node.js über npm. Die erste E-Mail versenden Sie mit einem einzigen Aufruf mit Absender, Empfänger, Betreff und HTML-Inhalt. Für Tests können Sie von einer Resend-Testadresse versenden, ohne die Domain zu konfigurieren.

Hier lauert eine Falle, in die viele tappen: Von der Testadresse kommt die E-Mail nur bei der Adresse Ihres Kontos an. Der Versand an andere Personen vor der Domain-Verifizierung endet mit einem Fehler, der am ersten Tag rätselhaft wirkt.

Schritt 3: Domain verifizieren

Um von Ihrer eigenen Adresse zu versenden, fügen Sie die Domain im Resend-Panel hinzu. Im Tab mit den Einträgen erhalten Sie die beim DNS-Provider hinzuzufügenden Einträge: SPF- und DKIM-Einträge sowie einen Eintrag für Rückantworten. Kopieren Sie sie genau, am besten per Copy-Paste, denn ein einziger Tippfehler blockiert die Verifizierung.

Drei praktische Hinweise aus der Dokumentation:

• Resend empfiehlt eine separate Subdomain für den Versand, zum Beispiel send, statt der Hauptdomain,
• bei Cloudflare deaktivieren Sie den Proxy für CNAME-Einträge, sonst wird die Verifizierung nicht abgeschlossen,
• die Propagierung kann bis zu einem Tag dauern, und Warnungen über fehlende Einträge sind in dieser Zeit normal.

DMARC ist für die Verifizierung nicht erforderlich, aber es lohnt sich, ihn hinzuzufügen, da er die Glaubwürdigkeit Ihrer E-Mails verbessert.

Schritt 4: Templates mit React Email

Resend wurde vom selben Team erstellt, das auch React Email entwickelt hat, daher ist dies die empfohlene Methode zum Erstellen von Templates. Sie schreiben die E-Mail wie eine Komponente, mit Parametern wie Kundenname und Produktbezeichnung, und übergeben sie beim Versandaufruf. Resend wandelt sie automatisch in HTML um.

Schritt 5: Versandübersicht

Im Panel sehen Sie jede versendete Nachricht und ihren Status: zugestellt, abgelehnt, als Spam markiert. Bei Zustellproblemen ist dies die erste Anlaufstelle. Die Zustellbarkeit hängt auch von der Domain-Konfiguration und den Regeln des Empfängerservers ab, daher sind korrekte DNS-Einträge grundlegend.

Beispiel: Willkommens-E-Mail in der Anwendung

Die Anwendung soll nach der Registrierung eine Willkommens-E-Mail versenden. Sie erstellen einen Key, speichern ihn in einer Servervariablen und testen den Versand von der Testadresse an Ihre eigene Adresse. Sie fügen die Subdomain send im Panel hinzu, fügen die Einträge beim DNS-Provider ein und warten auf die Verifizierung. Das Willkommens-Template schreiben Sie in React Email mit dem Namen des Nutzers und einem Link zu den ersten Schritten. Nach der Verifizierung ändern Sie den Absender auf Ihre eigene Adresse.

In diesem Beispiel ist die Reihenfolge wichtig. Erst Test von der Testadresse an das eigene Postfach, dann Domain-Verifizierung, zum Schluss Änderung des Absenders. So können Sie Code schreiben und testen, bevor die DNS-Einträge propagiert sind, und die Umstellung auf die eigene Adresse ist nur eine Konfigurationsänderung. Es lohnt sich auch, die Willkommens-E-Mail gleich an mehrere verschiedene Postfächer zu senden und zu prüfen, ob sie auch auf dem Smartphone gut aussieht.

Häufigste Fehler

• API-Key im Browser-Code.
• Versandtest an andere Personen vor der Domain-Verifizierung.
• Tippfehler in DNS-Einträgen.
• Aktivierter Cloudflare-Proxy für Verifizierungseinträge.

Wie Sie prüfen, ob alles funktioniert

Nach der Domain-Verifizierung versenden Sie Test-E-Mails an mehrere verschiedene Postfächer: Gmail, Outlook, ein Firmen-Postfach. Prüfen Sie, ob sie im Posteingang landen und nicht im Spam, und ob sie auf dem Smartphone gut aussehen. Im Resend-Panel sehen Sie den Status jeder Nachricht.

In den ersten Tagen nach der Implementierung schauen Sie täglich ins Panel. Abgelehnte E-Mails und Spam-Meldungen, die früh erkannt werden, lassen sich leicht beheben, ignorierte schädigen die Reputation der Domain.

Wenn die grundlegenden E-Mails funktionieren, lohnt es sich, für jeden Nachrichtentyp ein eigenes Template zu erstellen, statt eines universellen. Eine E-Mail zum Passwort-Reset und eine Bestellbestätigung haben unterschiedliche Aufgaben, und separate Templates lassen sich leichter anpassen und testen.

// weiterlesenSupabase Tutorial: Erste Tabelle, Sicherheit und App-AnbindungAnleitungenWenn KI den Schmerz liest: Das erste objektive System zur SchmerzmessungAlgorithmenJUNOs erste Neutrino-Resultate: Wie ein unterirdischer Riese das Massenrätsel knacken willPhysik

Kinetyra