E-mailsjablonen
Ontwerp een e-mail die geopend wordt. Publiceer een versie en personaliseer elke verzending. Bouw in het dashboard of met de API, CLI en MCP; je team werkt met dezelfde opgeslagen templates.
Templatestudio
Gepubliceerde versie
Notities van de kustfirst_name: "Alex"Voorbeeldontwerpen, gepersonaliseerd met de waarden van elke ontvanger. Er wordt niets verzonden.
Dagelijks vertrouwd door teams die wereldklasse software bouwen
Lees meer klantverhalenLaat elk bericht aanvoelen als jij
Een welkomstmail, een nieuwsbrief, een orderbevestiging. Geef elk moment zijn eigen ontwerp, met dezelfde template-workflow erachter.
Notities van de kustOp frisse lucht, onbekende paden en een beetje inspiratie voor je volgende hoofdstuk.
Vind je volgende avontuurVerwelkom iemand bij naam en geef een reden om terug te komen.
Notities van de kustSommige weekenden vragen om minder plannen. Volg de kust, zoek je eigen plekje en blijf wat langer.
Lees de veldnotitiesBreng je fotografie, redactionele stem en herbruikbare lay-out naar elke campagne.
Bedankt, Alex. We maken je bestelling klaar.
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.
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.
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, 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.
Leid een waarde door een Liquid-filter voordat deze wordt gerenderd. Het default-filter vangt een ontbrekende voornaam op voordat deze als lege begroeting wordt verzonden.
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.
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.
# 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
Een creatieve workflow waar je op kunt vertrouwen
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.
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.
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 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.
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.
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.
Praat met ons e-mailteam
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.
Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra je een betaalmethode toevoegt en een afzender verifieert.
Gebruik je Claude Code, Cursor of Codex? Kopieer een setup-prompt en je agent installeert de Bird CLI en skills voor je. Kies de jouwe: