E-Mail-Templates
Gestalten Sie eine E-Mail, die man öffnen will. Veröffentlichen Sie eine Version und personalisieren Sie jeden Versand. Erstellen Sie Templates im Dashboard oder mit der API, der CLI und MCP; Ihr Team arbeitet mit denselben gespeicherten Templates.
Template-Studio
Veröffentlichte Version
Notizen von der Küstefirst_name: "Alex"Beispieldesigns, personalisiert mit den Werten jedes Empfängers. Es wird nichts gesendet.
Täglich vertraut von Teams, die erstklassige Software entwickeln
Weitere Kundenberichte lesenJede Nachricht soll nach Ihnen klingen
Eine Begrüßung, ein Newsletter, eine Bestellbestätigung. Geben Sie jedem Moment sein eigenes Design – mit demselben Template-Workflow dahinter.
Notizen von der KüsteAuf frische Luft, unbekannte Wege und ein wenig Inspiration für Ihr nächstes Kapitel.
Finden Sie Ihr nächstes AbenteuerBegrüßen Sie jemanden mit Namen und geben Sie einen Grund zurückzukommen.
Notizen von der KüsteManche Wochenenden verlangen nach weniger Plänen. Folgen Sie der Küste, finden Sie Ihren eigenen Platz und bleiben Sie ein wenig länger.
Die Feldnotizen lesenBringen Sie Ihre Fotografie, Ihre redaktionelle Stimme und Ihr wiederverwendbares Layout in jede Kampagne.
Vielen Dank, Alex. Wir bereiten Ihre Bestellung vor.
Verwandeln Sie Bestelldaten in eine Bestätigung, die sich wie ein Teil Ihrer Marke anfühlt.
Illustrative Designs, die zeigen, was Sie mit Ihren eigenen Inhalten erstellen können.
Templates sind Teil der Bird Email API. Speichern Sie Layout und Logik einmal; jeder Versand referenziert das Template per Slug oder ID und übergibt die Werte, die seine Tokens benötigen. Die finale Nachricht wird auf unserer Seite gerendert – dasselbe Template funktioniert für eine einzelne Quittung, einen Batch von hundert oder einen Broadcast an eine ganze Zielgruppe.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
// No subject and no html: the template's published version supplies both.
const { data, error } = await bird.email
.send({
from: "orders@acme.com",
to: ["delivered@messagebird.dev"],
category: "transactional",
template: {
slug: "order-confirmation",
parameters: {
first_name: "Ada",
order_number: "A-1043",
},
},
})
.safe();
Liquid, aufgelöst auf Bird-Seite bei der Nachrichtengenerierung.
Bedingungen.
Ein Liquid-if-Block wird nur angezeigt, wenn sein Wert zutrifft – etwa ein Hinweis nur für Mitglieder oder ein Gratis-Versand-Banner – so deckt ein Template beide Fälle ab.
Schleifen.
Eine for-Schleife wiederholt eine Zeile für jedes Element in einem Array, sodass ein einzelnes Bestellbestätigungs-Template jede Position auflistet, die ein Kunde tatsächlich gekauft hat. Ein wichtiges Limit vorab: Ein Broadcast trägt pro Kontakteigenschaft nur einen einzelnen Wert und hat nichts zum Iterieren – ein Template mit Schleifen wird daher über die Messages API statt per Broadcast versendet.
Filter.
Leiten Sie einen Wert durch einen Liquid-Filter, bevor er gerendert wird. Der default-Filter fängt einen fehlenden Vornamen ab, bevor er als leere Begrüßung verschickt wird.
Benannte Parameter und Kontaktfelder.
Verwenden Sie flache Namen für Ihre eigenen Parameter, z. B. order_number. Reservierte bird.contact-Felder lesen Empfängereigenschaften aus. Gewöhnliche Parameterpfade mit Punktnotation werden beim Veröffentlichen abgelehnt.
Nichts zu deklarieren.
Die Token-Liste wird aus Ihrem Markup ausgelesen und über alle Sprachen hinweg zusammengeführt – es gibt kein separates Variablenschema, das mit dem Inhalt synchron gehalten werden muss. Verwenden Sie die Parameterformate, die für Ihren Versand-Workflow dokumentiert sind; Broadcasts sind auf registrierte Kontakteigenschaften beschränkt.
Drei Wege hinein, alle zum selben Template. Der Dashboard-Builder ist der visuelle. Die bird CLI steuert den gesamten Lebenszyklus aus einem Skript oder Deploy-Schritt, und ein Agent erreicht dieselben Operationen per MCP. Sie haben bereits React Email-Komponenten? Rendern Sie sie zu HTML und speichern Sie das Ergebnis – lassen Sie Birds Tokens als Klartext im JSX, damit sie den Render überstehen, statt beim Ausführen von React einen festen Wert einzubacken.
# Render React Email to HTML, then publish it as a template version.
node scripts/render-receipt.mjs > receipt.json
bird email templates create receipt --category transactional --source html
bird email templates versions languages set "$TEMPLATE" "$DRAFT" en \
--body-file receipt.json --yes
# --validate-only reports every problem across every language, freezing nothing.
bird email templates versions submit "$TEMPLATE" "$DRAFT" --validate-only --yes
bird email templates versions submit "$TEMPLATE" "$DRAFT" --yes
Ein kreativer Workflow, auf den Sie sich verlassen können
Bearbeitung findet am Entwurf statt und berührt nie, was live ist – denn ein Versand löst immer die aktuell veröffentlichte Version auf, Entwürfe werden nie versendet. Veröffentlichen friert eine unveränderliche, nummerierte Version ein und macht sie live; wenn eine Änderung schiefgeht, rollen Sie auf eine frühere zurück. Speichervorgänge tragen die Revision, die Sie zuletzt gelesen haben – hat ein Teammitglied diese Sprache zwischenzeitlich geändert, wird das Speichern als Konflikt abgelehnt, statt dessen Arbeit zu überschreiben. Zustellungs- und Engagement-Statistiken werden pro Template aufgeschlüsselt, sodass Sie sehen, welches tatsächlich ankommt.
Ein Template enthält Inhalte in bis zu 25 Sprachen, jeweils mit eigenem Betreff und Body, gekennzeichnet durch ein BCP-47-Tag wie en oder pt-BR. Ein Versand benennt die gewünschte Sprache oder lässt sie weg und erhält den Standard des Templates. Wenn ein Versand eine Sprache anfordert, die das Template nicht enthält, entscheidet on_missing_language, was passiert: fallback liefert die nächste Übereinstimmung – eine Anfrage für pt-BR wird durch ein vorhandenes pt beantwortet – und fail lehnt den Versand ab, für Inhalte, bei denen die falsche Sprache schlimmer ist als gar kein Versand.
Füllen Sie ein Template mit Beispielwerten und erhalten Sie den Betreff sowie die HTML- und Text-Bodys zurück, die ein Versand liefern würde. Die Vorschau rendert den Entwurf – so prüfen Sie eine Änderung, bevor sie live geht – oder eine veröffentlichte Version, wenn Sie sehen möchten, was gerade rausgeht. Es wird nichts versendet. Es führt außerdem dieselben Personalisierungsprüfungen wie beim Veröffentlichen durch – ein Konstrukt, das abgelehnt würde, taucht hier zuerst auf.
Beginnen Sie mit dem Dashboard-Editor oder kopieren Sie eine integrierte Vorlage in einen bearbeitbaren Entwurf. Prüfen Sie Betreff, Vorschautext, Sprache und Kontakt-Fallbacks, bevor Sie veröffentlichen. Halten Sie die veröffentlichte Version stabil, während Sie die nächste Änderung vorbereiten.
Der Templates-Leitfaden behandelt Entwürfe, veröffentlichte Versionen, sprachspezifische Inhalte und die Liquid-Regeln. Der Versand-Leitfaden beschreibt den Versandvertrag, und E-Mail-Events und Webhooks bringt Öffnungen und Klicks zurück.
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Sprechen Sie mit unserem E-Mail-Team
Besprechen Sie Ihren Template-Workflow, Personalisierung und Integration. Wir helfen Ihnen zu planen, wie Ihr Team E-Mails mit Bird erstellt und versendet.
Erstellen Sie Ihr Konto, dann erstellen Sie eine wiederverwendbare Vorlage und sehen Sie sich deren Inhalt in der Vorschau an.
Ein Test-API-Key steht Ihnen sofort zur Verfügung. Der Produktivzugang wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.
Sie nutzen Claude Code, Cursor oder Codex? Kopieren Sie einen Setup-Prompt und Ihr Agent installiert die Bird CLI und Skills für Sie. Wählen Sie Ihren: