Vonage Email API がオープンベータ版として公開されました

この度、 Vonage Email APIがオープンベータ版として提供開始されましたとなり、すべてのマネージドサービスのお客様が Vonage Messages APIのチャネルとして、すべてのマネージドサービスをご利用のお客様にご利用いただけるようになりました。

開発者は、SMS、WhatsApp、Viberなどの他のメッセージチャネルをメール送信と統合する際、もはや別のベンダーを利用する必要はありません。単にチャネルを追加するだけなので、Messages APIアプリケーションですでに設定済みの認証情報やWebhookをそのまま利用できます。便利ですね！

今回の発表に合わせ、利用可能な機能や、テストのために最初のAPI呼び出しを行う方法について見ていきます。

はじめに

メール機能をご利用になるには、まずドメイン認証の設定を完了する必要があります。 その方法についてはこちらをご覧ください、要約すると、プロバイダーでDNSレコードを追加・設定することで、Vonageがお客様に代わってメッセージを送信することをサービス側が認識できるようになります。この設定が完了したら、Vonageでの認証設定を行う必要があります。その手順について、これから順を追って説明します。

Vonageの認証

Security Firstまだ認証メカニズムが導入されていない場合は、設定を行う必要があります。まず、ダッシュボードで新しいVonage Applicationsを作成し、秘密鍵をダウンロードしてください：

Vonageの認証には、有効な JWT トークンが必要です。Vonage JWTは、Vonage CLIを使用して作成できます。これをインストールするには、 Node.jsがインストールされている必要があります。そのため、 npm や yarnなどのパッケージマネージャーを使用できますなどのパッケージマネージャーを使用できるようになります。Node.jsのインストールが完了したら、Vonage CLIをグローバルにインストールしてください：

npm install -g @vonage/cli

次に、ダウンロードしたファイルと同じディレクトリで private.key、 application_id を使用してJWTを生成します：

vonage jwt create --app_id <your_app_id> --private-key ./private.key

CLIは、使用可能なJWTトークンを返します。

初めてのメールを送る

以下が必要になります cURL がインストールされている必要があります（通常、ほとんどのオペレーティングシステムに標準で含まれています）。コマンドラインで、以下の cURL コマンドを貼り付け、 $JWT 環境変数を、先ほど作成した値に置き換えてください。

curl -X POST https://api-eu.nexmo.com/v1/messages \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "from": "sender@yourdomain.com",
    "to": "recipient@example.com",
    "message_type": "text",
    "text": "Hello! Your order has been confirmed.",
    "email": {
      "subject": "Order Confirmation"
    }
  }'

これによりプレーンテキストのメールが送信されますが、 message_type フィールドを使用すれば、HTML形式のメールを送信することも可能です。例えば：

curl -X POST https://api-eu.nexmo.com/v1/messages \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "from": "sender@yourdomain.com",
    "to": "recipient@example.com",
    "message_type": "html",
    "html": {
      "body": "<h1>Order Confirmed</h1><p>Thank you for your purchase. Your order is on its way!</p>"
    },
    "email": {
      "subject": "Order Confirmation"
    }
  }'

便利な機能として、 content メッセージタイプを使用することで、両方のコンテンツタイプをネストできる点です。これにより、さまざまなエンドデバイスに対応した互換性のフォールバックを設定することが可能になります：

curl -X POST https://api-eu.nexmo.com/v1/messages \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "from": "Your Brand <sender@yourdomain.com>",
    "to": "recipient@example.com",
    "message_type": "content",
    "content": [
      { "type": "text", "text": "Your order has been confirmed." },
      { "type": "html", "body": "<p>Your order has been <strong>confirmed</strong>.</p>" }
    ],
    "email": {
      "subject": "Order Confirmation"
    }
  }'

APIにメッセージを送信すると、 202 レスポンスが返されます。 message_uuidレスポンスが届くはずです。これは他のチャネルの場合と同様です。

Webhookの設定

Webhook を使用すると、通知を受け取ることができます。他のチャネルと同様に、配信ステータスは以下の 5 種類があります： delivered, rejected, undeliverable, read, および submitted。受信メッセージを読み取るにはバックエンドフレームワークが必要になりますが、それは今回の発表の主旨ではありません。ただ、非常に便利な機能として、 ngrokをインストールすれば、Vonage CLIをそのラッパーとして使用でき、アプリケーションのWebhook配信（ダッシュボードの「Applications」パネルで確認できるもの）において、ローカルドメインを一時的に、ローカルのngrokアドレスと指定したパスの組み合わせに置き換えることができます。 たとえば、アプリケーションのイベントが http:///example.com/webhooks/statusに設定されており、CLIでトンネルを開くコマンドを実行すると：

