Zum Hauptinhalt springen

Lösung für Transaktions-E-Mails

Transaktions-E-Mails

Senden Sie anwendungsgenerierte E-Mails über die REST-API oder das SMTP-Relay von ApexMail. Jede Nachricht wird von der Annahme bis zur Zustellung mit Ereignisverlauf pro Nachricht verfolgt.

Zielgruppe

Entwicklungsteams, die Anwendungen mit automatisierten E-Mails bauen: Passwort-Resets, Konto-Verifizierungen, Kaufbestätigungen, Versandbenachrichtigungen, Sicherheitswarnungen und System-Status-Updates.

Geschäftskontext

Transaktions-E-Mails sind geschäftskritische Infrastruktur. Verzögerte Passwort-Resets blockieren Nutzer. Fehlende Bestellbestätigungen erzeugen Support-Tickets. Verlorene Benachrichtigungen beschädigen Vertrauen. Die E-Mail-Schicht muss schnell, beobachtbar und zuverlässig sein, ohne die Entwicklung vom Produkt abzuziehen.

Kernproblem

  • Die Zustellbarkeit variiert je nach Empfänger-Anbieter, Domain-Reputation und Authentifizierungsqualität.
  • Eingebettete SMTP-Bibliotheken verursachen Wartungsaufwand und verdecken Zustellfehler.
  • Ohne Webhook-Ereignisse pro Nachricht können Teams stille Zustellfehler nicht erkennen.
  • Warteschlangen-Stau bei Anbieter-Ausfällen erfordert Wiederholungslogik und Timeout-Management.

Die ApexMail-Lösung

  • REST-API (POST /v1/messages) — JSON-Payloads mit Idempotenzschlüsseln. Einreichen und fertig.
  • SMTP-Relay (smtp.apexmail.ee:587 mit STARTTLS) — Direkter Ersatz für bestehende SMTP-Clients.
  • Isolierte Sendekonfiguration — Dedizierte IPs, benutzerdefinierte Domains und Suppressionslisten lassen sich je E-Mail-Typ abgrenzen.
  • Signierte Webhooks — Echtzeit-Ereignisse delivered, bounced, complained, opened, clicked, jedes mit eindeutiger Ereignis-ID und HMAC-Signatur.
  • Idempotenz — Deduplizieren Sie Übermittlungen mit clientseitig bereitgestellten Schlüsseln. Nach Netzwerkfehlern sicher erneut übermitteln.

Technische Umsetzung

  1. Erstellen Sie einen API-Key unter Dashboard → Einstellungen → API-Keys.
  2. Verifizieren Sie Ihre Sende-Domain (SPF, DKIM, benutzerdefinierter Return-Path).
  3. Konfigurieren Sie eine dedizierte Sende-Domain (und auf berechtigten Tarifen eine dedizierte IP) für Ihren E-Mail-Typ.
  4. Senden Sie über REST oder SMTP.
  5. Registrieren Sie einen Webhook-Endpunkt für den Empfang von Zustellereignissen.
  6. Überwachen Sie Zustellmetriken im Dashboard oder über die Analytik-API.

Relevante API-Endpunkte

EndpunktBeschreibung
POST /v1/messagesE-Mail senden
GET /v1/messages/:idE-Mail-Status und Ereignisse abrufen
POST /v1/messages/:id/cancelGeplanten Versand abbrechen
POST /v1/messages/batchBis zu 100 Nachrichten in einer Anfrage senden

Relevante Webhook-Ereignisse

EreignisAuslöser
message.sentNachricht zur Zustellung angenommen
message.deliveredEmpfangender Server hat die Nachricht angenommen
message.bouncedHard- oder Soft-Bounce
message.complainedEmpfänger hat als Spam gemeldet
message.openedÖffnung erkannt (Tracking-Pixel)
message.clickedLinkklick erkannt

Erforderlicher Tarif

TarifMonatliches VolumenSupport
Free30.000 E-MailsCommunity
Starter50.000 E-MailsE-Mail-Support
Pro150.000 E-MailsE-Mail-Support
Growth500.000 E-MailsE-Mail-Support
Scale2.000.000 E-MailsPrioritäts-Support
Enterprise5.000.000 E-MailsDedizierter Support

Sicherheitshinweise

  • API-Keys gelten je Umgebung (live/test). Test-Keys stellen an Test-Postfächer zu.
  • Webhooks sind HMAC-signiert. Validieren Sie Signaturen, bevor Sie Ereignisse verarbeiten.
  • TLS 1.2+ ist für alle API- und SMTP-Verbindungen erforderlich.
  • Nachrichteninhalte werden im Ruhezustand verschlüsselt. Die Inhaltsaufbewahrung ist je Tarif konfigurierbar.

Compliance-Hinweise

  • EU/EWR-orientierte Bereitstellungsoptionen; bestätigen Sie aktive Datenstandorte und Übertragungsgarantien für die Bereitstellung.
  • Eine AVV ist im Rahmen der anwendbaren ApexMail-Vereinbarung verfügbar.
  • HIPAA-Verfügbarkeit und BAAs werden derzeit nicht angeboten.
  • Der Kunde ist für Empfänger-Einwilligungen und das Abmeldemanagement verantwortlich.

Bekannte Einschränkungen

  • Ereignisprotokolle werden standardmäßig 30 Tage aufbewahrt (7 Tage im Free-Tarif); Nachrichteninhalte standardmäßig 7 Tage, tarifabhängig bis zu 730 Tage.
  • Die Anhangsgröße ist auf 25 MB pro Nachricht begrenzt.
  • Öffnungs- und Klick-Tracking erfordern einen HTML-Body mit Tracking-Pixel bzw. Links.

Empfohlener nächster Schritt

Kostenloses Konto erstellen und Ihre erste E-Mail über die REST-API oder das SMTP-Relay senden.