メール
API 経由の電子メール
動的なコンテンツを含むメール
動的なコンテンツを含むメール
動的コンテンツを含む E メールを送信するには、次の 2 つの方法がサポートされています。
- テンプレート言語 (推奨)
- API リクエストで
templateLanguageVersion=2パラメーターを使用します。 - 置換、ロジック、および式のより強力な構文を許可します。
- API リクエストで
- 従来のハンドルバーヘルパー
- API リクエストで
templateLanguageVersionを設定しないでください。 - 下位互換性のために引き続きサポートされています。
- API リクエストで
完全な API リファレンスについては、 フル機能の電子メール API エンドポイントの送信 (opens in a new tab) を参照してください。
これら 2 つのアプローチの詳細については、以下の「テンプレート言語」セクションと「レガシーハンドルバー」セクションを参照してください。
テンプレート言語 (推奨)
動的コンテンツを含む電子メールを送信するには、HTML コンテンツ内でテンプレート言語を使用し、リクエストの to または default パラメーターでプレースホルダー値を定義します。
使用可能なテンプレート言語構造を追加して、置換、条件文、または反復を電子メール テンプレートで直接処理できます。
詳細は、テンプレート言語 をご参照ください。
レガシーハンドルバーヘルパー
レガシーヘルパーは、おなじみの {{#helper}} ...{{/helper}} 構文を使用します。これらは引き続きサポートされていますが、将来を見据えたプロジェクトのために、新しいテンプレート言語に移行することをお勧めします。
| HTML request | To JSON request | Resolved HTML |
|---|---|---|
| ヘルパーの例: #eq | ||
| {{#eq name "Bob"}} Dear {{name}} {{else}} Hi {{name}} {{/eq}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" } } | Dear Bob |
| ヘルパーの例: #each | ||
| {{#each friends}} Hi {{this}} {{/each}} | { "to": "john.smith@somedomain.com", "placeholders": { "friends":["Bob","John","Jack"] } } | Hi Bob Hi John Hi Jack |
| ヘルパーの例: #unlessEq | ||
| {{#unlessEq name "Bob"}} Dear {{name}} {{else}} Hi {{name}} {{/unlessEq}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" } } | Hi Bob |
| ヘルパーの例: #default | ||
| Hi {{name}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" } } | Hi Bob |
| ヘルパーの例: #gt | ||
| {{#gt age 12}} Welcome {{name}}! {{else}} Hey {{name}}, you are under age {{/gt}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" , "age":10 } } | Hey Bob, you are under age |
| ヘルパーの例: #lt | ||
| {{#lt age 12}} Welcome {{name}}! {{else}} Sorry {{name}}, This is kids arena {{/lt}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" , "age":10 } } | Welcome Bob! |
| ヘルパーの例: #equalsIgnoreCase | ||
| {{#equalsIgnoreCase gender "male"}} Dear Mr {{name}} {{else}} Dear customer {{/equalsIgnoreCase}} | { "to": "john.smith@somedomain.com", "placeholders":{ "name": "Bob" , "gender": "MALE" } } | Dear Mr Bob |
| ヘルパーの例: #gte | ||
| {{#gte age 12}} Welcome {{name}}! {{else}} Hey {{name}}, you are under age {{/gte}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" , "age":10 } } | Hey Bob, you are under age |
| ヘルパーの例: #lte | ||
| {{#lte 12歳}} ようこそ {{name}}! {{else}} 申し訳ありませんが、{{name}}, This is kids arena {{/lte}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" , "age":10 } } | Welcome Bob! |
| ヘルパーの例: #compare | ||
| {{#compare name "!=" "Bob"}}Hi {{name}}{{else}} Dear Bob{{/compare}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Jane" , "age":10 } } | Hi Jane |
| ヘルパーの例: #equals | ||
| {{#equals name "Bob"}} Dear {{name}} {{else}} Hi {{name}} {{/equals}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" } } | Dear Bob |
| ヘルパーの例: #lessThan | ||
| {{#lessThan age 12}} Welcome {{name}}! {{else}} Sorry {{name}}, This is kids arena {{/lessThan}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" , "age":10 } } | Welcome Bob! |
| ヘルパーの例: #lessThanOrEquals | ||
| {{#lessThanOrEquals age 12}} Welcome {{name}}! {{else}} Sorry {{name}}, This is kids arena {{/lte}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" , "age":10 } } | Welcome Bob! |
| ヘルパーの例: #greaterThan | ||
| {{#greaterThan age 12}} Welcome {{name}}! {{else}} Hey {{name}}, you are under age {{/greaterThan }} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" , "age":10 } } | Hey Bob, you are under age |
| ヘルパーの例: #greaterThanOrEquals | ||
| {{#greaterThanOrEquals age 12}} Welcome {{name}}! {{else}} Hey {{name}}, you are under age{{/greaterThanOrEquals }} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" , "age":10 } } | Hey Bob, you are under age |
| ヘルパーの例: #when | ||
| {{#when name "!=" "Bob"}} Hi {{name}}{{else}}Dear Bob{{/when}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Jane" , "age":10 } } | Hey Jane |
| ヘルパーの例: #contains | ||
| {{#contains friends "Bob"}} Hi {{this}} {{/each}} | { "to": "john.smith@somedomain.com", "placeholders": { "friends":["Bob","John","Jack"] } } | Hi Bob |
| ヘルパーの例: #and | ||
| {{#and great magnificent}}Bob{{else}}Jane{{/and}} | { "to": "john.smith@somedomain.com", "プレースホルダー": { "great": true, "magnificent": true } } | Hi Bob |
| ヘルパーの例: #formatNumber | ||
| {{#formatNumber price}} {{/formatNumber}} | { "to": "john.smith@somedomain.com", "プレースホルダー": { "price":10000 } } | 10,000 |
| ヘルパーの例: #isTruthy | ||
| {{#isTruthy Male}}Hi Bob{{else}}Hi Jane{{/isTruthy}} | { "to": "john.smith@somedomain.com", "placeholders": { "男性": true } } | Hi Bob |
| ヘルパーの例: #isFalsey | ||
| {{#isFalsey Male}}Hi Bob{{else}}Hi Jane{{/isFalsey}} | { "to": "john.smith@somedomain.com", "placeholders": { "男性": true } } | Hi Jane |
| ヘルパーの例: #ifEven | ||
| {{#ifEven age}}Hi Bob{{else}}Hi Jane{{/ifEven}} | { "to": "john.smith@somedomain.com", "placeholders": { "age": 20 } } | Hi Bob |
| ヘルパーの例: #ifOdd | ||
| {{#ifOdd age}}Hi Bob{{else}}Hi Jane{{/ifOdd}} | { "to": "john.smith@somedomain.com", "placeholders": { "age": 20 } } | Hi Jane |
| ヘルパーの例: #ifNth | ||
| {{#ifNth age balance}}Hi Bob{{else}}Hi Jane{{/ifNth}} | { "to": "john.smith@somedomain.com", "placeholders": { "age": 20, "balance": 20000 } } | Hi Bob |
| ヘルパーの例: #is | ||
| {{#is name "Bob"}}Dear {{name}}{{else}}Hi {{name}}{{/is}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" , "age":10 } } | Dear Bob |
| ヘルパーの例: #isnt | ||
| {{#isnt name "Bob"}}Dear {{name}}{{else}}Hi {{name}}{{/isnt}} | { "to": "john.smith@somedomain.com", "placeholders": { "name": "Bob" , "age":10 } } | Hi Bob |
| ヘルパーの例: #neither | ||
| {{#neither great magnificent}}A{{else}}B{{/neither}} | { "to": "john.smith@somedomain.com", "プレースホルダー": { great: true, magnificent: false } } | B |
| ヘルパーの例: #not | ||
| {{#not great}}A {{else}} B{{/not}} | { "to": "john.smith@somedomain.com", "プレースホルダー": { great: true, magnificent: false } } | B |
| ヘルパーの例: #or | ||
| {{#or great magnificent}}A{{else}}B{{/or}} | { "to": "john.smith@somedomain.com", "プレースホルダー": { great: true, magnificent: false } } | A |
| ヘルパーの例: #unlessGt | ||
| {{#unlessGt physics chemistry}}Hi {{name}}your score in Physics :{{physics}}{{else}}Hi {{name}}your score in Chemistry : {{chemistry}}{{/unlessGt}} | { "to": "john.smith@somedomain.com", "プレースホルダー": { "name": "ボブ" , "物理学": 70 , "化学": 75 } } | Hi Bob your score in Physics : 70 |
| ヘルパーの例: #unlessLt | ||
| {{#unlessLt physics chemistry}}Hi {{name}}your score in Physics : {{physics}}{{else}}Hi {{name}}your score in Chemistry : {{chemistry}}{{/unlessLt}} | { "to": "john.smith@somedomain.com", "プレースホルダー": { "name": "ボブ" , "物理学": 70 , "化学": 75 } } | Hi Bob your score in Chemistry : 75 |
| ヘルパーの例: #unlessGteq | ||
| {{#unlessGteq physics chemistry}}Hi {{name}}your score in Physics : {{physics}}{{else}}Hi {{name}}your score in Chemistry : {{chemistry}}{{/unlessGteq}} | { "to": "john.smith@somedomain.com", "プレースホルダー": { "name": "ボブ" , "物理学": 70 , "化学": 75 } } | Hi Bob your score in Physics : 70 |
| ヘルパーの例: #unlessLteq | ||
| {{#unlessLteq physics chemistry}}Hi {{name}}your score in Physics : {{physics}}{{else}}Hi {{name}}your score in Chemistry : {{chemistry}}{{/unlessLteq}} | { "to": "john.smith@somedomain.com", "プレースホルダー": { "name": "ボブ" , "物理学": 70 , "化学": 75 } } | Hi Bob your score in Chemistry : 75 |