テンプレートと変数

目的

送信方式に応じて下記2つのテンプレートを使い分けます。

実装時の注意点

名称が紛らわしいですが、API送信で指定可能なのは「ブロードキャストテンプレートID」のみです。
コンテンツメールテンプレートIDを指定するとエラーになる仕様のため、作成場所を間違えないようご注意ください。

API送信では placeholders パラメータでプレースホルダーを指定します。

{
  "placeholders": "{\"name\": \"田中太郎\", \"address\": \"東京都○○\"}"
}

テンプレート側では、次のように呼び出します。

{$name}
{$address}

placeholders は string 型

JSONオブジェクトそのものではなく、エスケープ済み文字列として渡す点に注意してください。

ブロードキャスト作成画面から受信者リストをファイルアップロードします。

アップロードするファイルは、メールアドレスと、プレースホルダー化したい属性（氏名・住所など）を列として作成します。

例：

メールアドレス	氏名	住所
tanaka@gmail.com	田中太郎	東京都○○
sato@yahoo.co.jp	佐藤花子	千葉県△△

テンプレート側では、ファイルの左から順に次のように呼び出します。

API送信では、用途ごとにキー名を安定化させると保守しやすくなります。

例:

方式	向いているケース
GUIビルダー	シンプル、非エンジニア運用
HTMLアップロード	デザイン制御、細かな出し分け