Transaktionale E-Mail
So wechseln Sie von SendGrid
Transaktionale E-Mail umziehen, ohne einen einzigen Beleg zu verlieren: Sperrgruppen zuerst hinüber, parallele Domain-Authentifizierung, das v3-mail/send-Diff und Event-Webhook-Neumapping.
Ein halber Tag Code; DNS + eine vorsichtige Umstellung bestimmen das Tempo (etwa eine Woche)
| SendGrid | WeZend |
|---|---|
| POST /v3/mail/send | POST /v1/messages/send (channel: email) |
| API key (Bearer) | X-API-Key-Header |
| Domain authentication | E-Mail-Domains + Live-DNS-Prüfung |
| Dynamic templates ({{handlebars}}) | Vorlagen + Variablen |
| Suppression groups + global suppressions | Sperrliste + Präferenzthemen |
| Event Webhook | Zustell-Webhooks (signiert) |
| Marketing Campaigns | Kampagnen + Journeys |
Worum es geht, klar gesagt
Transaktionale E-Mail verzeiht nichts: ein verlorenes Passwort-Reset ist ein Support-Ticket, ein verlorener Beleg ein rechtliches Problem. Dieser Leitfaden ist deshalb um ein einziges Prinzip herum gebaut — beide Anbieter bleiben voll betriebsbereit, bis WeZend Ihren echten Traffic tagelang ausgeliefert hat, nicht minutenlang.
Schritt 1 — Zuerst Sperreinträge und Bounces
Exportieren Sie die Sperrdaten aus SendGrid: globale Abmeldungen, Abmeldungen je Gruppe, Bounces, Spam-Beschwerden und ungültige Adressen (alles unter Suppressions in der SendGrid-Konsole herunterladbar oder über deren API). Importieren Sie das Ganze in WeZend (Zielgruppe → Sperreinträge, POST /v1/account/unsubscribes/api/import). Gebouncte Adressen und Beschwerdeführer dürfen von einer frischen Plattform aus nie erneut angeschrieben werden — genau so verbrennt man neue Domains.
Wenn Sie Sperrgruppen nutzen (Newsletter vs. Produkt-Updates), bilden Sie sie als Themen im Präferenzcenter nach — dasselbe Konzept, und Empfänger verwalten sie auf einer einzigen gehosteten Seite.
Schritt 2 — Ihre Domain parallel authentifizieren
Fügen Sie Ihre Domain unter Einstellungen → E-Mail-Domains hinzu. WeZends DKIM-Selektor koexistiert mit dem von SendGrid — die DNS-Einträge von SendGrid entfernen Sie noch nicht. Beide Plattformen bleiben nebeneinander vollständig authentifiziert, und genau das macht eine schrittweise, umkehrbare Umstellung möglich. Die Live-DNS-Prüfung bestätigt jeden Eintrag.
Schritt 3 — Das Code-Diff
SendGrid:
await fetch("https://api.sendgrid.com/v3/mail/send", {
method: "POST",
headers: { Authorization: `Bearer ${SENDGRID_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
personalizations: [{ to: [{ email: "anna@example.com" }], dynamic_template_data: { name: "Anna" } }],
from: { email: "receipts@mail.acme.com" },
template_id: "d-abc123",
}),
});
WeZend — flacherer Body, gleiche Idee:
await fetch("https://api.wezend.com/v1/messages/send", {
method: "POST",
headers: { "X-API-Key": process.env.WEZEND_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
to: "anna@example.com",
channel: "email",
sender: "receipts@mail.acme.com",
template_id: "tpl_beleg",
variables: { name: "Anna" },
category: "transactional",
webhook_url: "https://api.yourapp.com/email-events",
}),
});
Portieren Sie zuerst Ihre dynamischen Templates: Kopieren Sie das HTML jeder Vorlage in eine WeZend-Vorlage — die Handlebars-Syntax {{name}} wandert nahezu unverändert mit (Bedingungen werden zu Vorlagen-Defaults oder eigenen Vorlagen; die meisten Transaktionsvorlagen nutzen keine).
Schritt 4 — Den Event Webhook neu mappen
Die Ereignisse aus SendGrids Event Webhook lassen sich auf WeZends Zustell-Webhooks abbilden: processed→queued, delivered→delivered, bounce/dropped→failed (mit angehängtem Grund), open→opened, click→clicked, spamreport→complaint, unsubscribe→unsubscribed. Verifizieren Sie den Header X-WeZend-Signature statt SendGrids Signed-Webhook-ECDSA — die Webhook-Doku zeigt die Prüfung in fünf Zeilen. Bounces und Beschwerden speisen zudem automatisch die Sperrliste, sodass Ihre eigene Buchführung schrumpfen kann.
Schritt 5 — Umstellung je Mail-Stream
Migrieren Sie einen Stream nach dem anderen, das geringste Risiko zuerst: interne Benachrichtigungen → nutzersichtbar, aber erholbar (Digests) → kritisch (Belege, Passwort-Resets). Vergleichen Sie bei jedem Schritt Zustell- und Bounce-Raten im Zustellbarkeitsbericht mit Ihrer SendGrid-Baseline. Transaktionsvolumen wärmt sich weit schneller auf als Marketingvolumen — Empfänger erwarten und öffnen diese Mails —, sodass eine Woche stufenweise Umstellung in der Regel reicht.
Halten Sie SendGrid nach der 100%-Umstellung eine volle Woche aktiv, entfernen Sie dann dessen DNS-Einträge und schließen Sie das Konto.
Falls Sie auch Marketing Campaigns nutzen
Folgen Sie für die Marketing-Seite dem Mailchimp-Playbook: Kontakte in der sicheren Reihenfolge, Kampagnen als Kampagnen, Automationen als Journeys. Die angenehme Überraschung: Transaktion und Marketing teilen sich danach eine Sperrliste, eine Sicht auf die Domain-Reputation und ein Guthaben.
Go-live-Checkliste
- Alle SendGrid-Sperreinträge exportiert (global, Gruppen, Bounces, Spam-Beschwerden) und importiert
- Sperrgruppen als Themen im Präferenzcenter nachgebildet
- Domain in WeZend authentifiziert — SendGrid-DNS-Einträge belassen
- Dynamische Templates portiert; Variablen rendern mit Standardwerten
- Event-Webhook-Konsument neu gemappt und signaturgeprüft
- Streams mit dem geringsten Risiko zuerst umgestellt, Raten je Schritt verglichen
- SendGrid eine Woche über 100% hinaus aktiv gehalten, danach DNS bereinigt
Häufige Fragen zum Wechsel von SendGrid
Unterstützen Sie dedizierte IPs wie SendGrid?
Für die meisten Versender schlägt gut gepflegte gemeinsame Infrastruktur plus Ihre eigene authentifizierte Domain eine vernachlässigte dedizierte IP — die Domain-Reputation gewichten Mailbox-Anbieter am stärksten. Wenn Ihr Volumen dedizierte Versandinfrastruktur wirklich rechtfertigt, sprechen Sie uns an — wir richten sie im Rahmen des Onboardings ein.
Unsere Belege dürfen keine Stunde ausfallen. Ist das realistisch?
Ja — genau dafür ist die Umstellung Stream für Stream mit beiden parallel authentifizierten Domains da. Es gibt keinen Moment, in dem der alte Weg aus und der neue unerprobt ist: Sie stellen einen Stream um, sehen ihn zustellen, und stellen dann den nächsten um. Ein Rollback ist eine Konfigurationsänderung, kein Warten auf DNS.
In Minuten kostenlos starten
- Keine Kreditkarte
- EU-Datenresidenz
- 6 Kanäle, eine API
- DSGVO integriert
Eine Plattform. Jede Kundeninteraktion.
Ersetzen Sie Ihren Flickenteppich aus Messaging-APIs, CDP und Automatisierungstools durch eine Engagement-Plattform, die für Skalierung gebaut ist.
Keine Kreditkarte · EU-Datenhaltung · 99,99 % Uptime-SLA