Amazon Simple Email Service
開発者ガイド

カスタム確認 E メールテンプレートの使用

E メールアドレスを確認しようとすると、Amazon SES はそのアドレスに次の図に示す例のような E メールを送信します。

Amazon SES のお客様の中には、Amazon SES を通じて E メールを送信するアプリケーション (E メールマーケティングスイートや発券システムなど) を構築しています。これらのアプリケーションのエンドユーザにとって、E メールの検証プロセスはわかりにくい場合があります。確認 E メールはアプリケーションのブランド化ではなく、Amazon SES ブランドを使用しています。エンドユーザーが直接 Amazon SES を使用するためにサインアップすることはありません。

Amazon SES のユースケースでは、Amazon SES で使用するために E メールアドレスを検証する必要がある場合、カスタマイズされた確認 E メールを作成できます。これらのカスタマイズされた E メールは、顧客の混乱を減らし、顧客が登録手続きを完了する率を上げるのに役立ちます。

カスタム確認 E メールテンプレートの作成

カスタム確認 E メールを作成するには、CreateCustomVerificationEmailTemplate API オペレーションを使用します。このオペレーションでは、次の入力を使用します。

属性 説明
TemplateName テンプレートの名前。指定する名前は一意である必要があります。
FromEmailAddress 確認 E メールが送信された E メールアドレス。指定したアドレスまたはドメインは、Amazon SES アカウントで使用するために検証する必要があります。

注記

FromEmailAddress 属性は表示名 (「差出人」名とも呼ばれます) をサポートしていません。

TemplateSubject 確認 E メールの件名。
TemplateContent E メールの本文。E メール本文には、一定の制限がある HTML を含めることができます。詳細については、「カスタム確認 E メールに関するよくある質問」を参照してください。
SuccessRedirectionURL ユーザーの E メールアドレスが正常に確認された場合に送信される URL。
FailureRedirectionURL ユーザーの E メールアドレスが正常に確認されなかった場合に送信される URL。

AWS SDK または AWS CLI を使用して、CreateCustomVerificationEmailTemplate オペレーションでカスタム検証 E メールテンプレートを作成できます。AWS SDK の詳細については、「Amazon Web Services のツール」を参照してください。AWS CLI の詳細については、「AWS コマンドラインインターフェイス」を参照してください。

次のセクションでは、AWS CLI を使用してカスタム確認 E メールを作成する手順について説明します。これらの手順は、AWS CLI がインストールされ、設定されていることを前提としています。AWS CLI のインストールおよび設定の詳細については、「AWS Command Line Interface ユーザーガイド」を参照してください。

注記

To complete the procedure in this section, you must use version 1.14.6 or later of the AWS CLI. For best results, upgrade to the latest version of the AWS CLI. For more information about updating the AWS CLI, see Installing the AWS Command Line Interface in the AWS Command Line Interface ユーザーガイド.

  1. テキストエディタで新規ファイルを作成します。エディタに、以下の内容を貼り付けます。

    { "TemplateName": "SampleTemplate", "FromEmailAddress": "sender@example.com", "TemplateSubject": "Please confirm your email address", "TemplateContent": "<html> <head></head> <body style="font-family:sans-serif;"> <h1 style="text-align:center">Ready to start sending email with ProductName?</h1> <p>We here at Example Corp are happy to have you on board! There's just one last step to complete before you can start sending email. Just click the following link to verify your email address. Once we confirm that you're really you, we'll give you some additional information to help you get started with ProductName.</p> </body> </html>", "SuccessRedirectionURL": "https://www.example.com/verifysuccess", "FailureRedirectionURL": "https://www.example.com/verifyfailure" }

    重要

    上記の例を読みやすくするために、TemplateContent 属性に改行が含まれています。前述の例をテキストファイルに貼り付ける場合は、続行する前に改行を削除してください。

    TemplateNameFromEmailAddressTemplateSubjectTemplateContentSuccessRedirectionURL、および FailureRedirectionURL の値を独自の値に置き換えます。customverificationemail.json という名前でファイルを保存します。

  2. コマンドラインで次のコマンドを入力して、カスタム検証 E メールテンプレートを作成します。aws ses create-custom-verification-email-template --cli-input-json file://customverificationemail.json

  3. 必要に応じて、次のコマンドを入力して、テンプレートが作成されたことを確認できます。aws ses list-custom-verification-email-templates

カスタム確認 E メールテンプレートの編集

UpdateCustomVerificationEmailTemplate オペレーションを使用してカスタム確認 E メールテンプレートを編集できます。このオペレーションでは、CreateCustomVerificationEmailTemplate オペレーション (つまり TemplateNameFromEmailAddressTemplateSubjectTemplateContentSuccessRedirectionURL、および FailureRedirectionURL 属性) と同じ入力を受け入れます。ただし、UpdateCustomVerificationEmailTemplate オペレーションでは、これらの属性は必要ではありません。既存のカスタム確認 E メールテンプレートの名前と同じ TemplateName 値を渡すと、指定した属性がテンプレートに元々含まれていた属性を上書きします。

カスタムテンプレートを使用した確認 E メールの送信

少なくとも 1 つのカスタム確認 E メールテンプレートを作成したら、SendCustomVerificationEmail API オペレーションを呼び出して顧客に送信することができます。AWS SDK または AWS CLI のいずれかを使用して、SendCustomVerificationEmail オペレーションを呼び出すことができます。SendCustomVerificationEmail オペレーションでは、次の入力を使用します。

属性 説明
EmailAddress 確認されている E メールアドレス。
TemplateName 確認されている E メールアドレスに送信されるカスタム確認 E メールテンプレートの名前。
ConfigurationSetName (オプション) 確認 E メールを送信するときに使用する設定セットの名前。

たとえば、顧客がアプリケーションのフォームを使用してサービスに登録するとします。顧客がフォームを完成させて送信すると、アプリケーションは SendCustomVerificationEmail オペレーションを呼び出し、顧客の E メールアドレスと使用するテンプレートの名前を渡します。

顧客は、作成したカスタマイズされた E メールテンプレートを使用する E メールを受信します。Amazon SES は、受信者へのユニークなリンクと簡単な免責事項を自動的に追加します。次の図は、カスタム確認 E メールテンプレートの作成 で作成されたテンプレートを使用する確認 E メールのサンプルを示しています。

カスタム確認 E メールに関するよくある質問

このセクションでは、カスタム確認 E メールテンプレート機能に関するよくある質問に対する回答を示します。

Q1.作成できるカスタム確認 E メールテンプレートの数はいくつですか?

Amazon SES アカウントごとに最大 50 のカスタム確認 E メールテンプレートを作成できます。

Q2.カスタム確認 E メールはどのように受信者に表示されますか?

カスタム確認 E メールには、テンプレートを作成したときに指定したコンテンツと、メールアドレスを確認するために受信者がクリックする必要があるリンクが含まれます。

Q3.カスタム確認 E メールをプレビューすることはできますか?

カスタム確認 E メールをプレビューするには、SendCustomVerificationEmail オペレーションを使用して確認 E メールを所有しているアドレスに送信します。確認リンクをクリックしない場合は、Amazon SES は新しい ID を作成しません。確認リンクをクリックすると、DeleteIdentity オペレーションを使用して、新しく作成された ID を削除することもできます。

Q4.カスタム確認 E メールテンプレートに画像を含めることはできますか?

Base64 エンコーディングを使用して、テンプレートの HTML に画像を埋め込むことができます。この方法で画像を埋め込むと、Amazon SES は画像を添付ファイルに自動的に変換します。次のコマンドのいずれかを発行して、画像をコマンドラインでエンコードすることができます。

  • Linux, macOS, or Unix: base64 -i imagefile.png | tr -d '\n' > output.txt

  • Windows: certutil -encode imagefile.png output.tmp && findstr /v /c:- output.tmp > output.txt && del output.tmp

imagefile.png を、エンコードするファイルの名前に置き換えます。上記の両方のコマンドで、Base64 でエンコードされた画像は output.txt に保存されます。

注記

Windows のコマンドラインを使用して画像をエンコードした場合は、output.txt をテキストエディタで開き、ファイルから改行を削除して続行する必要があります。

テンプレートの HTML に以下を含めることで、Base64 でエンコードされた画像を埋め込むことができます。<img src="data:image/png;base64,base64EncodedImage"/>

上記の例では、png をエンコードされた画像のファイルタイプ (jpg や gif など) に置き換え、base64EncodedImage を Base64 でエンコードされた画像 (つまり、前述のコマンドの output.txt の内容) に置き換えます。

Q5.カスタム検証 E メールテンプレートに含めることのできるコンテンツに制限はありますか?

カスタム確認 E メールテンプレートのサイズは 10 MB を超えることはできません。また、HTML を含むカスタム検証 E メールテンプレートでは、以下の表に示しているタグと属性しか使用できません。