vonage tunnel ngrok "<your-application-id>" --port=8000

これにより ngrok が起動し、ローカルドメインが次のようなものに変更されます。 https://sa9s8d.ngrok.app/webhooks/statusのような形に変わります。統合テストを行う際に非常に便利です。受信したステータス通知は、次のような形式になります：

{
  "message_uuid": "aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab",
  "from": "sender@yourdomain.com",
  "to": "recipient@example.com",
  "timestamp": "2026-06-01T10:00:01.000Z",
  "status": "delivered",
  "channel": "email"
}

機能と活用事例

キャンペーン

これまでは、SMS（例えば 10DLCなど）とメールの両方を利用するマーケティングキャンペーンを実施したい場合、別途メールサービスが必要でした。現在では、複数の配信方法を利用するマーケティングキャンペーンにおいても、Vonage Messages API を使用することで、必要な規模に応じてキャンペーンを拡張することが可能です。

追跡

物流やEコマースなどの垂直市場では、通常、他のコミュニケーションチャネルではなく、Eメールを通じて確認依頼や配達確認を送信することが望ましいでしょう。Eメールがチャネルとして導入されたことで、これが可能になりました。

認証とセキュリティ

当社のVerify APIでは、ワンタイムパスワード（OTP）の配信が必要な場合に、メールチャネルが使用されます（SMSやWhatsAppなどの他のチャネルと併用することも可能です）。 なお、これもベータ機能である点にご注意ください。ただし、Messages APIにメールチャネルが追加されたことで、Account確認メールやパスワードリセットメールの送信など、Messagesを自社の認証スタックに統合することも可能になります。

フォールバック

「メッセージ」にはすでに配信のフォールバック機能が備わっているため、新たに「メール」というチャネルが追加されたことで、重要な情報の配信を複数の手段で試み、配信確認の確実性を高めることができるようになりました。 Eコマースはメールが活用される典型的な垂直市場であることはすでに述べましたが、以下に、WhatsApp経由で購入確認を送信したい場合の一例を示します （エンドユーザーがWhatsAppを優先的な連絡手段として指定していたため）ですが、配信が完了できない場合（エンドユーザーが対応していない地域で注文した、または携帯電話の通信範囲外であるなど）、確認通知はメールで送信されます：

{
  "template": {
    "name": "order_confirmation",
    "parameters": [{ "type": "text", "text": "ORD-12345" }]
  },
  "workflow": [
    {
      "channel": "whatsapp",
      "from": "15551234567",
      "to": "15559876543"
    },
    {
      "channel": "email",
      "from": "orders@yourdomain.com",
      "to": "customer@example.com",
      "message_type": "html",
      "html": { "body": "<p>Your order ORD-12345 is confirmed!</p>" },
      "email": { "subject": "Order Confirmation - ORD-12345" }
    }
  ]
}

今後の予定

今回のオープンベータ版のリリースはあくまで始まりに過ぎません。一般提供（GA）開始までに、ロードマップには数多くの機能が予定されています：

• 2026年第3四半期（GA）： 受信メール対応、添付ファイル対応、専用IPアドレス、カスタマーダッシュボードによるセルフサービス型オンボーディング、Verifyとの連携（OTPの代替手段としてのメール）

• 2026年第4四半期： 動的メールテンプレート、パーソナライゼーションおよび動的タグ、Conversation Connectとの連携（キャンペーンマネージャーUI）

• 2027+： 高度な分析、A/Bテスト、コンタクト管理、および包括的なマーケティングオートメーション

結論

注文確認メールやOTPの送信、あるいはオムニチャネルのフェイルオーバーワークフローの構築など、どのような用途であっても、Messages APIにメールチャネルが追加されたことで、開発者はApplicationsに通信機能を統合するための選択肢と柔軟性をさらに広げることができます。

さあ、始めましょうか？ ぜひ 開発者向けドキュメント ご覧いただき、Accountマネージャーにご連絡の上、ドメインの登録手続きを進めてください。