E-Mail-Templates
Persönlich gestaltet. Bereit beim Versand.
Erstellen Sie wiederverwendbare E-Mail-Vorlagen mit Ihrem Team oder KI-Tools. Veröffentlichen Sie eine Version und personalisieren Sie sie beim Versand mit Empfängerdaten. Das Dashboard, API, CLI und MCP arbeiten alle mit denselben gespeicherten Vorlagen.
Erstellen Sie Ihr Konto, dann erstellen Sie eine wiederverwendbare Vorlage und sehen Sie sich deren Inhalt in der Vorschau an.
Willkommens-E-Mail
Vorschau der Vorlage
Danke, dass Sie dabei sind. Ihr nächstes Kapitel beginnt mit einer kleinen Inspiration.
first_name: "Alex"Veröffentlichte VersionEine veröffentlichte Vorlage, personalisiert mit den Werten jedes Empfängers. Beispielinhalt; es wird nichts gesendet.
Ein Template speichern. Beim Versand personalisieren.
Das Markup liegt bereits in Bird.
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();
Mehr als Suchen-und-Ersetzen.
Liquid, aufgelöst auf Bird-Seite bei der Nachrichtengenerierung.
- 01
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.
- 02
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.
- 03
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.
- 04
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.
- 05
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.
Erstellen Sie es so, wie Sie ohnehin arbeiten.
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
Versioniert, wie der Rest Ihres Codes.
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, bis zu 25 Sprachen.
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.
Sehen Sie genau in der Vorschau, was verschickt wird.
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.
Starten Sie mit einem wiederverwendbaren Entwurf.
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.
Gehen Sie in der Doku tiefer.
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.
In die Praxis umsetzen.
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Fragen zu Vorlagen
Muss ich einen visuellen Builder verwenden?
Wie funktioniert die Personalisierung?
Kann ich ein Template zurücksetzen?
Kann ein Template mehrere Sprachen bedienen?
Setzen Sie Ihre Vorlage ein
Erstellen Sie eine Vorlage, die Sie wiederverwenden können.
Speichern, versionieren und personalisieren Sie Templates über dieselbe Email API, die Versand, Zustellbarkeit, Suppression und Analytics übernimmt. Ein Satz Keys.
Erstellen Sie Ihr Konto, dann erstellen Sie eine wiederverwendbare Vorlage und sehen Sie sich deren Inhalt in der Vorschau an.