エンドポイント
Email Template API(V2)は、次のエンドポイントで構成されています。- Create Email Template API: メールテンプレートを作成します。
- Update Email Template API: Template ID で指定したメールテンプレートを更新します。
- Search Email Template API: Template ID、またはテンプレート名やテンプレートバージョンなどのその他のフィルターを使用してメールテンプレートを取得します。また、Create Email Template API を使用して MoEngage で作成されたすべてのメールテンプレートを一覧表示することもできます。
IP ホワイトリスト
よくある質問
Create Email Template API を使用して作成したテンプレートに MoEngage ダッシュボードでアクセスするにはどうすればよいですか?
Create Email Template API を使用して作成したテンプレートに MoEngage ダッシュボードでアクセスするにはどうすればよいですか?
Create Email Template API を使用して作成したテンプレートには、以下の画像のように、MoEngage ダッシュボードでのキャンペーン作成の 2 番目のステップにある Imported API Templates タブからアクセスできます。

Create Email Template API を使用して、同じ名前のテンプレートを複数作成できますか?
Create Email Template API を使用して、同じ名前のテンプレートを複数作成できますか?
はい、バージョンが異なれば、同じ名前のテンプレートを複数作成できます。
API を使用してメールテンプレートとともに保存できるコネクターの詳細は何ですか?
API を使用してメールテンプレートとともに保存できるコネクターの詳細は何ですか?
カスタムメールテンプレートとともに、4 つのコネクターの詳細を保存できます。コネクタータイプ(
connector.connector_type。例: SENDGRID や AMAZON_SES)、コネクター名(connector.connector_name)、送信元メールアドレス(from_address)、返信先メールアドレス(reply_to_address)です。これらは、subject、email_content、sender_name、preview_text、attachments などの他のテンプレートフィールドとともに basic_details で渡します。これらのフィールドは、Create Email Template API と Update Email Template API の両方でサポートされています。コネクターのフィールドは必須ですか?
コネクターのフィールドは必須ですか?
いいえ。4 つのコネクターフィールドはすべて任意であり、
subject、email_content、sender_name などの basic_details の必須フィールドは変わりません。ただし、コネクターフィールドはセットとして機能します。いずれか 1 つを渡す場合は、4 つすべてを渡す必要があります。コネクターフィールドの一部のみを含むリクエストは失敗します。MoEngage はコネクターの詳細に対してどのような検証を行いますか?
MoEngage はコネクターの詳細に対してどのような検証を行いますか?
コネクターの詳細を渡すと、MoEngage は次の点を確認します。
- コネクタータイプとコネクター名が、ワークスペースに存在するコネクターと一致していること。
- 送信元メールアドレスがそのコネクターにマッピングされていること。
- 送信元メールアドレスが検証済みであること。
送信元メールアドレスをパーソナライズした場合も検証されますか?
送信元メールアドレスをパーソナライズした場合も検証されますか?
いいえ。送信元メールアドレスのパーソナライズが有効になっている場合、MoEngage は送信元メールアドレスのマッピングと検証のチェックをスキップします。
保存したコネクターの詳細をテンプレートから削除できますか?
保存したコネクターの詳細をテンプレートから削除できますか?
いいえ。コネクターの詳細をテンプレートとともに保存した後は、Update Email Template API を使用して更新できますが、削除することはできません。同じコンテンツをコネクターの詳細なしで使用するには、新しいテンプレートを作成してください。
この機能の導入前に作成したテンプレートにコネクターの詳細を追加できますか?
この機能の導入前に作成したテンプレートにコネクターの詳細を追加できますか?
はい。以前に作成されたテンプレートにはコネクターの詳細がありません。Update Email Template API を使用して追加できます。
テンプレートのコネクターの詳細を更新し、関連するキャンペーンの更新も要求した場合はどうなりますか?
テンプレートのコネクターの詳細を更新し、関連するキャンペーンの更新も要求した場合はどうなりますか?
update_campaigns を true として渡し、テンプレートのバージョン間でコネクターの詳細が異なる場合、テンプレートは新しいバージョンとして保存されますが、関連するキャンペーンは更新されません。キャンペーンは現在のバージョンのままとなり、現在のコネクターの詳細が維持されます。レスポンスでは campaigns_updated が false として返され、その理由を説明する message が含まれます。その他のテンプレートの更新は、関連するキャンペーンに引き続き適用されますか?
その他のテンプレートの更新は、関連するキャンペーンに引き続き適用されますか?
はい。
email_content、subject、sender_name など、コネクターの詳細以外のフィールドを更新し、update_campaigns を true として渡した場合、変更はそれらのキャンペーンに適用されます。コネクターでテンプレートを検索できますか?
コネクターでテンプレートを検索できますか?
はい。Search Email Template API は、コネクタータイプ(
connector_type)、コネクター名(connector_name)、送信元メールアドレス(from_address)によるフィルタリングをサポートしています。たとえば、SendGrid を使用するすべてのテンプレートや、特定の SendGrid コネクターを使用するテンプレートのみを検索できます。コネクターの詳細がないテンプレートも返すには、include_templates_without_connector を true に設定します。これらのフィルターは、template_name や team_names などの既存のフィルターと組み合わせることができます。テンプレートとともにコネクターの詳細を保存する機能は、すべてのワークスペースで利用できますか?
テンプレートとともにコネクターの詳細を保存する機能は、すべてのワークスペースで利用できますか?
テンプレートとともにコネクターの詳細を保存する機能は、段階的に展開されています。ワークスペースでコネクターフィールドを利用できない場合は、MoEngage カスタマーサクセスマネージャー(CSM)またはサポートチームにお問い合わせください。