E-Mail-Templates
Design an email worth opening. Publish a version, then personalize every send. Build in the dashboard or with the API, CLI and MCP; your team works with the same stored templates.
Template studio
Veröffentlichte Version
Notes from the coastfirst_name: "Alex"Example designs, personalized with each recipient’s values. Nothing is sent.
Täglich vertraut von Teams, die erstklassige Software entwickeln
Weitere Kundenberichte lesenMake every message feel like you
A welcome, a newsletter, an order confirmation. Give each moment its own design, with the same template workflow behind it.
Notes from the coastHere’s to fresh air, unfamiliar paths and a little inspiration for your next chapter.
Find your next adventureWelcome someone by name and give them a reason to come back.
Notes from the coastSome weekends call for fewer plans. Follow the coast, find your own corner, and stay a little longer.
Read the fieldnotesBring your photography, editorial voice and reusable layout to every campaign.
Thank you, Alex. We’re getting your order ready.
Turn order data into a confirmation that feels like part of your brand.
Illustrative designs showing what you can build with your own content.
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
A creative workflow you can trust
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.
Talk to our email team
Discuss your template workflow, personalization and integration. We’ll help you plan how your team builds and sends email with Bird.
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: