フレームワーク連携

Next.js

Sendery の JavaScript SDK を使い、Next.js のサーバーからトランザクションメールを送信します。

インストール

npm install @sendery/sdk

ソースコード

動作環境

App Router と Node.js 22.12 以上で JavaScript SDK を使用します。name と action_url を使う welcome テンプレートを公開し、プロジェクトの API キーを作成してください。

API キーを設定

開発時は .env.local、本番ではホスティングのシークレット設定に保存します。変数に NEXT_PUBLIC_ を付けないでください。以下のヘルパーには npm install server-only で server-only マーカーパッケージをインストールします。

.env.local

SENDERY_API_KEY=your_project_api_key

サーバーから送信

認証済みの登録処理から await sendWelcome(user, eventKey) を呼び出します。再試行には保存済みの宛先、名前、URL、イベントキーを使います。呼び出し元では信頼できるアプリのデータから値を取得してください。

TypeScript

// lib/send-welcome.ts
import 'server-only';
import { Sendery } from '@sendery/sdk';

type Welcome = { email: string; name: string; actionUrl: string };

export async function sendWelcome(user: Welcome, eventKey: string) {
  const apiKey = process.env.SENDERY_API_KEY;
  if (!apiKey) throw new Error('Set SENDERY_API_KEY on your server.');

  const sendery = new Sendery(apiKey);
  return sendery.prepare({
    to: user.email,
    template: 'welcome',
    data: { name: user.name, action_url: user.actionUrl },
  }, eventKey).retry().send();
}