Zum Inhalt springen
Frontmail Docs

Überblick und Grundbegriffe

Mit Frontmail senden Sie E-Mails direkt aus Ihrem Frontend – ein Kontaktformular, eine Buchungsanfrage, eine Bestellbestätigung – ganz ohne eigenes Backend. Sie verbinden den E-Mail-Anbieter, den Sie ohnehin nutzen, gestalten im Dashboard eine HTML-Vorlage mit typisierten Parametern und rufen eine einzige Funktion auf:

import { init, send } from '@frontmail/browser';


init({ publicKey: 'pk_4f2a…' });
await send('svc_01J9…', 'tpl_01J9…', { name: 'Jana', message: 'Hallo!' });

Die Anfrage geht an die Frontmail-API. Sie prüft sie (Origin, Bot-Schutz, Rate Limits, Validierung der Parameter), reserviert einen Credit und stellt die E-Mail in die Warteschlange. Anschließend rendert ein Sender die Vorlage und stellt sie über Ihren Anbieter zu. Zustellereignisse (zugestellt, gebounct, geöffnet …) fließen über die Webhooks des Anbieters zurück in Ihren Verlauf und Ihre Statistiken.

Die Bausteine

Abschnitt betitelt „Die Bausteine“

Organisation

Abschnitt betitelt „Organisation“

Alles – Schlüssel, E-Mail-Dienste, Vorlagen, Credits, Mitglieder – gehört zu einer Organisation. Ein Benutzer kann Mitglied mehrerer Organisationen sein und zwischen ihnen wechseln. Jede Organisation hat ihren eigenen Tarif und ihr eigenes Credit-Guthaben.

Öffentlicher und privater Schlüssel

Abschnitt betitelt „Öffentlicher und privater Schlüssel“
Öffentlicher Schlüssel pk_… Privater Schlüssel sk_…
Wo er liegt In Ihrem Frontend-Code – er ist kein Geheimnis Nur auf Ihrem Server – behandeln Sie ihn wie ein Passwort
Wie er gesendet wird user_id im Body oder Header X-Frontmail-Public-Key Authorization: Bearer sk_… (oder accessToken im Body) – nie aus dem Browser: Anfragen mit Origin-Header werden abgelehnt
Geschützt durch Erlaubte Domains, Turnstile, Rate Limits, Bot-Schutz Seine Geheimhaltung – er überspringt die Origin- und CAPTCHA-Prüfung
Kann send, send-form, Uploads, Status der eigenen Nachrichten abfragen Alles oben plus send-batch, history, templates

Da jeder, der Ihre Seite öffnet, den öffentlichen Schlüssel sehen kann, vertraut Frontmail ihm nie allein. Lesen Sie Öffentliche und private Schlüssel, bevor Sie live gehen.

E-Mail-Dienste

Abschnitt betitelt „E-Mail-Dienste“

Ein E-Mail-Dienst ist die Verbindung zu einem E-Mail-Anbieter: SMTP (IONOS, Zoho, Ihr eigener Server), Mailgun, Amazon SES, Postmark, Mailjet, Brevo, Resend, Gmail oder Outlook / Microsoft 365. Die Zugangsdaten werden mit AWS KMS verschlüsselt. Frontmail prüft jeden Dienst täglich und sofort nach einem Authentifizierungsfehler, und eine Vorlage kann einen Ersatzdienst haben, der übernimmt, wenn der primäre Dienst ausfällt. Siehe E-Mail-Dienste im Überblick.

Vorlagen

Abschnitt betitelt „Vorlagen“

Eine Vorlage ist eine vollständige HTML-E-Mail (mit automatisch erzeugter Textversion) samt Betreff, Empfängern (To, CC, BCC, Reply-To, From) und einem Parameterschema. Parameter sind typisiert (string, email, number, date, list …) und werden bei jedem Versand validiert; im Body sorgt Handlebars für Bedingungen, Schleifen und Formatierungs-Helper. Siehe HTML-Vorlagen und Parameter und Typen.

Credits

Abschnitt betitelt „Credits“

Eine angenommene E-Mail = ein Credit. Credits stammen aus Grants:

  • subscription – das monatliche Kontingent Ihres Tarifs (wird nicht übertragen),
  • pack – vorausbezahlte Credit-Pakete mit 3–12 Monaten Gültigkeit, in jedem Tarif erhältlich, auch in Free,
  • bonus – Credits, die der Frontmail-Support gutschreibt,
  • overdraft – ein Puffer von 10 % in bezahlten Tarifen (Überziehung), abgerechnet mit Ihrer nächsten Rechnung.

Credits werden immer aus dem Grant genommen, der zuerst abläuft, die Überziehung zuletzt. Testversände aus dem Vorlagen-Editor sind kostenlos. Scheitert ein Versand dauerhaft, wird der Credit erstattet. Siehe Verbrauchsreihenfolge.

Keine E-Mail geht stillschweigend verloren

Abschnitt betitelt „Keine E-Mail geht stillschweigend verloren“

Wenn Ihnen die Credits ausgehen, verwirft Frontmail Ihre E-Mail nicht. Im Standardmodus hold nimmt es die Anfrage mit 202 { "status": "held" } an, speichert die Nachricht und sendet sie automatisch, sobald wieder Credits verfügbar sind – nach dem Kauf eines Credit-Pakets, einer automatischen Aufladung, einem Tarif-Upgrade oder im nächsten Abrechnungszeitraum. Lesen Sie Warteschlange zurückgehaltener E-Mails.

Lebenszyklus einer Nachricht

Abschnitt betitelt „Lebenszyklus einer Nachricht“
accepted ─┬─► queued ─► sending ─► sent ─┬─► delivered
          │                              ├─► bounced
          │                              └─► complained
          ├─► held (keine Credits) ─► queued …   oder ─► discarded (Haltefrist abgelaufen / manuell)
          └─► (bei Authentifizierungsfehler des Anbieters) held_service_error ─► queued … nach Reparatur des Dienstes
                                     failed (dauerhafter Fehler, Credit erstattet)

Alle Status erklärt die Seite Nachrichtenstatus.

Wie geht es weiter?

Abschnitt betitelt „Wie geht es weiter?“