Use a published template.
Create and preview the design, publish the intended version, then pass recipient values at send time. Publishing content and sending a message are separate steps.
Build a stored template ↗EmailTemplates
Email templates.
Your design, their moment.
Create a recognisable starting point for each message. Publish reusable designs, supply customer values, and bring the same care to campaigns and application email.
Personalize the next email.
Make a receipt or welcome email feel personal. Change the example customer details, compare versions and preview the message on a smaller screen.
A required value is missing. Supply the named single-send parameters before sending; an omitted required parameter returns 422.
Enter a complete HTTPS destination and validate it in your application before supplying the value.
Draft preview. An edit does not change published v1. Publish deliberately before using a new version.
Published v1 preview. This browser layout is illustrative; test HTML and text in your target email clients.
fieldnotes.Illustrative action link ↗
Hi Alex,
Something new is taking shape.A little room to breathe.Good things, on their way.A small step back in.
Your next chapter starts here.
Order FN-1042 is confirmed. Total: €42.00.
Use the short-lived link to reset access. Ignore this message if you did not request it.
Inspect the current recipient values
{
"first_name": "Alex",
"account_url": "https://example.com/account"
}These are single-send parameters, not a complete API request. Broadcast personalization uses contact fields. Render React Email to HTML before storing its content.
Companies that trust Bird across their communications.
Read Bird customer storiesDesign once. Use deliberately.
Keep your HTML or React Email.
HTML is the stored content. Render React Email to HTML before storage or submission, and check the supported variables before changing a template used by an application.
Send application email ↗Jede Nachricht soll nach Ihnen klingen
Vom ersten Hallo bis zum nächsten Kapitel.
Eine Begrüßung, ein Newsletter, eine Bestellbestätigung. Geben Sie jedem Moment sein eigenes Design – mit demselben Template-Workflow dahinter.
FIELDNOTESEin Journal für den alltäglichen Entdecker
Sie sind in guter Gesellschaft
Ein bisschen mehr draußen.
Notizen von der KüsteHallo, Alex.
Auf frische Luft, unbekannte Wege und ein wenig Inspiration für Ihr nächstes Kapitel.
Finden Sie Ihr nächstes AbenteuerHinterlassen Sie einen ersten Eindruck.
Begrüßen Sie jemanden mit Namen und geben Sie einen Grund zurückzukommen.
FIELDNOTESEin Journal für den alltäglichen Entdecker
Die Wochenendausgabe · Nr. 08
Nehmen Sie den langsameren Weg.
Notizen von der KüsteHallo, Alex.
Manche 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 lesenErzählen Sie eine Geschichte, die man öffnen will.
Bringen Sie Ihre Fotografie, Ihre redaktionelle Stimme und Ihr wiederverwendbares Layout in jede Kampagne.
FORM & FINISHBestellung bestätigt
Gemacht, um damit zu leben
Gute Dinge sind auf dem Weg.
Vielen Dank, Alex. Wir bereiten Ihre Bestellung vor.
Die AlltagskollektionSteinzeug · Natürliche Oberfläche
01Machen Sie die Details persönlich.
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.
Preview and download HTML email templates ↗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.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
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.
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.
Pipe a value through a Liquid filter before it renders. The default filter can give an explicitly empty first name a natural greeting. Include required named parameters in the send request; omitting one returns 422.
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.
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.
publish-receipt.sh
bird CLI
# 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
Create the template through CLI or MCP, inspect its version and use the published content when sending. Follow the template guide from the first draft through publication.
Ein kreativer Workflow, auf den Sie sich verlassen können
Überzeugend im Posteingang. Zuverlässig hinter den Kulissen.
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?
Nein. Verwenden Sie den Dashboard-Editor oder erstellen Sie HTML über die CLI- und MCP-Workflows. React Email-Ausgaben können als HTML mit beibehaltenen Bird-Platzhaltern gespeichert werden. Die API, CLI und MCP arbeiten mit denselben Entwürfen und veröffentlichten Versionen, die Sie im Dashboard sehen.
Wie funktioniert die Personalisierung?
Gespeicherte Templates unterstützen Liquid und benannte Parameter. Gewöhnliche Parameternamen sind flach, z. B. order_number. Reservierte bird.contact-Felder lesen Empfängereigenschaften aus. Broadcasts verwenden registrierte Kontakteigenschaften und können keine Template-Schleifen nutzen; die Messages API unterstützt allgemeinere Template-Sends.
Kann ich ein Template zurücksetzen?
Ja. Bearbeitung ändert einen Entwurf. Veröffentlichen erstellt eine unveränderliche Version, die für spätere Sends verwendet wird. Zurücksetzen wählt eine frühere veröffentlichte Version und setzt den Entwurf auf diesen Inhalt zurück; bereits angenommene Sends behalten ihren Inhalt.
Kann ein Template mehrere Sprachen bedienen?
Ein Template kann sprachspezifischen Betreff, Vorschautext und Body-Inhalt enthalten. Konfigurieren Sie eine Standardsprache und legen Sie fest, ob eine fehlende Sprache auf die Standardsprache zurückfällt oder einen Fehler auslöst. Prüfen Sie mit repräsentativen Kontaktwerten vor der Veröffentlichung.
Setzen Sie Ihre Vorlage ein
Plan a template release
Review variables, languages and a version change with a recovery record.
E-Mail-Marketing
Nutzen Sie Ihre wiederverwendbaren Inhalte in einer Kampagne, die auf Ihre Zielgruppe zugeschnitten ist.
Broadcasts
Marketingkampagnen: entwerfen, eine Zielgruppe ansprechen, planen und senden.
Versand
Transaktionale und Marketing-E-Mails, Templates und Batch-Versand.
Sprechen Sie mit unserem E-Mail-Team
Erstellen Sie E-Mails, die Ihr Team wiederverwenden kann.
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.