TypeScript / Node.js

Verstuur een e-mail vanuit een gewoon Node.js-script met @messagebird/sdk. Je hebt een Bird API-key nodig: maak er een aan in Developers > API keys (Verstuur je eerste e-mail legt de stappen uit) en exporteer deze als BIRD_API_KEY.

1. Installeren

Codevoorbeeld

npm init -y
npm install @messagebird/sdk tsx

De SDK vereist Node.js 20.3+ en is uitsluitend ESM.

2. Versturen

Maak send.ts aan:

Codevoorbeeld

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const msg = await bird.email.send({
  from: { email: "onboarding@messagebird.dev", name: "Bird" },
  to: ["delivered@messagebird.dev"],
  subject: "Hello from Bird",
  html: "<p>My first Bird email.</p>",
});

console.log(msg.id, msg.status);

onboarding@messagebird.dev is de gedeelde onboarding-afzender van Bird en delivered@messagebird.dev is een sandbox-ontvanger die altijd aflevert: geen domeinverificatie nodig. De SDK leidt de regio af uit het bk_us1_- / bk_eu1_-prefix van je sleutel (geen base-URL te configureren) en genereert automatisch een Idempotency-Key per aanroep, zodat herhaalde verzendingen veilig zijn.

3. Uitvoeren

Codevoorbeeld

npx tsx send.ts

Het script toont het bericht-ID en de status:

Codevoorbeeld

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted is de 202 van de API: Bird heeft het bericht en levert het asynchroon af. Haal het op via zijn em_-ID met bird.email.get(msg.id) en volg hoe de status verandert naar delivered.

Vervolgstappen

TypeScript email SDK: het volledige e-mailoppervlak (send, get, list) en het foutmodel.
Je eerste e-mail versturen: een API-sleutel aanmaken en het volledige overzicht van sandbox-adressen.
Verzenddomeinen: verifieer je eigen domein voor productieverzending.
Email API-referentie: het volledige request- en responseschema.

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Bekijk de gidsGetting started with email Begrijp het conceptShould I use a Bird SDK or call the API directly?Ontdek de mogelijkheidEmail Volg het leerpadBuild your first integration

Probeer de oefening en ontvang een implementatieoverzicht