電子メールのメッセージングを理解する
Vonage Messages API Email チャンネルでは、SMS、WhatsApp、RCS、その他のメッセージングチャンネルと同じ統合APIを使用してEメールを送信できます。
このページでは、メールチャネルの仕組み、対応機能、およびこのチャネルを使用して開発を行う前に理解しておくべき重要なConceptsについて説明します。
「メール」チャネルは、トランザクションメールのユースケースに重点を置いており、以下の機能を備えています:
- 送信メール — プレーンテキストおよびHTML
- 配送状況のWebhook
- 地域別発送(EU、米国、アジア太平洋地域)
- カスタマーダッシュボードによるセルフサービス型のドメイン認証
- ダッシュボード経由でVonage Applicationsにリンクするドメイン
- カスタマーダッシュボードのログと分析
- バウンスおよび苦情対応
- 抑制リストの管理
- Webhook経由の受信メール
- 専用IPアドレス
- CC/BCCの対応
Eメールチャネルの仕組み
Eメールは、Vonage Messages API に組み込まれたチャネルです。これは同じ /v1/messages エンドポイント、JWT認証モデル、およびSMS、WhatsApp、RCSといったWebhook配信パターン。
流出量
Applicationsは POST へのリクエストを送信します。 /v1/messages チャネルを「メール」に設定した場合。Vonage Email Engine は、メッセージを受信者のメールボックスに配信し、設定されたステータス URL に配信状況の更新情報を送信します。
流入量
送信者が、認証済みのドメイン宛てにメールを送信します。そのドメインのMXレコードによってメッセージがVonageに転送され、Vonageは関連付けられたドメインを識別して、そのイベントをVonage Applicationsで設定された受信用URLに送信します。
Messages APIへの電子メール統合
メールは、既存のMessages APIモデル内に新しいチャネルとして統合されています。新しいベースエンドポイントは導入されていません。これまでと同じ /v1/messages 他のチャネルですでに使用しているエンドポイント。
メールを送信するには "channel": "email" をリクエストボディに書く。リクエスト・ボディの message_type フィールドが受け付ける "text" プレーンテキストの電子メールと "html" HTMLメール用。
ドメインのセルフサービス登録
ドメイン認証は、Vonage カスタマーダッシュボードを通じて完全にセルフサービスで実施できます。メール配信の準備として、以下の手順に従ってください:
- ドメインを追加してください。「カスタマーダッシュボード」で、以下のページに移動してください。 メッセージ > メール > ドメイン認証 そして、使用したいドメイン名を入力してください。
- DNSレコードを設定します。Vonageから提供されたSPF、DKIM、およびDMARCレコードを、ご利用のDNSプロバイダーを通じて追加してください。
- 確認が完了するまでお待ちください。DNSの確認には最大72時間かかる場合があります。
- 認証済みのドメインをリンクしてください。ドメインをVonage Applicationsに接続して、Webhookのルーティングと受信メール機能を有効にしてください。
次のステップ:参照 Eメール入門 オンボーディングおよび設定に関する完全なガイドはこちらをご覧ください。
受信メール
メールチャネルは、VonageによってVerifyされたドメインまたはサブドメイン宛てに送信された受信メッセージに対応しています。Vonageはメールを受信し、設定された受信用URLを通じて、連携されたVonage Applicationsに配信します。
主な要件:
- インバウンドDNSレコードを設定します。 受信ドメインまたはサブドメインを、Vonageが提供するメールサーバーに設定してください。
- ドメインをリンクしてください。 認証済みのドメインをVonage Applicationsに接続します。
- 受信URLを設定します。 受信メールイベントを受け取るアプリケーションのエンドポイントを設定します。
- 専用のサブドメインを使用してください。 reply.example.com のようなサブドメインを使用することで、着信ルーティングがルートドメイン上の企業メールに影響を与えるのを防ぐことができます。
- マルチドメインのメッセージを処理する。 1通のメールに複数の認証済みドメインにまたがる受信者が含まれている場合、Vonageは認証済みドメインごとの受信者に対して1つのイベントを生成します。各イベントには、それぞれ異なるメッセージUUID、個別のCDR、および元の受信者配列全体が含まれます。
ログと分析
Vonageカスタマーダッシュボードの「ログと分析」エリアでは、メールの送信および配信状況に関するリアルタイムの可視化が可能です。
Email APIへのアクセス権限を持つお客様は、追加の設定を行うことなくダッシュボードを利用して、メッセージのアクティビティを確認したり、配信結果を確認したり、運用上のトラブルシューティングを行ったりすることができます。
専用IPアドレス
デフォルトでは、メールはVonageの共有IPプールを通じて送信されます。対象となるプランをご利用の大量送信者は、送信者のレピュテーションを分離し、配信率をより細かく管理するために、専用IPアドレスの割り当てを申請することができます。
主な考慮事項:
- プランの特典:一般提供開始時点で、Advancedプランには専用IPアドレスが1つ含まれます。
- 追加容量:IPアドレス1つにつき30ドルの1回限りの料金で、追加のIPアドレスをご利用いただけます。
- ウォームアップ:VonageではIPアドレスのウォームアップ処理は行わないため、お客様ご自身で専用IPアドレスのウォームアップを行う必要があります。
- 送信量の安定性:専用IPアドレスでは、送信者のレピュテーションを確立・維持するために、安定した送信量が必要です。
電子メールの使用例
電子メールチャネルは、ユーザーのアクションまたはシステムイベントによってメッセージがトリガーされるトランザクションのユースケース用に設計されています。一般的な例としては、以下のようなものがあります:
- 注文確認と領収書 - 購入後すぐに確認メールを送信します。
- パスワードリセットとAccount認証 - 一刻を争うセキュリティメールを確実に配信します。
- 出荷と配送の通知 - 遂行の各段階で顧客に情報を提供します。
- アポイントメント・リマインダー - 自動リマインダー・メールでノーショウを減らす
- システムアラートと通知 - 重要なイベントをリアルタイムでユーザーや社内チームに通知します。
- OTP/二要素認証 — Vonage Verifyにおける代替通信手段としてのメール。
- 返信の追跡とサポートチケット管理 — 自動送信メールに対する顧客からの返信を、受信メールとして受け取ることができます。
- オムニチャネルのフェイルオーバー — Messages APIのフェイルオーバーモデルを使用して、WhatsAppやSMSが利用できない場合の代替手段としてメールを設定します。
- KYC/コンプライアンスに関する通知 — 本人確認書類や規制関連書類を確実に配信します。
- ウェルカムおよびオンボーディングのシーケンス — プラットフォームから自動オンボーディングメールを送信します。
オムニチャネル・スタックの一環としてのEメール
メールはMessages APIのネイティブチャネルであるため、一貫性のあるAPIおよび認証モデルを通じて、SMS、WhatsApp、RCSと併せて利用することができます。
フェイルオーバーのワークフロー例:
- まずは希望のチャネルから始めましょう。WhatsAppを通じて最初のメッセージを送信してください。
- メールに切り替える。WhatsAppのメッセージが指定された時間内に配信されない場合は、メールを送信する。
- SMSは最終的な代替手段として使用してください。メールが配信不能になった場合は、SMSで通知を送信してください。
このアプローチにより、チャネルの連携をMessages API内に統合でき、ベンダーごとの統合を個別に維持する必要性が軽減されます。