Erster Versand per SMTP
Sie brauchen
Abschnitt betitelt „Sie brauchen“- Ein Projekt mit verbundener Domain und Versandberechtigung für Ihre Absenderadresse.
- Einen SMTP-Zugang für diesen Absender: einen Benutzernamen, der
mit
smtp_beginnt, und ein Passwort, das einmal angezeigt wird. SMTP-Zugänge können nur senden, nicht die API aufrufen.
Die Seite View SMTP settings des Zugangs zeigt diese Werte ausgefüllt, mit Beispielen.
Schneller Terminal-Test
Abschnitt betitelt „Schneller Terminal-Test“Öffnen Sie API keys & SMTP → View SMTP settings. Kopieren Sie den SMTP test command, ersetzen Sie you@example.com durch Ihre Empfängeradresse und führen Sie ihn aus. curl fragt nach Ihrem gespeicherten SMTP-Passwort. Server, Verschlüsselung, Benutzername und Absender sind vorausgefüllt; Node.js ist nicht erforderlich.
Der Befehl enthält eine feste Nachrichten-ID und ein Datum. Verwenden Sie bei einem erneuten Versuch denselben Befehl und Empfänger. Prüfen Sie bei unklarem Ergebnis zuerst Messages. Verbindungsdaten und Nodemailer-/GoTrue-Beispiele finden Sie unter Connection settings and application examples.
Einstellungen
Abschnitt betitelt „Einstellungen“| Einstellung | Wert |
|---|---|
| Host | smtp.weneed.email |
| Port | 587 mit STARTTLS oder 465 mit implizitem TLS |
| Verschlüsselung | Pflicht, TLS 1.2 oder neuer; Zertifikatsprüfung eingeschaltet lassen |
| Authentifizierung | PLAIN oder LOGIN, nur nach TLS |
| Absender (From) | muss exakt Ihrer freigegebenen Absenderadresse entsprechen |
Beispiel mit Nodemailer
Abschnitt betitelt „Beispiel mit Nodemailer“import { createHash } from 'node:crypto';import nodemailer from 'nodemailer';
// Ein Key pro beabsichtigter Nachricht. Speichern Sie ihn und den Zeitpunkt des ersten Versuchs// mit dem Ereignis, damit eine Wiederholung genau dieselbe Nachricht sendet.const key = 'signup-7f3c2a91-welcome';const firstAttempt = new Date(storedFirstAttemptTime);const messageId = `<${createHash('sha256').update(key).digest('hex')}@ihredomain.at>`;
const transport = nodemailer.createTransport({ host: 'smtp.weneed.email', port: 587, secure: false, // auf 587 wird STARTTLS ausgehandelt; für implizites TLS 465 mit secure: true requireTLS: true, tls: { minVersion: 'TLSv1.2' }, auth: { user: process.env.WENEED_SMTP_USER, pass: process.env.WENEED_SMTP_PASSWORD },});
const info = await transport.sendMail({ from: 'hallo@ihredomain.at', to: 'person@example.com', subject: 'Willkommen', text: 'Danke für Ihre Anmeldung.', messageId, date: firstAttempt, headers: { 'X-Email-Idempotency-Key': key },});console.log(info.response);Die Antwort 250 heißt gespeichert und eingereiht, nicht zugestellt.
Duplikate vermeiden
Abschnitt betitelt „Duplikate vermeiden“Gewöhnliche Mail-Clients wiederholen selbstständig. Bricht die Verbindung nach dem Senden, aber
vor dem 250 ab, kann eine Wiederholung eine zweite Nachricht erzeugen. Setzen Sie den Header
X-Email-Idempotency-Key (16 bis 128 druckbare Zeichen), damit eine Wiederholung derselben
Nachricht erkannt wird.
Eine Wiederholung muss genau dieselbe Nachricht sein, einschließlich Message-ID und Date.
Die meisten Bibliotheken erzeugen beides bei jedem Versuch neu; deshalb setzt das Beispiel beide
selbst. Eine Wiederholung mit demselben Key, aber anderem Inhalt wird mit 550 abgelehnt und nicht
gesendet. Siehe Wiederholungen und Duplikate.
Sie nutzen Supabase Auth? Siehe Supabase Auth per SMTP.
Was SMTP nicht kann
Abschnitt betitelt „Was SMTP nicht kann“Eine Empfängerin oder ein Empfänger pro Nachricht, keine Anhänge, kein Gesendet-Ordner und kein Postfach. Alle Grenzen stehen in der SMTP-Referenz.