CLIからAmazon SESでメールを一斉送信する必要があり、そのための手順とメールテンプレートを作成するスクリプトを作りました。
CLIからSESでメールを送信する状況はあまりないとは思いますが、参考になれば嬉しいです。
設定手順
メールテンプレートの準備
TerraformのSESのmodule配下にHTML版のメールとText版のメールのファイルをそれぞれ作成します。
- HTML版のメールを作る際には以下に注意してください。
日本語が含まれる場合は、変換したものを貼り付けること。参考：変換サイト - HTMLでは通常の改行が反映されないため、改行はbrタグに変換してください。
- 変数に改行が含まれている場合は、HTMLメールとtextメールで別々の変数を用意し、変数名の末尾に_htmlを付けて区別します。
TerraformでSESのテンプレートを作成します。
resource "aws_ses_template" "ses_template" {
name = "ses_template_name"
subject = "メールタイトル"
html = file("${path.module}/template/html-mail.html")
text = file("${path.module}/template/text-mail.txt")
}
terraform applyで反映させます。
terraform apply
メールテンプレートが作成されたことを確認します。
aws ses list-templates
メールテンプレートの詳細を確認します。
aws ses get-template --template-name template_name
テンプレート名はマネジメントコンソールからも確認することができますが、コンソールからではテンプレートの内容の確認や使用はできません。
メールの送信先の準備
SESでは、メールの送信先を次のようなJSON形式で指定します。
[
{
"Destination": {
"ToAddresses": [
"recipient1@example.com"
]
},
"ReplacementTemplateData": "{}"
},
{
"Destination": {
"ToAddresses": [
"recipient2@example.com"
]
},
"ReplacementTemplateData": "{}"
}
]
件数が多いと手動で対応するのはしんどいため、CSVファイルをインプットに上記Jsonに変換するPythonスクリプトを作成しました。
Pythonスクリプトの使い方
ses_csv2json.py
import csv
import json
import sys
def convert_csv_to_json(csv_file_path, json_file_path):
results = []
add_html_version = False
# CSVファイルをスキャンして改行コードが含まれているかをチェック
with open(csv_file_path, newline='', encoding='utf-8') as csvfile:
reader = csv.reader(csvfile)
for row in reader:
if any('\n' in field for field in row):
add_html_version = True
break
with open(csv_file_path, newline='', encoding='utf-8') as csvfile:
reader = csv.DictReader(csvfile)
for row in reader:
replacement_template_data = {}
to_addresses = row['ToAddresses'].strip()
for key, value in row.items():
if key != 'ToAddresses': # ToAddressesは別途処理
# JSONに変換するために改行コードをエスケープ
escaped_value = value.replace('\n', '\\n')
replacement_template_data[key] = escaped_value
# _htmlバージョンを追加
if add_html_version:
html_key = f"{key}_html"
html_value = value.replace('\n', '<br>')
replacement_template_data[html_key] = html_value
data = {
"Destination": {
"ToAddresses": [to_addresses]
},
"ReplacementTemplateData": json.dumps(replacement_template_data)
}
results.append(data)
with open(json_file_path, 'w', encoding='utf-8') as jsonfile:
json.dump(results, jsonfile, indent=4, ensure_ascii=False)
if __name__ == '__main__':
if len(sys.argv) != 3:
print("Usage: python ses_csv2json.py <input_csv_file> <output_json_file>")
sys.exit(1)
csv_path = sys.argv[1]
json_path = sys.argv[2]
convert_csv_to_json(csv_path, json_path)
スプレッドシートなどを使用してCSVファイルを作成し、必要なカラム（ToAddressesは必須、他はテンプレートの変数に合わせる）を設定します。
末尾が_htmlの変数はスクリプトの処理で自動で作成されるためカラムの作成は不要です。
コマンドラインから以下の形式で実行してCSVファイルからJSONファイルを作成します。
python ses_csv2json.py input.csv output.json
メール一斉送信
AWS CloudShellやローカルからCLIコマンドで実行してメールを送信します。
aws ses send-bulk-templated-email \
--source "from@example.com" \
--template "your_template_name" \
--default-template-data "{}" \
--destinations file://path_to_your_json_file.json
- source：送信者のメールアドレス（SESで検証済みである必要があります）
- template：使用するメールテンプレートの名前で
- destinations：上記で準備したJSONファイルへのパス
(Windowsの場合でもディレクトリは/で区切る) - default-template-data：メール内の変数のデフォルト値
簡単30秒