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 ↗Laat elk bericht aanvoelen als jij
Van het eerste hallo tot het volgende hoofdstuk.
Een welkomstmail, een nieuwsbrief, een orderbevestiging. Geef elk moment zijn eigen ontwerp, met dezelfde template-workflow erachter.
FIELDNOTESEen journal voor de alledaagse ontdekker
Je bent in goed gezelschap
Wat meer buiten.
Notities van de kustHallo, Alex.
Op frisse lucht, onbekende paden en een beetje inspiratie voor je volgende hoofdstuk.
Vind je volgende avontuurMaak een eerste indruk.
Verwelkom iemand bij naam en geef een reden om terug te komen.
FIELDNOTESEen journal voor de alledaagse ontdekker
De weekendeditie · Nr. 08
Neem de rustigere route.
Notities van de kustHallo, Alex.
Sommige weekenden vragen om minder plannen. Volg de kust, zoek je eigen plekje en blijf wat langer.
Lees de veldnotitiesVertel een verhaal dat geopend wordt.
Breng je fotografie, redactionele stem en herbruikbare lay-out naar elke campagne.
FORM & FINISHBestelling bevestigd
Gemaakt om mee te leven
Er zijn mooie dingen onderweg.
Bedankt, Alex. We maken je bestelling klaar.
De alledaagse collectieSteengoed · Natuurlijke afwerking
01Maak de details persoonlijk.
Verwerk orderdata in een bevestiging die voelt als onderdeel van je merk.
Illustratieve ontwerpen die laten zien wat je kunt bouwen met je eigen content.
Preview and download HTML email templates ↗Sla een sjabloon op. Personaliseer bij verzending.
De markup staat al in Bird.
Templates maken deel uit van de Bird Email API. Sla de lay-out en de logica één keer op; elke verzending verwijst naar het template op basis van slug of id en geeft de waarden mee die de tokens nodig hebben. Het uiteindelijke bericht wordt aan onze kant gerenderd, zodat hetzelfde template werkt voor één bon, een batch van honderd of een broadcast naar een heel publiek.
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();
Meer dan zoeken-en-vervangen.
Liquid, opgelost aan Bird's kant wanneer het bericht wordt gegenereerd.
Conditionals.
Een Liquid if-blok wordt alleen getoond wanneer de waarde van toepassing is, zoals een opmerking alleen voor leden of een gratis-verzendbanner, zodat één template beide gevallen dekt.
Loops.
Een for-loop herhaalt een rij voor elk item in een array, zodat één orderbevestigingstemplate elke regel toont die een klant daadwerkelijk heeft gekocht. Een beperking die u vooraf moet weten: een broadcast draagt één enkele waarde per contacteigenschap en heeft niets om over te itereren, dus een template met loops verzendt via de messages API in plaats van een broadcast.
Filters.
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.
Benoemde parameters en contactvelden.
Gebruik platte namen voor je eigen parameters, zoals order_number. Gereserveerde bird.contact-velden lezen ontvangereigenschappen uit. Gewone puntgescheiden parameterpaden worden geweigerd bij het publiceren.
Niets aan te geven.
De tokenlijst wordt uit je opmaak gelezen en samengevoegd over alle talen, dus er is geen apart variabelenschema dat je synchroon moet houden met de body. Gebruik de parametervormen die gedocumenteerd zijn voor je verzendworkflow; broadcasts zijn beperkt tot geregistreerde contacteigenschappen.
Maak het zoals je al werkt.
Drie manieren om erin te komen, allemaal naar hetzelfde template. De dashboardbuilder is de visuele manier. De bird CLI stuurt de hele levenscyclus aan vanuit een script of een deploystap, en een agent bereikt dezelfde bewerkingen via MCP. Heeft u al React Email-componenten? Render ze naar HTML en sla het resultaat op, waarbij u Bird's tokens als letterlijke tekst in de JSX laat staan zodat ze de render overleven in plaats van dat er een waarde wordt ingebakken wanneer React draait.
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.
Een creatieve workflow waar je op kunt vertrouwen
Prachtig in de inbox. Betrouwbaar achter de schermen.
Geversioneerd, net als de rest van je code.
Bewerken gebeurt op een concept en raakt nooit wat live staat, omdat een verzending altijd de huidige gepubliceerde versie gebruikt en concepten nooit worden verzonden. Publiceren bevriest een onveranderlijke, genummerde versie en maakt deze live; als een wijziging misgaat, draait u terug naar een eerdere versie. Opslagacties bevatten de revisie die u het laatst las, dus als een collega die taal inmiddels heeft gewijzigd, wordt het opslaan geweigerd als conflict in plaats van hun werk te overschrijven. Bezorgings- en engagementstatistieken worden per template uitgesplitst, zodat u kunt zien welk template daadwerkelijk aankomt.
Eén template, tot 25 talen.
Een template bevat content in maximaal 25 talen, elk met een eigen onderwerp en body, aangeduid met een BCP-47-tag zoals en of pt-BR. Een verzending geeft de gewenste taal aan, of laat deze weg en krijgt de standaardtaal van het template. Wanneer een verzending een taal vraagt die het template niet bevat, bepaalt on_missing_language wat er gebeurt: fallback levert de dichtstbijzijnde match, zodat een verzoek voor pt-BR wordt beantwoord door een beschikbare pt, en fail weigert de verzending volledig, voor content waarbij de verkeerde taal erger is dan helemaal niet verzenden.
Bekijk precies wat er verzonden wordt.
Vul een template met voorbeeldwaarden en krijg het onderwerp en de HTML- en tekstbody's terug die een verzending zou opleveren. Preview rendert het concept, zodat u een wijziging kunt controleren voordat deze live gaat, of een gepubliceerde versie wanneer u wilt zien wat er nu wordt verzonden. Er wordt niets verstuurd. Het voert ook dezelfde personalisatiecontroles uit als publiceren, zodat een constructie die zou worden geweigerd hier eerst zichtbaar wordt.
Begin vanuit een herbruikbaar concept.
Begin met de dashboardeditor of kopieer een ingebouwde template naar een bewerkbaar concept. Controleer onderwerp, voorbeeldtekst, taal en contactfallbacks voordat je publiceert. Houd de gepubliceerde versie stabiel terwijl je de volgende wijziging voorbereidt.
Ga dieper in de docs.
De templategids behandelt concepten, gepubliceerde versies, content per taal en de Liquid-regels. De verzendgids beschrijft het contract aan de verzendzijde, en e-mailevents en webhooks laat opens en clicks terugstromen.
Breng het in de praktijk.
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.
Vragen over templates
Moet ik een visuele builder gebruiken?
Nee. Gebruik de dashboardeditor of schrijf HTML via de CLI- en MCP-workflows. React Email-output kan als HTML worden opgeslagen met behoud van Bird-placeholders. De API, CLI en MCP werken op dezelfde concepten en gepubliceerde versies die je in het dashboard ziet.
Hoe werkt personalisatie?
Opgeslagen templates ondersteunen Liquid en benoemde parameters. Gewone parameternamen zijn plat, zoals order_number. Gereserveerde bird.contact-velden lezen ontvangerseigenschappen. Broadcasts gebruiken geregistreerde contacteigenschappen en kunnen geen template-loops gebruiken; de berichten-API ondersteunt meer algemene template-verzendingen.
Kan ik een template terugdraaien?
Ja. Bewerken wijzigt een concept. Publiceren maakt een onveranderlijke versie aan die bij latere verzendingen wordt gebruikt. Terugdraaien selecteert een eerder gepubliceerde versie en herstelt het concept naar die inhoud; al geaccepteerde verzendingen behouden hun inhoud.
Kan één template meerdere talen bedienen?
Een template kan taalspecifieke onderwerpregel, previewtekst en body-inhoud bevatten. Stel een standaardtaal in en bepaal of een ontbrekende taal terugvalt of faalt. Bekijk een preview met representatieve contactwaarden voordat je publiceert.
Zet je template aan het werk
Plan a template release
Review variables, languages and a version change with a recovery record.
E-mailmarketing
Gebruik je herbruikbare content in een campagne rondom je doelgroep.
Broadcasts
Marketingcampagnes: opstellen, richten op een doelgroep, plannen en verzenden.
Verzenden
Transactionele en marketing-e-mail, sjablonen en batchverzendingen.
Praat met ons e-mailteam
Maak e-mail die je team kan hergebruiken.
Bespreek je template-workflow, personalisatie en integratie. We helpen je plannen hoe je team e-mail bouwt en verstuurt met Bird.
Maak je account aan, maak vervolgens een herbruikbare template en bekijk de inhoud.