E-Mail-Überblick

Senden Sie transaktionale und Marketing-E-Mails über POST /v1/email/messages. Verwenden Sie einen bk_{region}_...-Key mit dem zugehörigen regionalen Host: https://us1.platform.bird.com oder https://eu1.platform.bird.com. Wir signieren die Nachricht mit DKIM, stellen sie zu und melden das Ergebnis für jeden Empfänger.

Wenn Sie etwas senden möchten, bevor Sie weiterlesen, führt Sie der Schnellstart von einem API-Key bis zur zugestellten Nachricht. Diese Seite beschreibt das Modell, das der Rest dieses Abschnitts voraussetzt, und verweist für jeden Teil auf die passende Anleitung.

So funktioniert der Versand

Ein Versand wird in einem einzigen Aufruf angenommen und asynchron zugestellt. POST /v1/email/messages validiert den Payload und die Sendedomain und gibt dann 202 Accepted mit einer em_-Nachrichten-ID zurück. Lesen Sie das Ergebnis jedes Empfängers über Webhook-Events oder die Nachrichten-Endpunkte aus. E-Mail senden behandelt Payload, Feldlimits und Response.

Zwei Konsequenzen dieses Modells prägen den Rest dieses Abschnitts.

Eine Nachricht, viele Empfänger, je ein eigener Lebenszyklus. Eine Nachricht an fünf Adressen erzeugt fünf unabhängige Ergebnisse, und der Status auf Nachrichtenebene, den Sie zurücklesen, fasst diese zusammen. Unterdrückungen werden genauso ausgewertet: Eine unterdrückte Adresse kommt als rejected zurück, während die anderen vier zugestellt werden.

Jede Nachricht gibt an, warum Sie sie senden. Die Kategorie, transactional oder marketing, bestimmt, welche Unterdrückungen für sie gelten. Wer sich von Ihrem Newsletter abgemeldet hat, muss trotzdem die E-Mail zum Zurücksetzen des Passworts erhalten. An der Kategorie erkennen wir diesen Unterschied.

Ein Versand kann auch über einen anderen Weg eingehen oder zeitversetzt erfolgen. SMTP nimmt Einlieferungen von allem entgegen, was das Protokoll spricht, und zeitgesteuerter Versand hält eine Nachricht bis zu einem von Ihnen festgelegten Zeitpunkt zurück.

Der E-Mail-Bereich im Dashboard

E-Mail ist einer der Kanäle in der Dashboard-Seitenleiste. Die Seiten in der Reihenfolge ihres Erscheinens:

Empfänger befinden sich außerhalb des E-Mail-Bereichs, unter Contacts in der Seitenleiste: All contacts speichert Personen mit typisierten benutzerdefinierten Eigenschaften (siehe Kontakte), und Audiences gruppiert sie in die wiederverwendbaren Listen, an die ein Broadcast sendet (siehe Zielgruppen).

Wo die einzelnen Anleitungen einzuordnen sind

Versand. E-Mail senden sollten Sie zuerst lesen: Diese Anleitung beschreibt den Payload, auf dem jeder andere Sendeweg aufbaut. Von dort aus speichern Templates wiederverwendbare Inhalte, Anhänge fügen Dateien hinzu, Batch-Versand übermittelt bis zu 100 Nachrichten in einem Request, und Broadcasts senden eine E-Mail an eine ganze Zielgruppe.

Domains und Authentifizierung. Sendedomains behandelt das Registrieren einer Domain und deren Verifizierung. DKIM, SPF und DMARC erklärt, was jeder Record gegenüber einem empfangenden Mailbox-Provider beweist, und BIMI zeigt Ihr Logo neben Ihren Nachrichten in E-Mail-Apps, die es unterstützen.

Reputation. Unterdrückungen ist die Liste der Adressen, an die wir nicht mehr senden. Sie wird automatisch aus Hard Bounces und Beschwerden gefüllt. Abmeldungen stoppen die Zustellung auf die gleiche Weise, allerdings über eine erklärte Präferenz statt über einen Unterdrückungseintrag. Dedizierte IPs und Pools und IP-Warmup behandeln den Versand über IP-Adressen, die nur Ihre Organisation nutzt. E-Mail-Zustellbarkeit verbindet all das miteinander.

Nachvollziehen, was passiert ist. Das E-Mail-Log zeigt eine einzelne Nachricht und deren Zeitverlauf pro Empfänger. E-Mail-Metriken aggregiert Ihren Traffic. Events ist das Event-Vokabular und beschreibt, wie Webhooks Events an Ihren eigenen Endpunkt liefern.

Empfang. E-Mail empfangen behandelt beide Wege: eine von uns generierte Weiterleitungsadresse ohne DNS-Aufwand oder MX-Records auf einer Subdomain, die Ihnen gehört. Agent-Mailboxen baut darauf auf und bietet Postfächer, aus denen Ihr Code sowohl sendet als auch liest.

Testen. Die Mail-Sandbox testet Ihre Integration End-to-End, ohne irgendwohin zuzustellen. Senden Sie an bounce@messagebird.dev, um einen Hard Bounce über die reale Event- und Webhook-Pipeline zu erzeugen. Der Test schreibt nichts in Ihre Unterdrückungsliste und erzeugt keine Unterdrückung.

Um Produktions-E-Mails von einem anderen Anbieter zu migrieren, folgen Sie der Migrationsanleitung. Sie behandelt Request-Mapping, DNS, Unterdrückungen, Webhooks, Sandbox-Tests und die Umstellung des Traffics.