HTML タグ 許可された属性
abbr class, id, style, title
acronym class, id, style, title
address class, id, style, title
area class, id, style, title
b class, id, style, title
bdo class, id, style, title
big class, id, style, title
blockquote cite, class, id, style, title
body class, id, style, title
br class, id, style, title
button class, id, style, title
caption class, id, style, title
center class, id, style, title
cite class, id, style, title
code class, id, style, title
col class, id, span, style, title, width
colgroup class, id, span, style, title, width
dd class, id, style, title
del class, id, style, title
dfn class, id, style, title
dir class, id, style, title
div class, id, style, title
dl class, id, style, title
dt class, id, style, title
em class, id, style, title
fieldset class, id, style, title
font class, id, style, title
form class, id, style, title
h1 class, id, style, title
h2 class, id, style, title
h3 class, id, style, title
h4 class, id, style, title
h5 class, id, style, title
h6 class, id, style, title
head class, id, style, title
hr class, id, style, title
html class, id, style, title
i class, id, style, title
img align, alt, class, height, id, src, style, title, width
input class, id, style, title
ins class, id, style, title
kbd class, id, style, title
label class, id, style, title
legend class, id, style, title
li class, id, style, title
map class, id, style, title
menu class, id, style, title
ol class, id, start, style, title, type
optgroup class, id, style, title
option class, id, style, title
p class, id, style, title
pre class, id, style, title
q cite, class, id, style, title
s class, id, style, title
samp class, id, style, title
select class, id, style, title
small class, id, style, title
span class, id, style, title
strike class, id, style, title
strong class, id, style, title
sub class, id, style, title
sup class, id, style, title
table class, id, style, summary, title, width
tbody class, id, style, title
td abbr, axis, class, colspan, id, rowspan, style, title, width
textarea class, id, style, title
tfoot class, id, style, title
th abbr, axis, class, colspan, id, rowspan, scope, style, title, width
thead class, id, style, title
tr class, id, style, title
tt class, id, style, title
u class, id, style, title
ul class, id, style, title, type
var class, id, style, title

Q6.確認済み E メールアドレスをアカウントにいくつ持つことができますか?

Amazon SES アカウントには、AWS リージョンごとに 10,000 個までの確認済み ID を含めることができます。Amazon SES で、ID には検証済みドメインと E メールアドレスの両方が含まれます。独自の E メール送信に使用している確認済みドメインまたは E メールアドレスがある場合、それらの ID は 10,000 個の ID の制限に含まれます。

Q7.Amazon SES コンソールを使用してカスタム確認 E メールテンプレートを作成できますか?

現在のところ、Amazon SES API を使用してカスタム確認 E メールを作成、編集、削除できます。

Q8.顧客がカスタム確認 E メールを受け取ったときに発生するオープンイベントとクリックイベントを追跡できますか?

カスタム確認 E メールには、オープンまたはクリックの追跡を含めることはできません。

Q9.カスタム確認 E メールにカスタムヘッダーを含めることはできますか?

カスタム確認 E メールにカスタムヘッダーを含めることはできません。

Q10.カスタム確認 E メールの下部に表示されるテキストを削除できますか?

次のテキストは、すべてのカスタム確認 E メールの末尾に自動的に追加され、削除することはできません。

この E メールアドレスの確認をリクエストしていない場合は、このメッセージを無視してください。不明な点がございましたら、ご質問やご意見とともに、このメールを次の E メールアドレスに転送してください。

このテキストの E メールアドレスリンクは、Amazon SES チームが積極的に監視する受信箱、ses-review@amazon.com を参照しています。

Q11.カスタム確認 E メールは DKIM 署名されていますか?

確認 E メールを DKIM 署名するには、確認メールテンプレートを作成するときに FromEmailAddress 属性で指定した E メールアドレスが DKIM 署名を生成するように設定する必要があります。E メールアドレスの DKIM の設定の詳細については、Amazon SES における DKIM を使った E メールの認証 を参照してください。

Q12.カスタム検証 E メールテンプレートの API オペレーションが SDK または CLI にないのはなぜですか?

SDK または AWS CLI でカスタム検証 E メールテンプレートのオペレーションを使用できない場合は、古いバージョンの SDK または CLI を使用している可能性があります。カスタム検証 E メールテンプレートのオペレーションは以下の SDK および CLI で使用できます。

  • AWS Command Line Interface のバージョン 1.14.6 以降

  • AWS SDK for .NET のバージョン 3.3.205.0 以降

  • AWS SDK for C++ のバージョン 1.3.20170531.19 以降

  • AWS SDK for Go のバージョン 1.12.43 以降

  • AWS SDK for Java のバージョン 1.11.245 以降

  • AWS SDK for JavaScript のバージョン 2.166.0 以降

  • AWS SDK for PHP のバージョン 3.45.2 以降

  • AWS SDK for Python (Boto) のバージョン 1.5.1 以降

  • aws-sdk-ses の AWS SDK for Ruby Gem のバージョン 1.5.0 以降