TypeScript · SvelteKit

Envoyez un e-mail depuis un endpoint +server.ts SvelteKit avec @messagebird/sdk. Vous avez besoin d'une clé API Bird : créez-en une dans Developers > API keys (Envoyer votre premier e-mail décrit la marche à suivre), puis ajoutez-la dans .env sous le nom BIRD_API_KEY.

1. Installer

Exemple de code

npx sv create my-app --template minimal --types ts --no-add-ons --install npm
cd my-app
npm install @messagebird/sdk

2. Envoyer

Créez src/routes/api/send/+server.ts. Les fichiers +server.ts s'exécutent uniquement côté serveur, et $env/static/private lit BIRD_API_KEY depuis .env sans jamais l'exposer au client :

Exemple de code

import { json } from "@sveltejs/kit";
import { BIRD_API_KEY } from "$env/static/private";
import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: BIRD_API_KEY });

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

  console.log(msg.id, msg.status); // "em_…", "accepted"
  return json({ id: msg.id, status: msg.status });
}

onboarding@messagebird.dev est l'expéditeur d'intégration partagé de Bird et delivered@messagebird.dev est un destinataire sandbox qui aboutit toujours : aucune vérification de domaine nécessaire. Le SDK déduit la région à partir du préfixe bk_us1_ / bk_eu1_ de votre clé (aucune URL de base à configurer) et génère automatiquement un Idempotency-Key par appel, ce qui rend les envois réessayés sûrs.

3. Tester

Lancez le serveur de développement et envoyez un POST vers l'endpoint :

Exemple de code

npm run dev
curl -X POST http://localhost:5173/api/send

Bird accepte l'e-mail avec un 202 et le distribue de manière asynchrone ; votre endpoint renvoie l'ID em_ et le statut :

Exemple de code

{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted"
}

Étapes suivantes

SDK e-mail TypeScript : la surface e-mail complète (send, get, list) et le modèle d'erreur.
Envoyer votre premier e-mail : création d'une clé API et liste complète des adresses sandbox.
Domaines d'envoi : vérifiez votre propre domaine pour l'envoi en production.
Référence API e-mail : le schéma complet de requête et de réponse.

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Regarder le guideGetting started with email Comprendre le conceptShould I use a Bird SDK or call the API directly?Explorer la fonctionnalitéEmail Suivre le parcours d'apprentissageBuild your first integration

Essayez la pratique et obtenez un guide d'implémentation