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.

Um etwas zu senden, bevor Sie weiterlesen, bringt Sie der Schnellstart von einem API-Key zu einer zugestellten Nachricht. Diese Seite beschreibt das Modell, das der Rest dieses Abschnitts voraussetzt, und verweist auf die jeweilige Anleitung für jeden Teil davon.

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, ist ein Aggregat darüber. Suppressions 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. Eine Kategorie von transactional oder marketing bestimmt, welche Suppressions darauf angewendet werden. Jemand, der sich von Ihrem Newsletter abgemeldet hat, muss trotzdem sein Passwort-Reset erhalten, und die Kategorie ist das, was uns den Unterschied mitteilt.

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.

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).

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. Suppressions ist die Liste der Adressen, an die wir nicht mehr senden, automatisch gefüllt aus Hard Bounces und Beschwerden; Abmeldungen stoppen die Zustellung auf die gleiche Weise, aber über eine erklärte Präferenz statt eines Suppression-Eintrags. 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 Suppression-Liste.

Um Produktions-E-Mails von einem anderen Anbieter zu migrieren, folgen Sie der Migrationsanleitung. Sie behandelt Request-Mapping, DNS, Suppressions, Webhooks, Sandbox-Tests und Traffic-Umstellung.